Przejdź do głównej zawartości
Wersja: Next

Dodatek Autenti

Dodatek Autenti umożliwia integrację WEBCON z platformą Autenti w zakresie elektronicznego podpisywania dokumentów. Rozwiązanie pozwala wysłać do podpisu dokument zawierający załączniki wskazane na elemencie obiegu, a następnie przekierować użytkownika do aplikacji webowej Autenti — za pomocą wiadomości e-mail lub linku dostępnego bezpośrednio na formularzu.

Proces podpisywania odbywa się po stronie Autenti. Po jego zakończeniu podpisany dokument może zostać pobrany i dołączony jako załącznik elementu obiegu w WEBCON.

Dodatek (oparty na mechanizmie Paczki dodatków SDK) udostępnia zestaw akcji oraz niestandardowych źródeł danych, które można wykorzystać podczas konfiguracji obiegów obsługujących podpis elektroniczny.

Autenti plugin

Rys.1. Paczka dodatku Autenti z akcjami oraz źródłami danych

Wymagania​

Do korzystania z integracji WEBCON z Autenti wymagana jest odpowiednia licencja integracyjna Autenti. Szczegółowe informacje dotyczące licencjonowania należy uzyskać bezpośrednio od przedstawiciela Autenti.

Komunikacja z platformą Autenti odbywa się za pomocą konta systemowego, z którego dokumenty są wysyłane do podpisu. Osoby podpisujące dokumenty nie muszą posiadać konta w Autenti ani licencji WEBCON.

Do poprawnej konfiguracji integracji wymagane jest również utworzenie połączeń REST Web Service z REST API Autenti. Połączenia te są wykorzystywane do autoryzacji oraz komunikacji z usługą Autenti. Sposób konfiguracji połączeń został opisany w artykule na blogu technicznym – Podpisywanie dokumentu usługą Autenti.

Zakres działania dodatku​

Dodatek umożliwia wykonanie najważniejszych operacji związanych z obsługą procesu podpisywania dokumentów:

  • wysłanie dokumentu do podpisu,
  • pobranie statusu dokumentu,
  • pobranie statusu podpisu poszczególnych odbiorców,
  • pobranie podpisanego dokumentu,
  • pobranie linku do dokumentu w Autenti,
  • wysłanie przypomnienia do odbiorców,
  • wykorzystanie gotowych źródeł danych dla statusów, ról odbiorców i typów podpisu.

Dodatek nie zastępuje konfiguracji procesu biznesowego w WEBCON. Akcje należy umieścić w odpowiednich automatyzacjach, np. na ścieżkach przejścia, przyciskach w menu, akcjach cyklicznych lub mechanizmie Timera.

Przykładowy obieg został opisany w artykule Podpisywanie dokumentu usługą Autenti.

Akcje dodatku​

Poniżej opisano akcje dostarczane przez dodatek Autenti.

(AUTENTI) Wyślij dokument do podpisu​

Akcja tworzy dokument w Autenti i wysyła go do wskazanych odbiorców w celu złożenia podpisu lub wykonania innej wymaganej czynności, np. zatwierdzenia albo podglądu dokumentu.

Akcja zapisuje w formularzu identyfikator dokumentu nadany przez Autenti. Identyfikator jest kluczowy dla kolejnych akcji, ponieważ pozwala odwołać się do tego samego dokumentu podczas pobierania statusu, linku lub podpisanej wersji pliku.

Załączniki przeznaczone do podpisu można wskazać na podstawie kategorii załączników albo zapytania SQL zwracającego identyfikatory plików. Dzięki temu możliwe jest przekazanie do Autenti wszystkich załączników z danej kategorii lub wyłącznie wybranych plików.

(AUTENTI) Pobierz status dokumentu​

Akcja pobiera aktualny status dokumentu z Autenti i zapisuje go we wskazanym polu formularza.

Akcja jest przydatna w scenariuszach, w których proces powinien reagować na zmianę statusu dokumentu, np. przekazać element obiegu do kolejnego kroku po zakończeniu podpisywania albo pozostawić go w kroku oczekiwania, jeśli dokument nie został jeszcze podpisany.

(AUTENTI) Pobierz status podpisu odbiorców​

Akcja pobiera status podpisu lub uczestnictwa dla poszczególnych odbiorców dokumentu. Wyniki mogą zostać zapisane na Liście pozycji, np. w kolumnie przechowującej status podpisu danej osoby.

