InnerWeb
Přejít na obsah

Webhook přiložení karty: pole hlášení z KD

Dodavatel systému řízení přístupu, který posílá přiložení do InnerWeb, by měl v každém hlášení předat čas události, místo přiložení a údaje osoby a firmy. Dvě pole jsou povinná, ostatní rozhodují o kvalitě propojení karty s účtem. Níže je sedm doporučení pro integrátora, každé s odůvodněním.

2
povinná pole: jméno a příjmení a název firmy
3
vlastnosti každé události: čas z čtečky, směr, identifikátor
Zdroj: specifikace integrace

Pro koho je tento seznam

Seznam je určen integrátorovi nebo správci systému KD, který připravuje odesílání přiložení do InnerWeb. Předpokládá, že čtečky zůstávají beze změny a mění se jen to, co systém KD posílá po každém přiložení karty.

InnerWeb nevyrábí čtečky a nevyměňuje je, takže kvalita integrace závisí na datech v hlášení. Doporučení níže vycházejí z požadavků specifikace integrace, v níž InnerWeb přijímá a páruje události z KD.

Doporučení 1: vždy posílejte číslo aktivní karty

Číslo aktivní karty je identifikátor, podle kterého InnerWeb páruje přiložení s účtem osoby. Bez něj se systém musí opírat o jméno a příjmení, což zvyšuje riziko záměny u osob se stejnými údaji.

Odůvodnění pro nákup a IT: pole čísla karty je klíčem ke kontrole školení BOZP dřív, než brána osobu propustí. Průkaz, kvalifikace a školení jsou navázány na účet osoby a číslo karty z KD se stává klíčem k tomuto účtu.

Pole hlášení podle kategorií

Pole hlášení podle kategoriíRozdělení polí hlášení: 2 povinná, 3 identifikační a kontextová, 3 kontaktní a jazyková.Povinná: 2 pole (25%)Identifikace a kontext: 3 pole (37,5%)Kontakt a jazyk: 3 pole (37,5%)8polePovinná2 pole (25%)Identifikace a kontext3 pole (37,5%)Kontakt a jazyk3 pole (37,5%)
Zdroj: čas, místo, jméno a příjmení, název firmy (povinné), akronym, číslo karty, telefon, e-mail, jazyk

Doporučení 2: jméno a příjmení jako povinné pole

Jméno a příjmení jsou v hlášení povinné. Hlášení bez nich nemůže založit účet ani přiřadit přiložení nové osobě. Dodavatel by je proto měl posílat ve stejné podobě, v jaké jsou v evidenci KD, bez zkratek a bez doplňků typu název agentury.

Doporučeno je také pole akronymu, pokud jej evidence KD vede. Pomáhá rozlišit osoby se stejnými údaji.

Doporučení 3: název firmy v jednotném pravopisu

Název firmy je povinný a externí firma se přiřazuje podle názvu v hlášení. Přiložení karty osoby, kterou systém nezná, založí účet a firmu z údajů v hlášení, takže dva způsoby zápisu téže firmy vytvoří dvě firmy.

Doporučení pro integrátora: posílat název firmy z jednoho číselníkového pole v KD, ne z volného textového pole. Pokud takové pole neexistuje, je třeba s správcem KD dohodnout jednu závaznou podobu zápisu.

Doporučení 4: místo přiložení z pevného číselníku

Pole místa přiložení rozlišuje lokality čteček. Události z místa, které nemá v InnerWeb šablonu, se zapisují do logu a nespouštějí školicí poplach. Integrátor by proto měl předat seznam všech názvů míst z KD a tým BOZP jim přiřadí šablony.

Název místa musí být stabilní. Změna názvu čtečky v KD bez informace pro InnerWeb způsobí, že události znovu skončí na místě bez šablony.

Doporučení 5: čas události a odesílání v reálném čase

Specifikace integrace vyžaduje, aby systém KD odesílal události v reálném čase s časem události přečteným z čtečky, nikoli s okamžikem odeslání. Díky tomu evidence vstupů odpovídá tomu, co se skutečně stalo u brány.

Fronta událostí po výpadku linky by měla být vyprázdněna co nejdříve se zachováním původních časů událostí a integrátor by měl zdokumentovat, jaké zpoždění je ve svém systému přijatelné.

Při výběru polí je také užitečné sepsat, která z nich evidence KD vyplňuje automaticky a která vyžadují ruční doplnění správcem. Takový přehled zkrátí jednání s dodavatelem a umožní hned odhalit pole, která systém KD vůbec nevede.

Doporučení 6: telefon, e-mail a jazyk jen tehdy, jsou-li jisté

Telefon, e-mail a jazyk jsou v hlášení doplňková pole. Posílejte je jen tehdy, pokud je evidence KD obsahuje a jsou aktuální, protože chybné kontaktní údaje zadané u nového účtu se později hledají obtížně. Zejména pole jazyka je vhodné vyplňovat u cizinců, protože ovlivňuje verzi školení.

Doporučení 7: ověření a řešení vypršení tokenu

Volání webhooku vyžaduje token z přihlašovacího endpointu API. Token má omezenou dobu platnosti a integrace jej obnovuje automaticky. Integrátor by měl přihlášení opakovat a odmítnuté hlášení znovu odeslat, nikoli je ztratit.

Hlášení by mělo obsahovat směr (vstup nebo výstup) a identifikátor události. Pravidla párování vstupů a výstupů a odmítání duplicit se určují ve specifikaci s dodavatelem KD, proto je zdvojování odesílání nevhodné.

Videomateriál

Často kladené otázky

Která pole jsou v hlášení přiložení povinná?

Jméno a příjmení a název firmy. Ostatní pole, včetně čísla aktivní karty, zlepšují kvalitu propojení přiložení s účtem.

Používá InnerWeb čas z čtečky?

Ano, specifikace počítá s časem události z čtečky a odesíláním v reálném čase, spolu se směrem a identifikátorem události.

Co se stane, když bude název firmy zapsán různě?

Systém založí samostatné firmy pro každý způsob zápisu. Název je nejlepší brát z jednoho číselníku v KD.

Jste integrátor KD?

Ozvěte se nám a předáme vám specifikaci webhooku přiložení karty a dohodneme rozsah polí pro váš systém.

Pojďme si promluvit