= Integracja z systemami ERP i FK  = #integracja

=== Menu === 
 1. [#wprowadzenie Wprowadzenie]
 2. [#opis Opis konfiguracji][[BR]]
  2.1 [#xml_transfer Wymiana poprzez XML][[BR]]
  2.2 [#db_transfer Wymiana poprzez połączenie z bazą danych][[BR]]
 3. [#przyklady Integracja z systemami zewnętrznymi]

== Wprowadzenie == #wprowadzenie

Integracja z systemami zewnętrznymi wykorzystuje mechanizm '''bs_connect''', który potrafi pobierać dane z wielu źródeł, jak bazy danych lub pliki XML.
Dzięki temu możliwe jest podpięcie do dowolnego systemu, na którego bazie danych można zdefiniować widoki, z których dane zostaną pobrane (albo bezpośrednio, ale poprzez wygenerowane pliki XML).

''[#integracja Powrót do menu]''

== Opis konfiguracji == #przyklady

Poniższy opis zawiera uniwersalne informacje niezależne od systemu. Zakłada użycie najczęściej stosowanej formy integracji. W dalszej części artykułu znajdują się odnośniki . Może zdarzyć się, że w konkretnym przypadku, konfiguracja integracji będzie różnić się od podanego przykładu.

Uwaga!!! Niniejszy opis będzie działał w eDokumentach od wersji 3.8.139.

Każda konfiguracja integracji rozpoczyna się od zdefiniowania w pliku config.inc stałej SYNC_ACTIVE na TRUE albo na 'NEW' w zależności od wspieranej formy (szczegóły w dokumentacji dla poszczególnych połączeń).

{{{
#!php
define('SYNC_ACTIVE', 'NEW'); // Najczęściej stosowana forma.
//define('SYNC_ACTIVE',TRUE); // Może być zdefiniowana tylko jedna forma integracji
}}}

Po zdefiniowaniu formy integracji należy zalogować się do eDokumentów z prawami administratora.
W menu ''Narzędzia'' Pojawia się opcja pt. ''Integracja z systemami zewnętrznymi''.

[[BR]][[Image(001.png)]][[BR]]''Przycisk uruchamiania konfiguratora integracji''[[BR]]

Po kliknięciu w ww. przycisk uruchamia się okno, w którym zostaną wykonane czynności integracyjne.

[[BR]][[Image(002.png)]][[BR]]''Okno konfiguratora integracji''[[BR]]

Pierwszym krokiem każdej integracji jest określenie zewnętrznego źródła danych. W tym celu należy kliknąć w przycisk ''Definicji źródeł wymiany danych'' (ikonka z dwiema strzałkami).

[[BR]][[Image(003.png)]][[BR]]''Uruchamianie definiowania źródeł wymiany danych''[[BR]]

Po klinięciu w przycisk pojawi się okno, w którym zostanie zdefiniowane źródło wymiany danych.

[[BR]][[Image(004.png)]][[BR]]''Okno źródła wymiany danych''[[BR]]

Kolejnym krokiem jest dodanie nowego źródła wymiany danych. W tym celu należy kliknąć przycisk ''Nowy''. Zostanie uruchomione nowe okienko, w którym nalezy ustawić parametry wymiany danych.

[[BR]][[Image(007.png)]][[BR]]''Okno konfiguracji wymiany danych''[[BR]]

Poniżej pokazano przykładowe okna konfiguracyjne źródeł wymiany danych:

[[BR]][[Image(005.png)]][[BR]]''Wymiana danych poprzez bezpośrednie podłączenie do bazy danych''[[BR]]

[[BR]][[Image(006.png)]][[BR]]''Wymiana danych poprzez import/eksport plików XML''[[BR]]

=== Wymiana poprzez XML === #xml_transfer
Wymiana poprzez XML wymaga:
 * wybrania na typu ''XML - Wymiana pliku poprzez pliki XML''. Po wybraniu tej opcji pojawiają się dodatkowe pola, w których najważniejsze jest:
 * Ścieżka składu, gdzie wskazujemy ścieżkę dostępu do katalogu, w którym znajdować się będą importowane/eksportowane pliki. Należy pamiętać o nadaniu uprawnień do tego katalogu dla użytkownika '''www-data'''. Dodatkowo w tym katalogu powinien znaleźć się podkatalog '''sent''', który przechowywać będzie przetworzone pliki XML
 * Pole ''Szablon XML'' określa nazwę szablonu do eksportu dokumentów. Fizycznie znajdować się powinien w katalogu {{{public_html/apps/edokumenty/var/tpl/bs_connect}}}.

Niniejszy rysunek przedstawia przykładową konfigurację połączenia (w tym przypadku będzie to import dokumentów):
[[BR]][[Image(008.png)]][[BR]]''Ustawienia źródła wymiany danych''[[BR]]

Po wprowadzeniu niezbędnych danych i zatwierdzeniu formularza - źródło wymiany danych powinno pojawić się w formatce źródeł wymiany danych:

[[BR]][[Image(009.png)]][[BR]]''Ustawione źródła wymiany danych''[[BR]]

W tym momencie należy zamknąć okno i powrócić do okna Połączeń z systemami zewnętrznymi. W oknie tym należy kliknąć nowe połączenie. Otworzy się formatka, w której takie połączenie zostanie skonfigurowane.
W okienku tym należy wprowadzić nazwę połączenia, wybrać identyfikator systemu zewnętrznego, 

[[BR]][[Image(010.png)]][[BR]]''Konfiguracja połączenia z systemem zewnętrznym''[[BR]]

źródło wymiany danych. Pozostałe ustawienia są opcjonalne.

[[BR]][[Image(011.png)]][[BR]]''Konfiguracja połączenia z systemem zewnętrznym''[[BR]]

W tym momencie należy kliknąć przycisk ''Zapisz''. Wyświetli się komunikat o przejściu na zakładkę '''Synchronizacja''' oraz o dodaniu mapowania kolumn. Odnośnie mapowania kolumn. Ten temat zostanie opisany poniżej, najpierw należy skupić się nad prawidłową konfiguracją połączenia z systemem zewnętrznym po stronie eDokumentów.

''[#integracja Powrót do menu]''

=== Wymiana poprzez połączenie z bazą danych === #db_transfer

''[#integracja Powrót do menu]''

== Przykładowe integracje == #przyklady

=== Aktualne ===

 * [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ą] 



=== Integracja w starszych wersjach systemu ===
 * [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]''