Jak integrace funguje a co InnerWeb nedělá
Bodem integrace se stávajícím systémem KD je webhook přiložení karty: systém KD odešle při každém přiložení požadavek HTTP POST. InnerWeb nevyrábí ani nevyměňuje čtečky. Je nezávislým systémem doplňujícím KD, RCP, HR a ERP. Pro IT to znamená, že bodem testů je dodavatel KD a jeho fronta odesílání, nikoli zařízení u brány.
Oznámení obsahuje čas události, místo přiložení a údaje osoby: jméno a příjmení (povinné), zkratku, firmu (název povinný), číslo aktivní karty, telefon, e-mail a jazyk.
Etapa 1: autentizace a obnova tokenu
Volání webhooku vyžaduje token JWT z přihlašovacího endpointu API. Jde o token s omezenou platností, který integrace obnovuje automaticky. Při několika směnách denně musí obnova fungovat bez zásahu člověka, i uprostřed směny. Tým IT by měl ověřit, zda systém KD obnovuje token před vypršením platnosti a co udělá po odpovědi, která požadavek odmítne.
Navrhovaný test: vynuťte obnovu tokenu v testovacím prostředí a sledujte, zda se přiložení z fronty systému KD neztrácejí. Zapište, kolik přiložení bude po obnově zopakováno.
Průměrné tempo přiložení podle doby začátku směny, příklad
Etapa 2: požadavky specifikace pro události z KD
Systém KD posílá události v reálném čase, s časem události načteným z čtečky, směrem (vstup nebo výstup) a identifikátorem události, a 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 s dodavatelem KD. Ve špičce to má význam: pokud systém KD sbírá přiložení ve frontě a odesílá je se zpožděním, v InnerWeb rozhoduje čas přiložení z čtečky, nikoli čas odeslání.
Identifikátor události odliší opakovaný požadavek od dalšího přiložení. Tým IT by se proto měl s dodavatelem KD dohodnout na pravidlech opakování, omezit je na situace bez potvrzení přijetí a popsat, jak se systém KD chová. Stavy typu začátek a konec práce nespadají do rozsahu této integrace.
Etapa 3: rozlišení bran a míst přiložení
Dodavatel KD, který přikládá karty na několika místech, je rozlišuje polem místa přiložení. Ve skladu s několika bránami, zámky a vstupy do zón je třeba dohodnout slovník názvů míst a udržovat ho stálý. Změna názvu brány v systému KD bez dohody způsobí rozjetí přehledů.
- Vypište všechna místa přiložení ze systému KD a jejich názvy.
- Dohodněte se s administrátorem InnerWeb na rozsahu míst, na která se vztahuje kontrola školení.
- Otestujte přiložení na každé bráně před špičkou.
Etapa 4: zátěžový test před sezónou
Při předpokladu 400 osob za 15 minut připadá v průměru 400 / 900 sekund, tedy přibližně 0,44 přiložení za sekundu, a v krátkodobé špičce mnohonásobně více. Jde o příkladovou kalkulaci. Test by měl tento vzorec napodobit: sérii požadavků ze systému KD s údaji několika stovek osob, včetně nových, systému neznámých. Sledujte zpoždění odpovědí, odmítnutí a počet založených účtů a firem.
Přiložení osoby neznámé systému založí účet a firmu, takže test s novými osobami ověří i jednotnost zápisu názvů agentur.
Co má tým IT mít připravené před první špičkou
Nejdůležitější jsou tři věci: postup obnovy tokenu, popis chování systému KD při absenci odpovědi a kontakt na administrátora InnerWeb na dobu špičky. Vhodné je také určit, kdo v IT sleduje bránu v prvních 30 minutách směny.
Videomateriál
Často kladené otázky
Jak funguje token pro webhook?
Je to token s omezenou platností, který integrace obnovuje automaticky, takže systém KD by jej měl obnovovat během směny.
Jaká data by měl systém KD posílat?
Události v reálném čase, 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í ve specifikaci s dodavatelem KD.
Jak InnerWeb pozná, která je to brána?
Z pole místa přiložení v oznámení. Názvy je třeba udržovat stálé.
Lze zátěžový test provést v produkci?
Doporučujeme testovací prostředí, protože test s novými osobami zakládá účty a firmy.
Otestujte integraci před sezónou
Domluvte si konzultaci s týmem IT. Projdeme token, frontu přiložení a slovník míst, než směna začne se stovkami karet.
Pojďme si promluvit