= Integracja z Forte =

=== Menu === #menu
 1. [#data_source Konfiguracja źródła danych]
 2. [#views_install Instalacja widoków w FORTE]
 3. [#bs_connect_data_sources Tworzenie połączenia z systemami zewnętrznymi]
 4. [#syncassist SyncAssist - eksport danych z eDokumentów do systemu Forte]

== Konfiguracja źródła danych == #data_source

Pierwszym krokiem integracji jest zdefiniowanie odpowiedniego źródła danych do baqzy danych systemu FORTE HANDEL. Do tego celu przechodzimy do ''Ustawień > Panel Sterowania > Pozostałe ustawienia > Źródła danych''.
W otwartym oknie wybieramy Nowe, a następnie definiujemy parametry połączenia.
 * Identyfikator źródła danych - wprowadzamy nazwę połączenia, przykładowo FORTE_HANDEL.
 * Sterownik - wybieramy sterownik połączenia, np. MsSQL lub ODBC.
 * Ciąg połączenia - ciąg połączenia do bazy danych. Dla MsSQL może to być np.
{{{
Server=<adres serwera bazy danych np. 192.168.0.1>;Database=<nazwa bazy danych>;Uid=<uużytkownik>;Pwd=<hasło>;
}}}

[[BR]][[Image(img001.png)]][[BR]]''(Rys.1 Ciąg połączenia z systemem Forte)''[[BR]]

Na tym kończy się pierwszy etap integracji.

== Instalacja widoków w FORTE == #views_install

Idąc dalej musimy przygotować na bazie danych systemu FORTE HANDEL. W tym celu mając uprawnienia w systemie Ms SQL Server do tworzenia obiektów na bazie danych wykonujemy skrypt z lokalizacji:{{{public_html/apps/edokumenty/modules/Settings/BSConnectSettings/install/sql/externals/symfonia_forte_handel/01_install_relations_crt.sql}}}:

== Tworzenie połączenia z systemami zewnętrznymi == #bs_connect_data_sources

Kolejnym krokiem w tym procesie jest modyfikacja pliku ''config.inc''. Należy dodać lub zmodyfikować wpis w tym pliku:
{{{
define('SYNC_ACTIVE','NEW');
}}}

Po ponownym zalogowaniu w systemie pojawia się przycisk w menu ''Narzędzia > Połączenia z systemami zewnętrznymi''. Widok przycisku przedstawia poniższy rysunek:

[[BR]][[Image(img002.png)]][[BR]]''(Rys.2 Połączenia z systemami zewnętrznymi)''[[BR]]

Domyślnie żadne połączenie nie jest zdefiniowane. Połączenie tworzymy klikając polecenie ''Nowy''. 

[[BR]][[Image(forte001.jpg)]][[BR]]''(Rys.3 Okno definiowania połączenia z systemem Forte)''[[BR]]

W nowo otwartym oknie należy wypełnić pola:
 * Nazwę połączenia z systemem zewnętrznym - nazwa musi być unikalna,
 * Wybrać identyfikator systemu SYMFONIA_FORTE
 * Wskazać źródło wymiany. Jeżeli nie istnieje to można utworzyć.

[[BR]][[Image(forte002.jpg)]][[BR]]''(Rys.4 Okno definiowania źródła wymiany danych)''[[BR]]

W źródle wymiany wprowadzamy:
 * unikalną nazwę, 
 * wybieramy typ z listy rozwijanej (opis poniżej), 
 * źródło danych (dla typu DB), 
 * nazwa schematu w bazie Forte (najczęściej będzie to edokumenty - również dla połączeń typu DB)
 * ścieżkę składu (dla typów XML i CUSTOM_XML)
 * klasę (dla typu CUSTOM_XML)

Źródło wymiany danych może być następujących typów:
 * DB - Wymiana poprzez bazę danych. Wymaga istnienia dedykowanych widoków lub odpowiednich zapytań SQL
 * XML - wymiana danych poprzez pliki XML. Podaje się ścieżkę do katalogu będącego składem plików
 * CUSTOM_XML - jw. z tą różnicą, że wymagana jest dedykowana klasa PHP do obsługi takiego transferu.


7. Skopiowanie plików map
cp APP_DATA/var/tpl/sync/symfonia_forte_handel.ini APP_DATA/etc/sync/

8. Zmienić nazwę skopiowanego pliku w katalogu sync na <IDENTYFIKATOR_Z_BS_CONNECT_SYSTEMS>_columns_map.ini np. 1_columns_map.ini

9. Przydziel prawo dla admina - do Usługi > Systemy zewnętrzne

== SyncAssist - eksport danych z eDokumentów do systemu Forte == #syncassist