Zmiany pomiędzy wersją 8 and wersją 9 dla DeployerGuide/Customization/Integration/Import/Contacts

Data i czas:

03/27/14 08:02:27 (10 years temu)

Autor:

jachtelik (IP: 213.227.67.33)

Komentarz:

--

DeployerGuide/Customization/Integration/Import/Contacts

@@ -103 +103 @@
 
 
-[[Image(cnt_003.png)]][[BR]]''Rys. 2. Konfiguracja akcji Pobierania wszystkich klientów''
+[[Image(cnt_003.png)]][[BR]]''Rys. 3. Konfiguracja akcji Pobierania wszystkich klientów''
 
 Przeznaczenie funkcji ''Użyj szablonu'' jest następujące. Na podstawie szablonu system wyszukuje, czy w bazie systemu eDokumenty istnieje już klient o takich samych danych, co aktualnie pobierane z systemu zewnętrznego. Konstrukcja jest następująca:
@@ -126 +126 @@
 
 [#kontrahent Powrót do menu]
+
+== Adresy kontrahenta == #adresy
+
+Pobieranie adresów kontrahenta jest ściśle związane z pobieraniem kartotek kontrahentów.
+
+=== Widoki (perspektywy) ===
+Na potrzeby pobierania adresów kontrahenta należy w schemacie integracji utworzyć widok:
+ * '''bs_contact_addresses_view'''
+
+W widoku wymaganym jest zdefiniowanie następujących kolumn:
+
+||Kolumna||Typ danych||Ograniczenia||Opis||Wymagalność||
+||'''bs_address_id'''||int||PRIMARY KEY (UNIQUE, NOT NULL)||Nazwa kontrahenta||Kolumna wymagana..'''Nazwa kolumny nie może być zmieniona'''||
+||'''bs_contact_id'''||int|| NOT NULL||Kolumna z identyfikatorem kontrahenta numerycznym typu całkowitego. ||Kolumna wymagana.'''Nazwa kolumny nie może być zmieniona'''||
+
+[[Image(cnt_004.png)]][[BR]]''Rys. 4. Przykładowy widok adresów kontrahentów''
+
+[#kontrahent Powrót do menu]
+
+=== Mapowanie kolumn ===
+
+Mapowanie kolumn odbywa się w tym samym pliku {{{ x_columns_map.ini }}}, co mapowanie kontrahenta.Przykładowy schemat mapowania przedstawiony na poniższym rysunku
+
+[[Image(cnt_005.png)]][[BR]]''Rys. 5. Przykład mapowania adresów kontrahentów''
+
+Mapowanie kolumn adresów kontrahenta należy rozpocząć od zdefiniowania w pliku sekcji [CONTACT_ADDRESS]
+
+||Nazwa pola|||Opis pola||
+||street||Ulica domyślnego/podstawowego adresu kontrahenta||
+||bldnum||Numer budynku domyślnego/podstawowego adresu kontrahenta||
+||fltnum||Numer lokalu domyślnego/podstawowego adresu kontrahenta||
+||code__||Kod pocztowy domyślnego/podstawowego adresu kontrahenta||
+||city__||Miejscowość domyślnego/podstawowego adresu kontrahenta||
+||post__||Poczta domyślnego/podstawowego adresu kontrahenta||
+||gmina_||Gmina domyślnego/podstawowego adresu kontrahenta||
+||powiat||Nazwa powiatu domyślnego/podstawowego adresu kontrahenta||
+||woj___||Województwo (nazwa powinna się zgadzać ze słownikiem województw ''Ustawienia>Panel Sterowania)||
+||countr||Kraj (nazwa powinna się zgadzać ze słownikiem krajów ''Ustawienia>Panel Sterowania)||
+||distkm||Dystans w kilometrach||
+||is_def|| Wartość 0,1 lub t,f - znacznik domyślności danego adresu||
+ 
+[#kontrahent Powrót do menu]
+
+=== konfigurowanie pobierania ===
+
+Pobieranie adresów kontrahentów nie posiada swoich dedykowanych akcji. Jest ono powiązane ściśle z pobieraniem samych kartotek kontrahentów.
+Aby skonfigurować pobieranie adresów należy:
+ 1. Wejść do konfiguracji Połączeń z systemami zewnętrznymi {{{Narzędzia > Połączenia z systemami zewnętrznymi}}}. 
+ 2. Wyedytować połączenie. Otworzy się okno z obiektami synchronizacji.
+ 3. Zaznaczyć pojedynczym kliknięciem obiekt: ''Klient'', a następnie wyedytować go.
+ 4. Na głównej zakładce należy wybrać opcję ''Pobierz adresy''
+
+Dodatkowo od wersji 4.2.xx pojawiła się opcja łączenia adresów. Oznacza to, że w przypadku zaistnienia takiego samego adresu (np. ulica + kod pocztowy) to taki adres dostaje dodatkowe powiązania, natomiast nie jest duplikowany w bazie danych.
+Przykładowy warunek może być następujący:
+{{{
+#!sql
+lower(street) = lower('{street}') AND COALESCE(regexp_replace(code__, '[ |-]*', '', 'g'), '') = COALESCE(regexp_replace('{code__}', '[ |-]*', '', 'g'), '')
+}}}
+
+Poniższy rysunek przedstawia konfigurowanie akcji pobierania adresów kontrahenta:
+
+[[Image(cnt_006.png)]][[BR]]''Rys. 6. Konfiguracja pobierania adresów kontrahentów''
+
+[#kontrahent Powrót do menu]