InnerWeb
Přejít na obsah

Čas události ve webhooku KD: zpoždění a dávky

Integrace se systémem KD stojí na událostech odesílaných v reálném čase, s časem události z čtečky, směrem a identifikátorem. Dokud linka funguje, čas z čtečky a čas odeslání se téměř shodují. Po výpadku linky systém KD často odešle nahromaděná odbití najednou, proto je vhodné s dodavatelem sjednat pravidla odesílání. Níže jsou poznámky pro tým IT.

2 000
odbití za pracovní den ve velkém závodě, rozsah série po výpadku
4
ujednání s dodavatelem KD pro odesílání po výpadku
Zdroj: specyfikace integracji

Požadavek: čas události z čtečky

Specifikace integrace počítá s tím, že systém KD odesílá každé odbití karty v reálném čase a připojuje k němu čas události z čtečky, směr (vstup nebo výstup) a identifikátor události. InnerWeb je přijímá přes ověřený webhook. Pravidla párování vstupů a výstupů a odmítání duplicit se určují ve specifikaci spolu s dodavatelem KD, a ne předem.

Praktický důvod je prostý: odbití provedené v 5:58 má v evidenci nést čas 5:58, i když dorazí v 6:20. Pro školicí alarm rozdíl obvykle nehraje roli, ale pro evidenci pracovní doby a evakuační seznam je podstatný, proto je čas z čtečky základem každé události.

Scénář výpadku linky a dávkového odeslání

Po výpadku linky systém KD události často ukládá do vyrovnávací paměti a po obnovení spojení je odešle v jedné řadě. Pro příjemce to vypadá jako náhlý nárůst provozu. V závodě s více agenturami práce může provoz přesáhnout 2 000 odbití za pracovní den, takže série po výpadku bývá velká.

Z tohoto scénáře plynou dva požadavky na specifikaci. Zaprvé každá událost nese vlastní čas z čtečky a identifikátor, aby série uložených odbití zachovala správné pořadí. Zadruhé pravidla odmítání duplicit je třeba popsat tak, aby dvě skutečná odbití jedné osoby, odeslaná těsně za sebou v sérii, nebyla zaměněna za opětovné naskenování. Přesná pravidla se určují s dodavatelem KD.

Příkladová kalkulace: odbití odeslaná během hodiny po výpadku

Příkladová kalkulace: odbití odeslaná během hodiny po výpadkuČárový graf: normálně 25 odbití za čtvrt hodiny, po tříhodinovém výpadku systém KD v první čtvrt hodině odešle 250 odbití najednou.050100150200250odbití0–15 min15–30 min30–45 min45–60 minBez výpadku (0–15 min): 25 odbití25Bez výpadku (15–30 min): 25 odbití25Bez výpadku (30–45 min): 25 odbití25Bez výpadku (45–60 min): 25 odbití25Po 3 h výpadku (hromadné odeslání) (0–15 min): 250 odbití250Po 3 h výpadku (hromadné odeslání) (15–30 min): 25 odbití25Po 3 h výpadku (hromadné odeslání) (30–45 min): 25 odbití25Po 3 h výpadku (hromadné odeslání) (45–60 min): 25 odbití25
  • Bez výpadku
  • Po 3 h výpadku (hromadné odeslání)
Zdroj: Příkladová kalkulace: ilustrační předpoklad 100 odbití za hodinu během dne a 3 hodiny uložené ve frontě ( uvádí denní rozsah nad 2 000).

Co sjednat s dodavatelem KD

Ujednání je vhodné zapsat do specifikace integrace a do protokolu o převzetí. Jde o to, aby na straně KD bylo jasné, jak se odesílání chová v havarijním stavu.

První otázka se týká pořadí: zda se události po výpadku odesílají v časovém pořadí, od nejstarší. Druhá se týká tempa: zda je hromadné odeslání rozloženo v čase, aby nepřetížilo příjemce. Třetí se týká opakování: jak systém KD reaguje na odmítnuté hlášení, například po obnovení tokenu. Čtvrtá se týká přehledu: zda KD uvádí počet událostí odeslaných po výpadku.

  • odesílání po výpadku od nejstarší události
  • rozložení hromadného odeslání v čase
  • opakování odmítnutých hlášení po obnovení tokenu
  • přehled z KD o počtu událostí odeslaných po výpadku

Token s omezenou dobou platnosti

Integrace se ověřuje tokenem s omezenou dobou platnosti, který se obnovuje automaticky. Pokud výpadek trval dlouho, token použitý před přerušením mohl vypršet a první hlášení po obnovení linky budou odmítnuta, dokud se token neobnoví. Dobrá integrace se znovu přihlásí a odmítnutá hlášení zopakuje, zatímco špatná je ztratí bez stopy.

Proto je v akceptačním testu vhodné nasimulovat vypršení tokenu během odesílání série a ověřit, zda se počet hlášení na straně KD shoduje s počtem odbití přijatých v InnerWeb.

Jak sjednotit čísla po výpadku

Po každém výpadku tým IT porovnává dvě čísla: odbití zaznamenaná v KD v okně výpadku a odbití přijatá v InnerWeb po jeho skončení. Rozdíl ukazuje ztracená nebo jako duplicity odmítnutá hlášení. I nulový rozdíl je třeba potvrdit, protože ticho není důkazem zdraví.

Osoby, jejichž odbití dorazila se zpožděním, mohou mít v evidenci pracovní doby výjimky. Fronta výjimek v mRCP je umožní opravit a uzavřít a telefonická připomínka nenaskenovaného výstupu doplní mezeru.

Doporučení: specifikace jako základ

Pokud jsou zpoždění v závodě časté, je vhodné zapsat odesílání v reálném čase jako nadřazený požadavek do specifikace s dodavatelem KD a čas z čtečky, směr a identifikátor události jako povinná pole každého hlášení. Taková specifikace je součástí projektu integrace a základem akceptačního testu.

Videomateriál

Často kladené otázky

Jaká data má obsahovat hlášení odbití z KD?

Čas události z čtečky, směr (vstup nebo výstup) a identifikátor události. Hlášení přichází do InnerWeb přes ověřený webhook.

Co se stane s odbitími po výpadku linky?

Systém KD odešle uložené události po obnovení spojení, nejlépe od nejstarší, každou s vlastním časem z čtečky. Je vhodné porovnat počet odbití v KD a v InnerWeb.

Kdo určuje pravidla párování vstupů a výstupů a duplicit?

Tato pravidla se určují ve specifikaci integrace spolu s dodavatelem KD. Díky tomu hromadné odeslání po výpadku nezamění dvě skutečná odbití za opětovný sken.

Chcete otestovat odesílání po výpadku?

Domluvte si schůzku s týmem InnerWeb. Připravíme scénář testu hromadného odeslání a obnovení tokenu pro vašeho dodavatele KD.

Pojďme si promluvit