= [wiki:DeployerGuide Przewodnik wdrożeniowca] > Integracja z systemem Symfonia Handel =

Połączenie w systemem Symfonia Handel wymaga następujących kroków:

Wykonanie polecenie createDDfs({NAZWA_FIRMY}) w celu wygenerowania specjalnych plików umożliwiających połączenie się z bazą Pervasive poprzez sterownik ODBC.

Po wykonaniu tego polecenia w systemowych źródłach danych 
{{{
Panel sterowania -> Narzędzia administracyjne -> Źródła danych (ODBC) -> Systemowe DSN
}}}
należy dodać połączenie do bazy Symfonii. 

Klikamy "Dodaj" i z listy wybieramy "Pervasive ODBC Engine Interface". 
Po zatwierdzeniu należy skonfigurować źródło danych jak zaprezentowano na screenie. [s1.jpg]

Następny krok to umieszczenie specjalnego programiku (FKSync) na serwerze gdzie znajduje się system Symfonia oraz utworzone przed chwilą źródło danych. Programi wymaga PHP. Jeśli nie ma należy go doinstalować.

Program FKSync jest odpowiedzialny za synchronizację danych pomiędzy Symfonią w aplikacją eDokumenty. Synchronizacja te dodaje kontrahentów oraz dokumenty do specjalnej schemy w bazie Postgresa. Schema na nazywa się "symfonia_handel" (jeśli jej nie ma to w kolejnych punktach konfiguracji połączenia zostanie dodana).

Programik FKSync wymaga konfiguracji.

Przechodzimy do folderu 
{{{
FKSync\conf\tpl\symfonia_handel
}}}

i kopiujemy zawartość do katalogu

{{{
FKSync\conf
}}}
Pliki all_contacts.sql oraz all_documents.sql są definicjami komend SQL jakie będą wykonywane na bazie pervasive w celu pobrania odpowiednio kontaktów oraz dokumentów. Pliki te mogą być edytowane w celu pobrania dodatkowych informacji.

FKSync
config.inc
TODO OPEN_BALANCE_DATE

Plik connection.ini jest konfiguracją połączenia pomiędzy zdefiniowanym źródłem danych a bazą eDokumenty. Przykład poniżej:
{{{
[fk]
dsn = "encoding=windows-1250;dsn=SYMFONIA_HANDEL"
driver = "ODBCManager"

[edokumenty]
dsn = "dbname=edokumenty user=edokumenty password="
ent_id = 2
fkSchema = "symfonia_handel"
}}}

Aby dane były synchronizowane automatycznie należy dodać zadanie do 
{{{
Start -> Wszystkie programy -> Akcesoria -> Narzędzia systemowe -> Zaplanowane zadania
}}}

Przykład konfiguracji zadania.
[s2.jpg]

W przypadku innej konfiguracji źródła danych lub systemu eDokumenty należy odpowiednio zmodyfikować wartości pod kluczami dsn w [fk] oraz [edokumenty]. Klucz dns pod [edokumenty] to wartość z pliku config.inc pod kluczem DB_NAME systemu eDokumenty.
Plik config.inc znajduje się w {EDOKUMENTY_INSTALL_DIR}/apps/edokumenty
Pozostałych kluczy nie należy modyfikować.


Kolejny krok to konfiguracja systemu eDokumenty.
Przechodzimy do
{{{
 Ustawienia -> Źródła danych
}}}
Dodajemy źródło danych podobnie jak zaprezentowano w screenie [s3.jpg].
Nazwa źródła oraz ciąg połączenia mogą być inne. Ciąg połączenia znajduje się pod kluczem DB_NAME w pliku config.inc.

Po wprowadzeniu danych zapisujemy formularz.

Następnie przechodzimy do katalogu
{{{
apps\edokumenty\classes\BsConnect\install\sql\symfonia_handel
}}}
kopiujemy zawartość pliku 
{{{
01_install_relations_crt.sql
}}}
i wykonujemy ją za pomocą PgAdmina. 
W przypadku instalacji linuxowej bez graficznej nakładki należy plik 01_install_relations_crt.sql wykonać z linii poleceń komendą
{{{
psql -f "01_install_relations_crt.sql" edokumenty
}}}
Po wykonaniu w bazie pojawi się dodatkowa schema "symfonia_handel". Można to sprawdzić wykonując polecenie
{{{
edokumenty-# \dn
}}}

Następny plik który należy wykonać w podobny sposób to
{{{
02_install_triggers_crt.sql
}}}
Po wykonaniu powinny dodać się 2 triggery
 * bs_add_contact_to_queue
 * bs_add_document_to_queue

}}}
Można to sprawdzić wpisując
{{{
edokumenty-# SET search_path TO symfonia_handel;
edokumenty-# \dft
}}}