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
- Bez výpadku
- Po 3 h výpadku (hromadné odeslání)
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