Pro koho a proč tento popis
Doporučení jsou určena IT nebo OT oddělení a integrátorovi, který komunikuje s dodavatelem systému KD. InnerWeb nevyrábí ani nevyměňuje čtečky kontroly přístupu: integruje se se stávajícím systémem KD zákazníka jako nezávislý doplňkový systém vedle KD, docházky, HR a ERP. Kvalita dat proto závisí na tom, jak přesně jsou pásma a čtečky popsány na straně KD.
Dobrý popis časového pásma odpovídá na čtyři otázky: kdo, kde, kdy a kterým směrem. Chybějící odpověď na poslední otázku je nejčastější příčinou problémů s hlášeními.
Doporučení 1: směr na každé čtečce
Pravidla časových pásem a plánů směn vyžadují, aby čtečky v obou směrech průchodu hlásily směr vstup nebo výstup. Bez toho nemá anti-passback na čem fungovat a hlášení nerozliší opožděný vstup od odchodu před koncem směny.
V objednávce pro dodavatele je třeba uvést každý průchod se samostatnou vstupní a výstupní čtečkou. Pokud jedna brána má jednu čtečku pro oba směry, je třeba zjistit, jak řadič směr rozlišuje, a zapsat to do specifikace.
Ukázková obnovení tokenu za den
Doporučení 2: stabilní názvy míst přiložení
Pole místa přiložení rozlišuje umístění čteček. Události z místa, které nemá v InnerWeb odpovídající šablonu, putují do logu a nespouštějí školicí upozornění. Názvy míst by proto měly být stálé, jedinečné a dohodnuté s týmem, který konfiguruje InnerWeb.
Změna názvu čtečky na straně KD bez informace pro InnerWeb je jednou z nejčastějších příčin, proč přiložení přestanou spouštět pravidla. Doporučujeme, aby IT oddělení vedlo rejstřík změn názvů.
Doporučení 3: ověření a obnova tokenu
Volání webhooku vyžaduje token z přihlašovacího endpointu API. Token má omezenou platnost a integrace jej obnovuje automaticky, takže na straně KD nejsou potřeba ruční úkony. Doporučujeme, aby integrace token obnovovala s rezervou, a ne až po odmítnutí.
Stojí za to nastavit v monitoringu IT upozornění na sérii odmítavých odpovědí z endpointu, aby problém s ověřením byl vidět dříve, než zasáhne noční směnu.
Doporučení 4: odolnost vůči sériím a opakování
V závodě s více agenturami práce může kartový provoz přesáhnout 2 000 přiložení za pracovní den a většina z nich připadá na několik minut před začátkem směny. Webhook musí být odolný vůči sériím událostí a opakování.
Na straně KD doporučujeme frontu s opakováním a na straně příjemce odmítání duplicit. U dvojitého skenu kódu na registrační stanici InnerWeb ignoruje druhý sken do 5 sekund, ale jde o jinou cestu než webhook karty KD, takže pravidla proti duplicitám je třeba dohodnout samostatně ve specifikaci s dodavatelem KD.
Požadavky na události z KD
Ve specifikaci integrace předpokládáme, že systém KD posílá události v reálném čase. Každá událost nese čas z čtečky, směr (vstup nebo výstup), místo přiložení a identifikátor události. InnerWeb je přijímá přes ověřený webhook a přiložení pak napájejí evidenci pracovní doby a seznamy přítomných.
Pravidla párování vstupů a výstupů a odmítání duplicit se určují ve specifikaci spolu s dodavatelem KD. Obě strany tak vědí, který čas je závazný, jak zacházet s chybějícím výstupem a co udělat s opakovaně odeslanou událostí po novém pokusu.
Přiložení karty v KD říká pouze to, že osoba prošla bodem. Kde se nachází po průchodu, ukazuje poloha na mapě a seznam pro evakuaci v InnerWeb, takže tuto informaci nelze očekávat od samotného KD.
Pokud některá čtečka v systému KD zákazníka nerozlišuje směr, jde o technický fakt na straně KD. Je třeba zjistit s dodavatelem, jak řadič směr určuje, a zapsat to do specifikace dříve, než integrace začne.
Parametry SLA, tedy dostupnost, doby reakce a opravy, se určují v údržbové smlouvě, například dostupnost 99,5 % v měsíci. Doporučujeme je popsat před spuštěním integrace spolu s odpovědnou osobou na straně IT oddělení.
Kontrolní seznam pro dodavatele
Následující body je vhodné zaslat dodavateli KD jako přílohu objednávky.
- Směr vstup nebo výstup na každé čtečce
- Stálé, jedinečné názvy míst přiložení
- Formát události s poli času z čtečky, směru, karty, místa a identifikátoru události
- Token s omezenou platností, který integrace obnovuje automaticky
- Fronta a opakování při nedostupnosti odpovědi
- Pravidla párování vstupů a výstupů a odmítání duplicit
- Rejstřík změn názvů čteček
Videomateriál
Často kladené otázky
Kdo nastavuje časová pásma?
Časová pásma a plány se nastavují v systému KD zákazníka. InnerWeb přijímá přiložení webhookem a nemění konfiguraci řadičů.
Co se stane s přiložením z neznámého místa?
Událost z místa bez šablony v InnerWeb putuje do logu a nespouští školicí upozornění.
Přenáší webhook směr průchodu?
Podle specifikace integrace systém KD posílá události s časem z čtečky, směrem vstup nebo výstup a identifikátorem události. Pravidla párování a odmítání duplicit se určují s dodavatelem KD.
Zdroje
Připravme specifikaci pro dodavatele KD
Projdeme s vaším IT oddělením formát přiložení, názvy míst a obnovu tokenu dříve, než dodavatel zahájí konfiguraci.
Pojďme si promluvit