Dla tabeli adresów
Aby umożliwić synchronizację z systemem Subiekt należy wykonać poniższe czynności.
W pliku config.inc należy zmienić stałą "SUBIEKT_DATA_SOURCE_DTSCNM" na
define('SUBIEKT_DATA_SOURCE_DTSCNM', 'nazwa');
gdzie nazwę należy zastąpić nazwą bazy danych systemu Subiekt
Jeśli w systemie !eDokumenty tabela wsdl_config_table jest pusta należy wykonać odpowiedni skrypt SQL dla Subiekt znajduję się on w katalogu
apps\edokumenty\classes\BsConnect\install\data\subiekt_wsdl_ins.sql
następnie należy przejść do punktu "Konfiguracja tabeli wsdl_config_table" aby dokonać niezbędnych poprawek oraz ustawień według zaleceń.
Następny krok to sprawdzenie tabeli wsdl_config_table oraz czy zawiera dane. W przypadku jeśli jest pusta proszę udać się na stronę z integracją wybranego systemu. Edycję ustawień połączeń możemy dokonać z interfejsu eDokumentów Ustawienia -> Systemy zewnętrzne
Opis kolumn
UPDATE wsdl_config_table SET wsdl__ = replace(wsdl__, '{host}', 'localhost:8080/edokumenty');
(np. dla OPT!MY: Knt_Nip='{nip___}' AND Knt_Nazwa1='{name_1}' co oznacza, że będzie
wyszukiwanie kontaktu w systemie OT!MA gdzie kolumna Knt_Nip będzie równa numerowi nip
kontaktu z systemu eDokumenty (token {nip___} jest zamieniany na dane) itd)
Różnica między tymi metodami polega na tym iż w przypadku szukania kontaktu w systemie zew. należy wykonać zapytanie na zew. bazie dlatego z lewej strony są nazwy kolumn z systemu zew. a z prawej tokeny nazwy kolumn systemu eDokumenty, które zostaną zastąpione danymi wybranego kontaktu.
Reszta metod służy do porównania danych przychodzących z systemu zew. do systemu eDokumenty. Zapytanie jest wykonywane na bazie eDokumenty dlatego z lewej strony wstawiamy nazwę kolumny z tabeli z bazy eDokumenty natomiast z prawej dane z tablicy "mapy" z systemu zew.
Tablica (mapa kolumn) ułatwia sparsowanie danych i lepsze rozeznanie przykład
apps\edokumenty\etc\sync\OPTIMA_columns_map.ini Przykładowa konfiguracja tablicy mapy dla kontaktu dla OPT!MY [contacts] Knt_KntID = contid Knt_Nazwa1 = name_1 Knt_Nazwa2 = name_2 Knt_Nazwa3 = name_2 Knt_Kraj = countr Knt_Wojewodztwo = woj___ Knt_Powiat = powiat Knt_Ulica = street Knt_NrDomu = bldnum Knt_NrLokalu = fltnum Knt_Miasto = city__ Knt_KodPocztowy = code__ Knt_Nip = nip___
Oznacza to, że do dyspozycji będą dane pod danymi kluczami np.: klucz "nip___" będzie zawierał numer nip kontaktu z systemu zew. (w tym przypadku OPT!MA) dlatego warunek zapytania w bazie eDokumeny będzie miało postać
nip___='{nip___}'
Czyli szukamy kontaktu w bazie eDokumenty gdzię nip___ (lewa strona) kontaktu z bazy eDokumenty jest równy numerow nip z tabeli - mapy danych jakie otrzymamy z systemu zew. Należy pamiętać aby token w wąsach był dodatkowo w pojedyńczych apostrofach. Ze względu na różny typ danych i sposób w jaki mogą być potraktowane przez SQL (cyfry, liczby nie wymagają apostrofów natomiast litery tak!!) lepiej jest dla każdego typu danych w wąsach stosować apostrofy.
W systemie Subiekt (w bazie) wykonujemy skrypt z pliku
apps\edokumenty\classes\BsConnect\install\sql\subiekt\subiekt_export_queue.sql
Po wykonaniu tego skryptu w systemie Subiekt powinna pojawić się dodatkowa tabela o nazwie export_queue.
Triggery mają za zadanie dodawać do kolejki dokumenty i kontaktu które zostały zmodyfikowane bądź dodane do systemu Subiekt. Triggery wykonujemy z załączników bądź w folderze
apps\edokumenty\classes\BsConnect\install\sql\subiekt
znajdują się pliki oryginalne. Kolejność ich wykonywania nie ma znaczenia. Po ich wykonaniu należy sprawdzić czy tabele dokDokument, adrEwid oraz Kontrahent posiadają dodatkowe triggery. Można tego dokonać za pomocą narzędzia SQL Manager Lite for SQL Server firmy EMS. (http://www.sqlmanager.net/)
Dla tabeli adresów
Natomiast dla tabeli Kontrahenci
Natomiast dla tabeli dokumentów
Możemy przetestować działanie mechanizmy poprzez dodanie do systemu Subiekt dokumentu lub kontrahenta i sprawdzeniu czy w tabeli export_queue pojawiły się wpisy.
Począwszy od wersji 2.0 RC16 można decydować jakie dane mają być pobierane z systemu zew. poprzez modyfikacje specjalnych widoków przeznaczonych do synchronizacji. Widoki te są wymagane w celu prawidłowego funkcjonowania. Można je znaleźć w katalogu
edokumenty\classes\BsConnect\install\sql\subiekt\views
Można też je pobrać z załączonego niżej katalogu subiekt.zip. Widoki należy wykonać na bazie Subiekt (MsSQL).
Opis widoków
kolejność wykonywania nie ma znaczenia.
Widoki te można modyfikować według potrzeb(dodawać kolumny itd) eliminując w ten sposób dodatkową pracę ze strony programisty i aktualizacji w postaci nowej wersji ze zmodyfikowanym widokiem. Widoki modyfikujemy jeśli klient zażyczy sobie aby z systemu zew. były pobierane dodatkowe dane, których podstawowa definicja nie uwzględniła. Następnie w pliku konfiguracyjnym
SUBIEKT_columns_map.ini
dodajemy kolejny wpis pod odpowiednim indeksem [contacts] - kontakty, [documents] - dokumenty z rzutowaniem danych z dodanej kolumny w widoku na kolumnę w systemie eDokumenty.
Jaka metoda jaki widok wykorzystuje
Na wypadek gdyby wprowadzone zmiany miały być z jakiegoś względu wycofane z bazy Subiekta, należy wykonać plik reset_subiekt.sql który usuwa tabele export_queue, triggery oraz widoki.
Aby raportować rozrachunki z klientem, sprzedaż czy cokolwiek z nim związane można do tego użyć raportów ze zdefiniowanym zewnętrznym źródłem danych patrz: tworzenie raportów SQL