Version 44 (modified by jachtelik, 11 years ago)

--

Integracja z systemami zewnętrznymi (ERP, FK, CRM, i innymi)

[DRAFT - obecnie przygotowywana jest aktualna wersja opisu ]

  1. Wprowadzenie
  2. Konfiguracja podstawowa
  3. Import danych z systemów zewnętrznych
  4. Eksport danych do systemów zewnętrznych
  5. Konfiguracja dodatkowa
    5.1 Zaplanowane zadania
    5.2 Historia połączeń
    5.3 Dzienniki zdarzeń
    6 Przykładowe integracje w starszych wersjach systemu eDokumenty

Wprowadzenie

Niniejszy artykuł przedstawia opis kroków niezbędnych do realizacji integracji z systemami zewnętrznymi. Przez system zewnętrzny należy rozumieć każdy inny system informatyczny (ERP, FK, HM, CRM), z którego pragniemy pobrać dane lub któremu chcemy dane udostępnić. Obecnie według tego mechanizmu istnieje możliwość integracji z m.in.

  • Sage Symfonia Premium (Ms SQL Server)
  • Sage Forte HM i FK (Ms SQL Server)
  • CDN Optima (Ms SQL Server)
  • CDN XL (Ms SQL Server)
  • Egeria (Oracle)
  • inne ...

W niniejszym artykule wykorzystamy dla celów przykładowych jako system zewnętrzny bazę prezentacyjną Microsoft AdwenturesWorks 2008R2 oraz dodatkową bazę danych eDok, która będzie naszą bazą pośrednią w procesie integracji. Baza pośrednia ma tę zaletę, gdyż uwalnia administratora bazy systemu informatycznego od tworzenia specjalnych schematów oraz nadawania uprawnień użytkownikowi do obiektów w tym schemacie. Stanowi ona pewien element izolacji przed ingerencją osób trzecich w bazę systemu informatycznego.

Aby móc wykorzystać funkcjonalności mechanizmu BSConnect wymaga się, aby minimalna wersja systemu eDokumenty to 3.8.159. Jednocześnie zastrzega się, iż niektóre funkcjonalności mechanizmu pojawiły się w wersji 4.0.x

Integracja z systemami zewnętrznymi wykorzystuje mechanizm BSConnect, który potrafi pobierać dane z wielu źródeł, jak bazy danych lub pliki XML, jak i również uczestniczyć w generowaniu plików eksportu / eksporcie danych do systemów zewnętrznych. Dzięki temu możliwe jest połączenie z dowolnym systemem, na którego bazie danych można zdefiniować widoki, z których dane zostaną pobrane (albo bezpośrednio, ale poprzez wygenerowane pliki XML).

Powrót do menu

Konfiguracja podstawowa

W niniejszej sekcji opisano czynności podstawowe związane z konfiguracją połączenia z bazą pośrednią systemu zewnętrznego. Aby rozpocząć prace integracyjne należy włączyć moduł BSConnect. Moduł ten włącza się modyfikując plik config.inc w katalogu: [katalog instalacji]/public_html/apps/edokumenty/config.inc . W pliku tym należy wprowadzić następujace wyrażenie: 

define('SYNC_ACTIVE', 'NEW');

[TODO]

  • Konfiguracja źródeł danych
  • Konfiguracja źródeł wymiany danych

Powrót do menu

Import danych z systemów zewnętrznych

W niniejszej sekcji zostanie opisany import danych z systemów zewnętrznych. Integracja ta może być realizowana na dwa sposoby:

  • Poprzez połączenie baza pośrednia / systemu informatycznego - baza systemu eDokumenty
  • Import plików XML.

Szczegółowy opis konfiguracji importu znajduje się na stronie Importu danych z systemów zewnętrznych

Powrót do menu

Eksport danych z systemu eDokumenty do systemów zewnętrznych

W niniejszej sekcji zostanie opisany eksport danych z systemu eDokumenty do systemów zewnętrznych. Podobnie jak import, eksport danych realizowany może być również na dwa sposoby:

  • Zapis w bazie pośredniej / systemu informatycznego
  • Generowanie plików XML lub w innym formacie

Szczegółowy opis konfiguracji eksportu znajduje się na stronie Eksport danych do systemów zewnętrznych

Powrót do menu

Konfiguracja dodatkowa

[TODO]

Przykładowe integracje w starszych wersjach systemu

Poniższe przykłady realizowane były w starszych wersjach systemu eDokumenty. Pokazane przykłady nie są już obecnie wspierane. Zaleca się aktualizację do najnowszej wersji systemu (z uwzględnieniem posiadanej licencji)

Powrót do menu

Załączniki