Akcja porównuje dane odbiorców z wierszami Listy pozycji i aktualizuje statusy dla odpowiadających im osób. Dzięki temu użytkownik może śledzić, którzy odbiorcy podpisali dokument, a którzy nadal oczekują na wykonanie czynności.

(AUTENTI) Pobierz dokument​

Akcja pobiera dokument z Autenti i zapisuje go jako załącznik elementu obiegu w WEBCON.

Najczęściej akcja jest wykonywana po zakończeniu procesu podpisywania, gdy dokument osiągnie odpowiedni status, np. COMPLETED. Akcja może zostać użyta na ścieżce sprawdzającej status dokumentu, w automatyzacji uruchamianej przez Timer albo jako akcja dostępna z poziomu menu.

Akcja pobiera link do dokumentu w Autenti. Link może zostać zapisany w polu formularza, zapisany na Liście pozycji przy odpowiednim odbiorcy albo użyty do bezpośredniego przekierowania użytkownika.

Dzięki tej akcji użytkownik może przejść do dokumentu w Autenti bez konieczności wyszukiwania wiadomości e-mail z linkiem do podpisu.

Należy pamiętać, że w scenariuszach, w których dokument został zabezpieczony kodem SMS, pobranie linku może nie być możliwe lub link może wymagać dodatkowej autoryzacji po stronie Autenti.

(AUTENTI) Wyślij powiadomienie​

Akcja wysyła przypomnienie do odbiorców, którzy mogą jeszcze wykonać czynność związaną z dokumentem, np. złożyć podpis.

Akcja odczytuje z Autenti listę odbiorców dostępnych do wysłania przypomnienia i wysyła do nich powiadomienie. Można ją uruchamiać ręcznie, np. przyciskiem w menu, albo automatycznie — w zależności od konfiguracji procesu.

Niestandardowe źródła danych​

Dodatek dostarcza niestandardowe źródła danych, które można wykorzystać na formularzu, np. w polach wyboru lub kolumnach Listy pozycji. Dzięki nim nie trzeba ręcznie definiować wartości zgodnych z Autenti.

Status dokumentu​

Źródło udostępnia statusy dokumentu zwracane przez Autenti. Może być używane np. w polu przechowującym aktualny status dokumentu.

Przykładowe wartości:

  • PROCESSING
  • SUCCESS
  • FAILED
  • WITHDRAWN
  • ERROR
  • COMPLETED
  • REJECTED

Role odbiorców​

Źródło udostępnia role odbiorców dokumentu. Role określają sposób uczestnictwa danej osoby w procesie obsługi dokumentu.

Przykładowe role:

  • Signer — osoba podpisująca dokument,
  • Approver — osoba zatwierdzająca dokument,
  • Reviewer — osoba opiniująca dokument,
  • Viewer — osoba posiadająca dostęp do podglądu dokumentu.

Lista dostępnych ról może zależeć od konfiguracji źródła.

Status podpisu odbiorców​

Źródło udostępnia statusy podpisu lub uczestnictwa odbiorców. Może być używane w kolumnie Listy pozycji przechowującej status każdej osoby biorącej udział w podpisywaniu dokumentu.

Rodzaje podpisów​

Źródło udostępnia typy podpisów dostępne w integracji z Autenti. Może zostać użyte w kolumnie Listy pozycji określającej sposób podpisania dokumentu przez danego odbiorcę.

Przykładowe typy podpisu:

  • Autenti E-signature — standardowy podpis elektroniczny,
  • Qualified signature — kwalifikowany podpis elektroniczny,
  • Advanced Autenti e-signature — zaawansowany podpis elektroniczny.

Lista dostępnych typów podpisu może zostać ograniczona w konfiguracji źródła zgodnie z wymaganiami procesu.

Dane techniczne wymagane w procesie​

W procesie wykorzystującym dodatek Autenti warto przygotować pola techniczne, które będą przechowywać dane zwracane przez usługę. Najważniejszym z nich jest identyfikator dokumentu nadany przez Autenti.

Identyfikator dokumentu jest wymagany przez akcje pobierające status dokumentu, status podpisu odbiorców, link do dokumentu oraz podpisany dokument. Jeśli identyfikator nie zostanie zapisany po wysłaniu dokumentu do podpisu, kolejne akcje nie będą mogły prawidłowo odwołać się do dokumentu w Autenti.

Repozytorium dodatku​

Kod źródłowy dodatku jest dostępny w repozytorium WEBCON na GitHubie i udostępniany na licencji MIT License.