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í
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