| 128 | |
| 129 | == Adresy kontrahenta == #adresy |
| 130 | |
| 131 | Pobieranie adresów kontrahenta jest ściśle związane z pobieraniem kartotek kontrahentów. |
| 132 | |
| 133 | === Widoki (perspektywy) === |
| 134 | Na potrzeby pobierania adresów kontrahenta należy w schemacie integracji utworzyć widok: |
| 135 | * '''bs_contact_addresses_view''' |
| 136 | |
| 137 | W widoku wymaganym jest zdefiniowanie następujących kolumn: |
| 138 | |
| 139 | ||Kolumna||Typ danych||Ograniczenia||Opis||Wymagalność|| |
| 140 | ||'''bs_address_id'''||int||PRIMARY KEY (UNIQUE, NOT NULL)||Nazwa kontrahenta||Kolumna wymagana..'''Nazwa kolumny nie może być zmieniona'''|| |
| 141 | ||'''bs_contact_id'''||int|| NOT NULL||Kolumna z identyfikatorem kontrahenta numerycznym typu całkowitego. ||Kolumna wymagana.'''Nazwa kolumny nie może być zmieniona'''|| |
| 142 | |
| 143 | [[Image(cnt_004.png)]][[BR]]''Rys. 4. Przykładowy widok adresów kontrahentów'' |
| 144 | |
| 145 | [#kontrahent Powrót do menu] |
| 146 | |
| 147 | === Mapowanie kolumn === |
| 148 | |
| 149 | Mapowanie kolumn odbywa się w tym samym pliku {{{ x_columns_map.ini }}}, co mapowanie kontrahenta.Przykładowy schemat mapowania przedstawiony na poniższym rysunku |
| 150 | |
| 151 | [[Image(cnt_005.png)]][[BR]]''Rys. 5. Przykład mapowania adresów kontrahentów'' |
| 152 | |
| 153 | Mapowanie kolumn adresów kontrahenta należy rozpocząć od zdefiniowania w pliku sekcji [CONTACT_ADDRESS] |
| 154 | |
| 155 | ||Nazwa pola|||Opis pola|| |
| 156 | ||street||Ulica domyślnego/podstawowego adresu kontrahenta|| |
| 157 | ||bldnum||Numer budynku domyślnego/podstawowego adresu kontrahenta|| |
| 158 | ||fltnum||Numer lokalu domyślnego/podstawowego adresu kontrahenta|| |
| 159 | ||code__||Kod pocztowy domyślnego/podstawowego adresu kontrahenta|| |
| 160 | ||city__||Miejscowość domyślnego/podstawowego adresu kontrahenta|| |
| 161 | ||post__||Poczta domyślnego/podstawowego adresu kontrahenta|| |
| 162 | ||gmina_||Gmina domyślnego/podstawowego adresu kontrahenta|| |
| 163 | ||powiat||Nazwa powiatu domyślnego/podstawowego adresu kontrahenta|| |
| 164 | ||woj___||Województwo (nazwa powinna się zgadzać ze słownikiem województw ''Ustawienia>Panel Sterowania)|| |
| 165 | ||countr||Kraj (nazwa powinna się zgadzać ze słownikiem krajów ''Ustawienia>Panel Sterowania)|| |
| 166 | ||distkm||Dystans w kilometrach|| |
| 167 | ||is_def|| Wartość 0,1 lub t,f - znacznik domyślności danego adresu|| |
| 168 | |
| 169 | [#kontrahent Powrót do menu] |
| 170 | |
| 171 | === konfigurowanie pobierania === |
| 172 | |
| 173 | Pobieranie adresów kontrahentów nie posiada swoich dedykowanych akcji. Jest ono powiązane ściśle z pobieraniem samych kartotek kontrahentów. |
| 174 | Aby skonfigurować pobieranie adresów należy: |
| 175 | 1. Wejść do konfiguracji Połączeń z systemami zewnętrznymi {{{Narzędzia > Połączenia z systemami zewnętrznymi}}}. |
| 176 | 2. Wyedytować połączenie. Otworzy się okno z obiektami synchronizacji. |
| 177 | 3. Zaznaczyć pojedynczym kliknięciem obiekt: ''Klient'', a następnie wyedytować go. |
| 178 | 4. Na głównej zakładce należy wybrać opcję ''Pobierz adresy'' |
| 179 | |
| 180 | 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. |
| 181 | Przykładowy warunek może być następujący: |
| 182 | {{{ |
| 183 | #!sql |
| 184 | lower(street) = lower('{street}') AND COALESCE(regexp_replace(code__, '[ |-]*', '', 'g'), '') = COALESCE(regexp_replace('{code__}', '[ |-]*', '', 'g'), '') |
| 185 | }}} |
| 186 | |
| 187 | Poniższy rysunek przedstawia konfigurowanie akcji pobierania adresów kontrahenta: |
| 188 | |
| 189 | [[Image(cnt_006.png)]][[BR]]''Rys. 6. Konfiguracja pobierania adresów kontrahentów'' |
| 190 | |
| 191 | [#kontrahent Powrót do menu] |