Dla kogo jest ta lista
Lista jest przeznaczona dla integratora albo administratora systemu KD, który buduje wysyłkę odbić do InnerWeb. Zakłada, że czytniki zostają bez zmian, a zmiana dotyczy wyłącznie tego, co system KD wysyła po każdym odbiciu karty.
InnerWeb nie produkuje czytników i nie wymienia ich, więc cała jakość integracji zależy od danych w zgłoszeniu. Zalecenia poniżej wynikają z wymagań specyfikacji integracji, w której InnerWeb przyjmuje i łączy zdarzenia z KD.
Zalecenie 1: zawsze wysyłaj numer aktywnej karty
Numer aktywnej karty jest identyfikatorem, po którym InnerWeb łączy odbicie z kontem osoby. Bez niego system musi opierać się na imieniu i nazwisku, co zwiększa ryzyko pomyłki przy osobach o tych samych danych.
Uzasadnienie dla zakupów i IT: pole numeru karty jest kluczem do sprawdzenia szkolenia BHP zanim brama przepuści osobę. Karta zezwolenia, kwalifikacje i szkolenia są powiązane z kontem osoby, a numer karty z KD staje się kluczem do tego konta.
Pola zgłoszenia według kategorii
Zalecenie 2: imię i nazwisko jako pole wymagane
Imię i nazwisko jest w zgłoszeniu wymagane. Zgłoszenie bez niego nie może założyć konta ani przypisać odbicia nowej osobie. Dostawca powinien więc wysyłać je w tej samej formie, w jakiej występuje w kartotece KD, bez skrótów i bez dopisków typu nazwa agencji.
Zalecane jest także pole akronimu, jeśli kartoteka KD takie prowadzi. Pomaga ono rozróżnić osoby o tych samych danych.
Zalecenie 3: nazwa firmy w jednolitej pisowni
Nazwa firmy jest wymagana, a firma zewnętrzna jest przypisywana na podstawie nazwy ze zgłoszenia. Odbicie karty przez osobę, której system nie zna, zakłada konto i firmę z danych zgłoszenia, więc dwie pisownie tej samej firmy dadzą dwie firmy.
Zalecenie dla integratora: wysyłać nazwę firmy z jednego pola słownikowego KD, nie z pola tekstu swobodnego. Jeśli takiego pola nie ma, trzeba ustalić z administratorem KD jedną obowiązującą pisownię.
Zalecenie 4: miejsce odbicia z ustalonego słownika
Pole miejsca odbicia rozróżnia lokalizacje czytników. Zdarzenia z miejsca, które nie ma szablonu w InnerWeb, trafiają do logu i nie uruchamiają alarmu szkoleniowego. Integrator powinien więc przekazać listę wszystkich nazw miejsc z KD, a zespół BHP przypisze im szablony.
Nazwa miejsca musi być stabilna. Zmiana nazwy czytnika w KD, bez informacji dla InnerWeb, powoduje, że zdarzenia znów trafiają do miejsca bez szablonu.
Zalecenie 5: czas zdarzenia i wysyłka w czasie rzeczywistym
Specyfikacja integracji wymaga, aby system KD wysyłał zdarzenia w czasie rzeczywistym, z czasem zdarzenia odczytanym z czytnika, a nie z chwili wysyłki. Dzięki temu ewidencja wejść odpowiada temu, co faktycznie wydarzyło się przy bramie.
Kolejka zdarzeń po awarii łącza powinna być opróżniana jak najszybciej, z zachowaniem oryginalnych czasów zdarzeń, a integrator powinien udokumentować, jakie opóźnienie jest w jego systemie akceptowalne.
Przy wyborze pól warto też spisać, które z nich kartoteka KD wypełnia automatycznie, a które wymagają ręcznego uzupełnienia przez administratora. Takie zestawienie skraca rozmowę z dostawcą i pozwala od razu wykryć pola, których system KD w ogóle nie prowadzi.
Zalecenie 6: telefon, e-mail i język tylko gdy są pewne
Telefon, e-mail i język są w zgłoszeniu polami dodatkowymi. Wysyłaj je tylko wtedy, gdy kartoteka KD je zawiera i są aktualne, ponieważ błędne dane kontaktowe wprowadzone na nowe konto trudno później wyłapać. Szczególnie pole języka warto wypełniać dla osób zagranicznych, bo wpływa na wersję szkolenia.
Zalecenie 7: uwierzytelnienie i obsługa wygaśnięcia tokenu
Wywołanie webhooka wymaga tokenu z endpointu logowania API. Token ma ograniczony czas ważności i jest odnawiany automatycznie przez integrację. Integrator powinien ponawiać logowanie i powtarzać odrzucone zgłoszenie, a nie gubić je.
Zgłoszenie powinno zawierać kierunek (wejście lub wyjście) oraz identyfikator zdarzenia. Zasady parowania wejść i wyjść oraz odrzucania duplikatów ustala się w specyfikacji z dostawcą KD, dlatego dublowanie wysyłek jest niewskazane.
Materiał wideo
Często zadawane pytania
Które pola są wymagane w zgłoszeniu odbicia?
Imię i nazwisko oraz nazwa firmy. Pozostałe pola, w tym numer aktywnej karty, poprawiają jakość powiązania odbicia z kontem.
Czy InnerWeb używa czasu z czytnika?
Tak, specyfikacja zakłada czas zdarzenia z czytnika oraz wysyłkę w czasie rzeczywistym, wraz z kierunkiem i identyfikatorem zdarzenia.
Co się stanie, gdy nazwa firmy będzie pisana różnie?
System założy odrębne firmy dla każdej pisowni. Nazwę najlepiej brać z jednego słownika w KD.
Jesteś integratorem KD?
Skontaktuj się, a przekażemy specyfikację webhooka odbicia karty i ustalimy zakres pól dla Twojego systemu.
Porozmawiajmy