= [wiki:DeployerGuide Przewodnik wdrożeniowca] > Podstawowa konfiguracja systemu eDokumenty (uruchomienie modułu BSConnect) = #konfiguracja

[wiki:DeployerGuide/Customization/Integration Strona główna Integracji]


=== Wprowadzenie === #menu
 1. [#zrodlo_danych Konfiguracja źródeł danych]
 2. [#uruchomienie Uruchomienie modułu BSConnect]
 3. [#zrodla_wymiany_danych Konfiguracja źródeł wymiany danych] 


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

Sekcja ta opisuje sposób konfiguracji źródła danych. Źródło jest ciągiem tekstowym, który zawiera dane połączenia do zewnętrznej bazy danych, takie jak:
 * Server - Nazwę instancji serwera. Zawiera w sobie adres hosta serwera baz danych, numer portu (np. dla zdalnych połączeń z Ms SQL Server). Przykładowe dane to {{{localhost\sqlexpress}}} lub też {{{192.168.0.1:1024}}},
 * Database - Nazwę bazy danych.
 * Uid, User - identyfikator użytkownika baz danych
 * Pwd, Password - hasło użytkownika bazy danych
 * Port - [parametr opcjonalny] numer portu, na którym nasłuchuje serwer baz danych. Parametr nie jest wykorzystywany przez Ms SQL Server.
 * Encoding - [parametr opcjonalny] kodowanie połączenia z systemem zewnętrznym.

W poniższym listingu przedstawiono przykładowe ciągi połączeń dla różnych systemów zarządzania bazami danych:
{{{
# Microsoft SQL Server :
Server=localhost\sqlexpress;Database=eDok;Uid=edokumenty;Pwd=edokumenty;
lub 
Server=192.168.0.1:1433;Database=eDok;Uid=edokumenty;Pwd=edokumenty;

# MySQL :
Server=192.168.0.1;Port=3306;Database=eDok;User=edokumenty;Password=edokumenty;

# Oracle :
Server=192.168.0.1;Database=192.168.0.1/eDok;Uid=edokumenty;Pwd=edokumenty;encoding=AL32UTF8;

# PostgreSQL :
host=localhost port=5432 dbname=eDok user=edokumenty password=edokumenty

}}}

Konfigurację źródła danych przeprowadzamy w menu ''Ustawienia > Panel Sterowania > Źródła danych'' :

[[Image(20131111_090914.png)]][[BR]]''Rys. 1. Ustawienia > Panel Sterowania''[[BR]]
[[Image(20131111_091202.png)]][[BR]]''Rys. 2. Panel Sterowania i Źródła danych''[[BR]]
[[Image(20131111_091317.png)]][[BR]]''Rys. 3. Okno konfiguracji źródeł danych''[[BR]]

W oknie tym można uruchamiać dodawanie, edycję lub też usuwać źródła danych. W przypadku dodawania lub edycji uruchomi się okno, w którym należy:
 * wprowadzić unikalną nazwę (najlepiej identyfikującą system zewnętrzny)
 * wybrać sterownik do odpowiedniego SZBD
 * wpisać ciąg połączenia.

[[Image(20131111_091456.png)]][[BR]]''Rys. 4. Okno dodawania / edycji źródła danych''[[BR]]

Po kliknięciu przycisku Zapisz okienko edycji powinno się zamknąć. Oznacza to, że źródło zostało poprawnie dodane. W przeciwnym przypadku zostanie wyświetlony komunikat o błędzie połączenia.

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

== Uruchomienie modułu BSCOnnect == #uruchomienie

Kolejnym etapem w procesie Integracji z systemem zewnętrznym jest uruchomienie modułu '''BSConnect'''.
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:
{{{
#!php
define('SYNC_ACTIVE', 'NEW');
}}}

[[Image(001.jpg)]][[BR]]''Rys. 5. Wpis w pliku config.inc''

Następnie należy przelogować się na koncie administratora systemu eDokumenty.
Po ponownym zalogowaniu się w menu ''Narzędzia'' powinno pojawić się polecenie ''Połączenia z systemami zewnętrznymi'':

[[Image(003.jpg)]][[BR]]''Rys. 6. Widok menu po uruchomieniu modułu BSConnect''

Klikając na polecenie: ''Narzędzia > Połączenia z systemami zewnętrznymi'' uruchamia się okno konfiguracji połączeń z systemami zewnętrznymi.:

[[Image(004.jpg)]][[BR]]''Rys. 7. Okno konfiguracji połączeń z systemami zewnętrznymi''

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

== Konfiguracja źródeł wymiany danych == #zrodla_wymiany_danych

 [TODO]
 * Konfiguracja źródeł wymiany danych
 
''[#konfiguracja Powrót do menu]''