Jak działa integracja i czego InnerWeb nie robi
Punktem integracji z istniejącym systemem KD jest webhook odbicia karty: system KD wysyła żądanie HTTP POST przy każdym odbiciu. InnerWeb nie produkuje ani nie wymienia czytników. Jest niezależnym systemem uzupełniającym KD, RCP, HR i ERP. Dla IT oznacza to, że punktem testów jest dostawca KD i jego kolejka wysyłania, a nie sprzęt przy bramie.
Zgłoszenie zawiera czas zdarzenia, miejsce odbicia oraz dane osoby: imię i nazwisko (wymagane), akronim, firmę (nazwa wymagana), numer aktywnej karty, telefon, e-mail i język.
Etap 1: uwierzytelnianie i odnawianie tokenu
Wywołanie webhooka wymaga tokenu JWT z endpointu logowania API. To token o ograniczonym czasie ważności, odnawiany automatycznie przez integrację. Przy kilku zmianach na dobę odnawianie musi działać bez udziału człowieka, także w środku zmiany. Zespół IT powinien sprawdzić, czy system KD odnawia token przed upływem terminu i co robi po odpowiedzi odrzucającej.
Proponowany test: wymuś odnowienie tokenu w środowisku testowym i obserwuj, czy odbicia z kolejki systemu KD nie giną. Zapisz, ile odbić zostanie powtórzonych po odnowieniu.
Średnie tempo odbić w zależności od czasu startu zmiany, przykład
Etap 2: wymagania specyfikacji dla zdarzeń z KD
System KD wysyła zdarzenia w czasie rzeczywistym, z czasem zdarzenia odczytanym z czytnika, kierunkiem (wejście lub wyjście) i identyfikatorem zdarzenia, a InnerWeb przyjmuje je przez uwierzytelniony webhook. Zasady parowania wejść i wyjść oraz odrzucania duplikatów ustala się w specyfikacji z dostawcą KD. Ma to znaczenie w szczycie: jeśli system KD zbiera odbicia w kolejce i wysyła je z opóźnieniem, w InnerWeb liczy się czas odbicia z czytnika, a nie czas wysyłki.
Identyfikator zdarzenia pozwala odróżnić powtórzone żądanie od kolejnego odbicia. Zespół IT powinien więc uzgodnić z dostawcą KD zasady ponawiania, ograniczyć je do sytuacji bez potwierdzenia przyjęcia i opisać, jak system KD się zachowuje. Statusy typu początek i koniec pracy nie należą do zakresu tej integracji.
Etap 3: rozróżnianie bram i miejsc odbicia
Dostawca KD, który odbija karty przy kilku lokalizacjach, rozróżnia je polem miejsca odbicia. W magazynie z kilkoma bramami, śluzami i wejściami do stref trzeba uzgodnić słownik nazw miejsc i trzymać go stałym. Zmiana nazwy bramy w systemie KD bez uzgodnienia powoduje rozjechanie raportów.
- Spisz wszystkie miejsca odbicia z systemu KD i ich nazwy.
- Uzgodnij z administratorem InnerWeb zakres miejsc objętych kontrolą szkoleń.
- Przetestuj odbicie na każdej bramie przed szczytem.
Etap 4: test obciążeniowy przed sezonem
Przy założeniu 400 osób w 15 minut średnio odbija się 400 / 900 sekund, czyli około 0,44 odbicia na sekundę, a w szczycie krótkotrwałym wielokrotnie więcej. To kalkulacja przykładowa. Test powinien odtworzyć ten wzorzec: seria żądań z systemu KD z danymi kilkuset osób, w tym nowych, nieznanych systemowi. Obserwuj opóźnienie odpowiedzi, odrzucenia i liczbę założonych kont i firm.
Odbicie osoby nieznanej systemowi zakłada konto i firmę, więc test z nowymi osobami sprawdza także jednolitość zapisu nazw agencji.
Co zespół IT ma mieć gotowe przed pierwszym szczytem
Najważniejsze są trzy rzeczy: procedura odnawiania tokenu, opis zachowania systemu KD przy braku odpowiedzi oraz kontakt do administratora InnerWeb na czas szczytu. Warto też ustalić, kto w IT patrzy na bramę w pierwszych 30 minutach zmiany.
Materiał wideo
Często zadawane pytania
Jak działa token do webhooka?
To token o ograniczonym czasie ważności, odnawiany automatycznie przez integrację, więc system KD powinien odnawiać go w ciągu zmiany.
Jakie dane powinien wysyłać system KD?
Zdarzenia w czasie rzeczywistym, z czasem z czytnika, kierunkiem wejście lub wyjście i identyfikatorem zdarzenia. Zasady parowania i odrzucania duplikatów ustala się w specyfikacji z dostawcą KD.
Skąd InnerWeb wie, która to brama?
Z pola miejsca odbicia w zgłoszeniu. Nazwy trzeba trzymać stałe.
Czy test obciążeniowy można zrobić na produkcji?
Zalecamy środowisko testowe, ponieważ test z nowymi osobami zakłada konta i firmy.
Przetestuj integrację przed sezonem
Umów rozmowę z zespołem IT. Przejdziemy przez token, kolejkę odbić i słownik miejsc, zanim zmiana ruszy z kilkuset kartami.
Porozmawiajmy