EZD RP umożliwia integrację z zewnętrznymi bazami kontaktów. Dzięki odpowiednim uprawnieniom wybrani użytkownicy mogą skonfigurować zewnętrzną bazę kontaktów oraz wyszukiwać w niej rekordy. System pozwala określić kryteria wyszukiwania, wyświetlić wyniki wyszukiwania oraz zapisać pobrane dane w wewnętrznej bazie kontaktów.
Konfiguracja uwierzytelnienia
Aby skonfigurować dostęp do zewnętrznej bazy kontaktów, pracownik musi mieć nadane uprawnienie Administracja.ZewnetrznaBazaKontaktow na poziomie Instytucja. Uprawnienie pozwala wyświetlić kafelek Zewnętrzna baza kontaktów w module Administracja.
Po wybraniu kafelka Zewnętrzna baza kontaktów użytkownik może wprowadzić, edytować i zapisać następujące parametry:
- Adres URL – adres serwera, pod którym jest dostępna zewnętrzna baza kontaktów.
- Klucz API – klucz służący do autoryzacji komunikacji z usługą zewnętrznej bazy kontaktów.
- Nazwa identyfikatora – nazwa unikalnego identyfikatora rekordu (np. UUID).
Aby zapisać konfigurację, należy wypełnić wszystkie parametry. Można również przetestować komunikację z zewnętrzną bazą kontaktów, wybierając przycisk TEST. Test weryfikuje połączenie i zwraca komunikat:
Konfiguracja prawidłowa
Jeżeli podczas weryfikacji wystąpi błąd, system zwróci odpowiedni komunikat o błędzie.
Wyszukiwanie i pobieranie kontaktu
EZD RP umożliwia wyszukiwanie kontaktów w zewnętrznej bazie, pobieranie ich oraz łączenie z wynikami wyszukiwania w systemie. Wyszukiwanie w zewnętrznej bazie jest dostępne z poziomu zakładki Wyszukiwanie zaawansowane. Aby korzystać z tej funkcji, pracownik musi mieć nadane uprawnienie BazaKontaktow.ZewnetrznaBazaKontaktow na poziomie Instytucji. W zewnętrznej bazie kontaktów można wyszukiwać dane na podstawie następujących pól:
- Imię i Drugie imię,
- Nazwisko lub Nazwa podmiotu,
- Kraj, Miejscowość i Ulica,
- Numer budynku i Numer lokalu,
- Kod pocztowy, E-mail i PESEL,
- UUID – indywidualny, unikalny identyfikator kontaktu w zewnętrznej bazie danych.
W zależności od wyniku wyszukiwania w zewnętrznej bazie kontaktów system może wyświetlić informacje o:
- błędzie usługi zewnętrznej bazy kontaktów lub braku połączenia z usługą,
- braku wskazanych adresatów w zewnętrznej bazie kontaktów,
- zbyt dużej liczbie wyników i konieczności zawężenia kryteriów wyszukiwania.
W przypadku wyszukiwania w bazie zewnętrznej system zwraca wyniki w sekcjach ADRESACI ZEWNĘTRZNI oraz ADRESACI EZD RP.
W sytuacji awaryjnej system może wyświetlić informacje o:
- błędzie usługi zewnętrznej bazy kontaktów lub braku połączenia z usługą,
- braku wskazanych adresatów w zewnętrznej bazie kontaktów,
- zbyt dużej liczbie wyników i konieczności zawężenia kryteriów wyszukiwania.
Importowanie i aktualizacja rekordów
Rozwiązanie pozwala importować kontakty z zewnętrznej bazy do EZD RP. Po wybraniu akcji Pobierz do EZD RP (ikona dysku ze strzałką w dół w kolumnie Akcje) system otwiera okno weryfikacyjne. Po zatwierdzeniu operacji system dodaje nowy kontakt do wewnętrznej bazy kontaktów.
Każdy pobierany rekord musi zawierać co najmniej: typ adresata, imię i nazwisko lub nazwę podmiotu, unikalny identyfikator (UUID) oraz jeden z następujących rodzajów danych kontaktowych: adres fizyczny, adres e-mail, adres ePUAP lub adres do doręczeń elektronicznych (ADE).
Podczas pobierania lub aktualizacji adresata system weryfikuje zgodność danych adresowych z rejestrem TERYT. Jeżeli miejscowość lub ulica nie są zgodne z danymi zapisanymi w rejestrze, system wyświetla komunikat o błędzie i blokuje zapis do czasu poprawienia danych przez operatora. Wprowadzone zmiany są zapisywane wyłącznie w EZD RP i nie powodują modyfikacji danych w zewnętrznej bazie referencyjnej.
Po poprawnym zaimportowaniu adresata system wyświetla status Pobrany do EZD RP.
Przy każdym kolejnym wyszukiwaniu tego kontaktu w Bazie kontaktów system wyświetla informację, że kontakt pochodzi z zewnętrznej bazy referencyjnej, wraz z jego zewnętrznym identyfikatorem UUID.
