Wymaganie: czas zdarzenia z czytnika
Specyfikacja integracji zakłada, że system KD wysyła każde odbicie karty w czasie rzeczywistym i dołącza do niego czas zdarzenia z czytnika, kierunek (wejście lub wyjście) oraz identyfikator zdarzenia. InnerWeb przyjmuje je przez uwierzytelniony webhook. Zasady parowania wejść i wyjść oraz odrzucania duplikatów ustala się w specyfikacji razem z dostawcą KD, a nie zakłada z góry.
Praktyczny powód jest prosty: odbicie wykonane o 5:58 powinno w ewidencji nosić godzinę 5:58, nawet jeśli dotarło o 6:20. Dla alarmu szkoleniowego różnica zwykle nie ma znaczenia, ale dla ewidencji czasu pracy i listy ewakuacyjnej jest istotna, dlatego czas z czytnika jest podstawą każdego zdarzenia.
Scenariusz awarii łącza i wysyłki hurtowej
Po awarii łącza system KD często buforuje zdarzenia i wysyła je jednym ciągiem po przywróceniu połączenia. Dla odbiorcy wygląda to jak nagły wzrost ruchu. W zakładzie z wieloma agencjami pracy skala ruchu może przekraczać 2 000 odbić na dobę roboczą, więc seria po awarii bywa duża.
Z tego scenariusza wynikają dwa wymagania wobec specyfikacji. Po pierwsze, każde zdarzenie niesie własny czas z czytnika i identyfikator, aby seria zbuforowanych odbić zachowała właściwą kolejność. Po drugie, zasady odrzucania duplikatów trzeba opisać tak, by dwa prawdziwe odbicia jednej osoby, wysłane jedno po drugim w serii, nie zostały pomylone z powtórnym skanem. Dokładne reguły ustala się z dostawcą KD.
Kalkulacja przykładowa: odbicia przesłane w ciągu godziny po awarii
- Bez awarii
- Po 3 h awarii (wysyłka hurtowa)
Co ustalić z dostawcą KD
Ustalenia warto zapisać w specyfikacji integracji i w protokole odbioru. Chodzi o to, aby po stronie KD było jasne, jak zachowuje się wysyłka w sytuacji awaryjnej.
Pierwsze pytanie dotyczy kolejności: czy zdarzenia po awarii są wysyłane w kolejności czasowej, od najstarszego. Drugie dotyczy tempa: czy wysyłka hurtowa jest rozłożona w czasie, aby nie przeciążać odbiorcy. Trzecie dotyczy ponowień: jak system KD reaguje na odrzucone zgłoszenie, na przykład po odnowieniu tokenu. Czwarte dotyczy raportu: czy KD podaje liczbę zdarzeń wysłanych po awarii.
- wysyłka po awarii od najstarszego zdarzenia
- rozłożenie wysyłki hurtowej w czasie
- ponowienie odrzuconych zgłoszeń po odnowieniu tokenu
- raport z KD o liczbie zdarzeń wysłanych po awarii
Token o ograniczonym czasie ważności
Integracja uwierzytelnia się tokenem o ograniczonym czasie ważności, odnawianym automatycznie. Jeśli awaria trwała długo, token używany przed przerwą mógł wygasnąć, a po odzyskaniu łącza pierwsze zgłoszenia zostaną odrzucone do czasu odnowienia. Dobra integracja loguje się ponownie i powtarza odrzucone zgłoszenia, a zła je gubi bez śladu.
Dlatego w teście akceptacyjnym warto zasymulować wygaśnięcie tokenu w czasie wysyłki serii i sprawdzić, czy liczba zgłoszeń po stronie KD zgadza się z liczbą odbić przyjętych w InnerWeb.
Jak uzgodnić liczby po awarii
Po każdej awarii zespół IT porównuje dwie liczby: odbicia zarejestrowane w KD w oknie awarii i odbicia przyjęte w InnerWeb po jej zakończeniu. Różnica wskazuje zgłoszenia utracone lub odrzucone jako duplikaty. Brak różnicy też trzeba potwierdzić, bo cisza nie jest dowodem zdrowia.
Osoby, których odbicia dotarły z opóźnieniem, mogą mieć w ewidencji czasu pracy wyjątki. Kolejka wyjątków w mRCP pozwala je poprawić i zamknąć, a telefon przypominający o niezeskanowanym wyjściu uzupełnia lukę.
Rekomendacja: specyfikacja jako podstawa
Jeśli opóźnienia w zakładzie są częste, warto zapisać wysyłkę w czasie rzeczywistym jako wymaganie nadrzędne w specyfikacji z dostawcą KD, a czas z czytnika, kierunek i identyfikator zdarzenia jako pola obowiązkowe każdego zgłoszenia. Taka specyfikacja jest elementem projektu integracji i podstawą testu akceptacyjnego.
Materiał wideo
Często zadawane pytania
Jakie dane powinno zawierać zgłoszenie odbicia z KD?
Czas zdarzenia z czytnika, kierunek (wejście lub wyjście) i identyfikator zdarzenia. Zgłoszenie trafia do InnerWeb przez uwierzytelniony webhook.
Co się dzieje z odbiciami po awarii łącza?
System KD wysyła zbuforowane zdarzenia po odzyskaniu łączności, najlepiej od najstarszego, każde z własnym czasem z czytnika. Warto porównać liczbę odbić w KD i w InnerWeb.
Kto ustala zasady parowania wejść i wyjść oraz duplikatów?
Zasady te ustala się w specyfikacji integracji razem z dostawcą KD. Dzięki temu wysyłka hurtowa po awarii nie myli dwóch prawdziwych odbić z powtórnym skanem.
Chcesz przetestować wysyłkę po awarii?
Umów rozmowę z zespołem InnerWeb. Przygotujemy scenariusz testu wysyłki hurtowej i odnowienia tokenu dla Twojego dostawcy KD.
Porozmawiajmy