= Integracja z systemami zewnętrznymi (ERP, FK, CRM, i innymi) = #integracja [DRAFT - obecnie przygotowywana jest aktualna wersja opisu ] === Menu === 1. [#wprowadzenie Wprowadzenie][[BR]] 2. [#opis Konfiguracja podstawowa][[BR]] 3. [#import Import danych z systemów zewnętrznych][[BR]] 4. [#eksport Eksport danych do systemów zewnętrznych] [[BR]] 5. [#dodatkowe Konfiguracja dodatkowa][[BR]] 5.1 [#crontab Zaplanowane zadania][[BR]] 5.2 [#history Historia połączeń][[BR]] 5.3 [#log Dzienniki zdarzeń][[BR]] 6 [#przyklady Przykładowe integracje w starszych wersjach systemu eDokumenty] == Wprowadzenie == #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 bazy prezentacyjne systemów '''Comarch CDN XL''' oraz '''Sage Forte''' 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). [[Image(002.jpg)]][[BR]]''Rys. 1. Bazy danych wykorzystane w niniejszym tutorialu'' ''[#integracja Powrót do menu]'' == Konfiguracja podstawowa == #opis W niniejszej sekcji opisano czynności podstawowe związane z konfiguracją połączenia z bazą pośrednią systemu zewnętrznego. Szczegółowy opis konfiguracji znajduje się na stronie [wiki:DeployerGuide/Customization/Integration/BasicConfiguration Podstawowej konfiguracji systemu eDokumenty (uruchomienie modułu BSConnect)][[BR]] ''[#integracja Powrót do menu]'' == Import danych z systemów zewnętrznych == #import 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 [wiki:DeployerGuide/Customization/Integration/Import Importu danych z systemów zewnętrznych] ''[#integracja Powrót do menu]'' == Eksport danych z systemu eDokumenty do systemów zewnętrznych == #import 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 [wiki:DeployerGuide/Customization/Integration/Eksport Eksport danych do systemów zewnętrznych] ''[#integracja Powrót do menu]'' == Konfiguracja dodatkowa == #dodatkowe [TODO] == Przykładowe integracje w starszych wersjach systemu == #przyklady 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) * [wiki:DeployerGuide/Customization/Forte Integracja z systemem Forte Handel] * [wiki:DeployerGuide/Customization/ForteFK Integracja z systemem Forte FK] * [wiki:DeployerGuide/Customization/Integration/ENOVAMySQL Integracja z systemem ENOVA (MySQL)] * [wiki:DeployerGuide/Customization/Integration/ENOVAMSSQL Integracja z systemem ENOVA (MSSQL)] * [wiki:DeployerGuide/Customization/Integration/WaproWfMag Integracja z systemem WAPRO WF-Mag] * [wiki:DeployerGuide/Customization/ExternalConfigurationFK/Optima Integracja z Optimą] * [wiki:DeployerGuide/Customization/ExternalsConfigurationFK Definiowanie połączenia z systemami FK] * [wiki:DeployerGuide/Customization/ExternalsConfigurationCDNXL Integracja z systemem CDN XL] * [wiki:DeployerGuide/Customization/SymfoniaFK Integracja z systemem Symfonia Finanse i Księgowość] * [wiki:DeployerGuide/Customization/SymfoniaHandel Integracja z systemem Symfonia Handel] ''[#integracja Powrót do menu]''