Version 4 (modified by jachtelik, 11 years ago)

--

Przewodnik wdrożeniowca > Synchronizacja kontrahentów

Strona główna Integracji
Strona główna sekcji importu danych

  1. Wstęp
  2. Kontrahenci
  3. Konta bankowe
  4. Osoby kontaktowe

Wstęp

Niniejsza sekcja opisuje synchronizację Kontrahentów. Do tego można zaliczyć pobieranie :

  • kartotek kontrahentów,
  • kont bankowych kontrahentów,
  • osób kontaktowych kontrahenta

Dla każdego obszaru zostanie pokazane:

  • przykładowy wygląd widoku z definicją kluczowych kolumn
  • mapowanie kolumn
  • przykład szablonu dla różnych akcji synchronizacji.

Niniejszy opis dotyczy integracji przy pomocy połączenia typu DB.

Powrót do menu

Kontrahenci

Widoki (perspektywy)

Do obsługi pobierania danych kontrahentów należy po stronie zewnętrznego systemu (w odpowiednim schemacie - tym samym, co tabela bs_export_queue) zdefiniować dwa widoki (perspektywy):

  • bs_contacts_view
  • bs_modified_contacts_view

Perspektywa bs_contacts_view zawiera kartoteki wszystkich kontrahentów, natomiast bs_modified_contacts_view jest złączeniem wewnętrznym tabeli bs_export_queue z widokiem bs_contacts_view. Definicja takiego widoku zostanie przedstawiona poniżej. Przykładowy widok bs_contacts_view może wyglądać w sposób następujący:


Rys. 1. Przykład widoku bs_contacts_view

W definicji widoku zaleca się następujących kolumn (pogrubione kolumny są wymagane):

KolumnaTyp danychOgraniczeniaOpisWymagalność
bs_contact_idintPRIMARY KEY (UNIQUE, NOT NULL)Kolumna z identyfikatorem numerycznym typu całkowitego. Kolumna wymagana.Nazwa kolumny nie może być zmieniona
Nazwavarchar(n)NOT NULLNazwa kontrahentaKolumna wymagana
Skrotvarchar(n)NOT NULL (UNIQUE)Skrót nazwy kontrahentaOpcjonalna, służyć może jako kolumna szablonowa do porównań istnienia kontrahentów
NIPvarchar(n)NOT NULL (UNIQUE)NIP kontrahentaOpcjonalna, służyć może jako kolumna szablonowa do porównań istnienia kontrahentów

Mapowanie kolumn

W lokalizacji public_html/apps/edokumenty/etc/sync należy utworzyć pliki .ini o nazwie x_columns_map.ini , gdzie "x" oznacza numer połączenia z systemem zewnętrznym. Np. połączenie nr. 1 będzie szukać pliku 1_colaumns_map.ini. Dla kontrahenta przykładowe mapowanie winno wyglądać:


Rys. 2. Przykład mapowania dla kontrahenta

Jak widać na powyższym obrazku mapowania składa się z dwóch części:

  • nazwy sekcji [CONTACT]
  • mapowania kolumn

W mapowaniu kolumn należy mieć na uwadze to, że po lewej stronie znaku "=" znajdują się kolumny z widoku bs_contacts_view, a po prawej nazwy kolumn z bazy systemu eDokumenty (z kilkoma wyjątkami, ale dotyczącymi innych obszarów). W pliku tym nie wprowadzamy kolumn kluczowych, czyli w tym przypadku bs_contact_id !!!

W poniższej tabelce przedstawiono przykłady pól z systemu eDokumenty (po prawej stronie znaku "=") z opisem:

Nazwa pola|Opis pola
name_1Nazwa kontrahenta
name_2Skrót (akronim) kontrahenta
symbolSymbol kontrahenta
streetUlica domyślnego/podstawowego adresu kontrahenta
bldnumNumer budynku domyślnego/podstawowego adresu kontrahenta
fltnumNumer lokalu domyślnego/podstawowego adresu kontrahenta
codeKod pocztowy domyślnego/podstawowego adresu kontrahenta
cityMiejscowość domyślnego/podstawowego adresu kontrahenta
postPoczta domyślnego/podstawowego adresu kontrahenta
gmina_Gmina domyślnego/podstawowego adresu kontrahenta
powiatNazwa powiatu domyślnego/podstawowego adresu kontrahenta
woj_Województwo (nazwa powinna się zgadzać ze słownikiem województw Ustawienia>Panel Sterowania)
countrKraj (nazwa powinna się zgadzać ze słownikiem krajów Ustawienia>Panel Sterowania)
nip_Numer NIP kontrahenta
regon_Numer REGON kontrahenta
pesel_Numer PESEL kontrahenta
ph_numNumer stacjonarny kontrahenta
faxnumNumer faksu kontrahenta
email_Adres email kontrahenta
websitAdresy strony WWW kontrahenta

Uwaga! Jedna kolumna nie może być podwójnie mapowana (do dwóch różnych pól).

Powrót do menu

Załączniki