InnerWeb
Przejdź do treści

Czas zdarzenia w webhooku KD: opóźnienia i hurt

Integracja z systemem KD opiera się na zdarzeniach wysyłanych w czasie rzeczywistym, z czasem zdarzenia z czytnika, kierunkiem i identyfikatorem. Dopóki łącze działa, czas z czytnika i czas wysyłki niemal się pokrywają. Po awarii łącza system KD często wysyła zbuforowane odbicia hurtem, dlatego warto uzgodnić z dostawcą zasady wysyłki. Poniżej uwagi dla zespołu IT.

2 000
odbić na dobę roboczą w dużym zakładzie, skala serii po awarii
4
ustalenia z dostawcą KD dla wysyłki po awarii
Źródło: specyfikacja integracji

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

Kalkulacja przykładowa: odbicia przesłane w ciągu godziny po awariiWykres liniowy: normalnie 25 odbić na kwadrans, po trzygodzinnej awarii w pierwszym kwadransie system KD przesyła 250 odbić naraz.050100150200250odbić0–15 min15–30 min30–45 min45–60 minBez awarii (0–15 min): 25 odbić25Bez awarii (15–30 min): 25 odbić25Bez awarii (30–45 min): 25 odbić25Bez awarii (45–60 min): 25 odbić25Po 3 h awarii (wysyłka hurtowa) (0–15 min): 250 odbić250Po 3 h awarii (wysyłka hurtowa) (15–30 min): 25 odbić25Po 3 h awarii (wysyłka hurtowa) (30–45 min): 25 odbić25Po 3 h awarii (wysyłka hurtowa) (45–60 min): 25 odbić25
  • Bez awarii
  • Po 3 h awarii (wysyłka hurtowa)
Źródło: Kalkulacja przykładowa: założenie ilustracyjne 100 odbić na godzinę w ciągu dnia i 3 godziny zbuforowane ( podaje skalę dobową powyżej 2 000).

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