Für wen und wozu diese Beschreibung
Die Empfehlungen richten sich an die IT- oder OT-Abteilung und an den Integrator, der mit dem Anbieter des ZK-Systems spricht. InnerWeb stellt keine Zutrittsleser her und tauscht sie nicht aus: Es wird als unabhängiges ergänzendes System neben ZK, Zeiterfassung, Personalwesen und ERP an das bestehende ZK-System des Kunden angebunden. Deshalb hängt die Datenqualität davon ab, wie genau Zonen und Leser auf Seiten des ZK-Systems beschrieben sind.
Eine gute Beschreibung einer Zeitzone beantwortet vier Fragen: wer, wo, wann und in welche Richtung. Fehlt die Antwort auf die letzte Frage, ist das die häufigste Ursache für Probleme mit den Berichten.
Empfehlung 1: Richtung an jedem Leser
Die Regeln für Zeitzonen und Schichtpläne verlangen, dass Leser in beiden Richtungen eines Übergangs melden, ob Eintritt oder Austritt erfolgt. Ohne das hat Anti-Passback keine Grundlage, und der Bericht unterscheidet einen verspäteten Eintritt nicht von einem Austritt vor Schichtende.
In der Bestellung beim Anbieter sollte jeder Übergang mit einem eigenen Eintrittsleser und einem eigenen Austrittsleser aufgeführt werden. Bedient ein Leser beide Richtungen, muss geklärt werden, wie der Controller die Richtung unterscheidet, und das ist in der Spezifikation festzuhalten.
Beispielhafte Erneuerungen des Tokens am Tag
Empfehlung 2: stabile Bezeichnungen der Buchungsorte
Das Feld des Buchungsorts unterscheidet die Standorte der Leser. Ereignisse von einem Ort, dem in InnerWeb keine passende Vorlage entspricht, landen im Protokoll und lösen keinen Schulungsalarm aus. Deshalb sollten die Bezeichnungen fest, eindeutig und mit dem Team abgestimmt sein, das InnerWeb konfiguriert.
Eine Umbenennung des Lesers auf Seiten des ZK-Systems ohne Information an InnerWeb ist einer der häufigsten Gründe, warum Buchungen aufhören, Regeln auszulösen. Wir empfehlen ein Änderungsregister für Namen, das die IT-Abteilung führt.
Empfehlung 3: Authentifizierung und Erneuerung des Tokens
Der Aufruf des Webhooks erfordert ein Token vom Anmeldeendpunkt der API. Das Token hat eine begrenzte Gültigkeit und wird von der Integration automatisch erneuert, daher sind auf Seiten des ZK-Systems keine manuellen Schritte nötig. Wir empfehlen, dass die Integration das Token mit Reserve erneuert und nicht erst nach einer Ablehnung.
Im Überwachungssystem der IT lohnt sich ein Alarm bei einer Serie ablehnender Antworten des Endpunkts, damit ein Problem mit der Authentifizierung sichtbar wird, bevor es die Nachtschicht trifft.
Empfehlung 4: Robustheit gegenüber Ereignisserien und Wiederholungen
In einem Werk mit mehreren Zeitarbeitsagenturen kann der Kartenverkehr 2 000 Buchungen an einem Werktag überschreiten, und der größte Teil fällt auf die wenigen Minuten vor Schichtbeginn. Der Webhook muss gegenüber Ereignisserien und Wiederholungen robust sein.
Auf Seiten des ZK-Systems empfehlen wir eine Warteschlange mit erneutem Senden, auf Seiten des Empfängers das Verwerfen von Wiederholungen. Beim doppelten Scan eines Codes an der Registrierungsstation ignoriert InnerWeb den zweiten Scan innerhalb von 5 Sekunden, doch das ist ein anderer Weg als der Webhook der Karte im ZK-System. Die Regeln gegen Dubletten sind daher separat mit dem ZK-Anbieter in der Spezifikation abzustimmen.
Anforderungen an die Ereignisse aus dem ZK-System
In der Spezifikation der Integration gehen wir davon aus, dass das ZK-System Ereignisse in Echtzeit sendet. Jedes Ereignis enthält die Zeit des Lesers, die Richtung (Eintritt oder Austritt), den Buchungsort und die Ereigniskennung. InnerWeb nimmt sie über einen authentifizierten Webhook an, und die Buchungen speisen die Zeiterfassung und die Anwesenheitslisten.
Die Regeln für das Zuordnen von Eintritten und Austritten sowie für das Verwerfen von Dubletten werden in der Spezifikation zusammen mit dem ZK-Anbieter festgelegt. So wissen beide Seiten, welche Zeit verbindlich ist, wie ein fehlender Austritt zu behandeln ist und was mit einem nach erneutem Senden wiederholten Ereignis geschieht.
Eine Kartenbuchung im ZK-System sagt nur, dass die Person den Punkt passiert hat. Wo sie danach ist, zeigen die Position auf der Karte und die Evakuierungsliste in InnerWeb, daher ist diese Information nicht vom ZK-System allein zu erwarten.
Falls ein Leser im ZK-System des Kunden die Richtung nicht unterscheidet, ist das ein technischer Befund auf Seiten des ZK-Systems. Dann ist mit dem Anbieter zu klären, wie der Controller die Richtung angibt, und dies in der Spezifikation festzuhalten, bevor die Integration startet.
Die Service-Level-Parameter, also Verfügbarkeit, Reaktionszeiten und Reparaturzeiten, werden im Wartungsvertrag festgelegt, zum Beispiel Verfügbarkeit von 99,5 Prozent im Monat. Wir empfehlen, sie vor dem Start der Integration zu beschreiben, zusammen mit der verantwortlichen Person der IT-Abteilung.
Prüfliste für den Anbieter
Die folgenden Punkte sollten dem Anbieter des ZK-Systems als Anlage zur Bestellung übermittelt werden.
- Richtung Eintritt oder Austritt an jedem Leser
- Feste, eindeutige Bezeichnungen der Buchungsorte
- Format des Ereignisses mit den Feldern Zeit des Lesers, Richtung, Karte, Ort und Ereigniskennung
- Token mit begrenzter Gültigkeit, automatisch durch die Integration erneuert
- Warteschlange und erneutes Senden bei fehlender Antwort
- Regeln für das Zuordnen von Eintritten und Austritten sowie für das Verwerfen von Dubletten
- Änderungsregister für die Namen der Leser
Videomaterial
Häufig gestellte Fragen
Wer konfiguriert die Zeitzonen?
Zeitzonen und Zeitpläne werden im ZK-System des Kunden eingerichtet. InnerWeb nimmt Buchungen über den Webhook an und verändert die Konfiguration der Controller nicht.
Was passiert mit einer Buchung von einem unbekannten Ort?
Ein Ereignis von einem Ort ohne Vorlage in InnerWeb landet im Protokoll und löst keinen Schulungsalarm aus.
Überträgt der Webhook die Richtung des Übergangs?
Gemäß der Spezifikation der Integration sendet das ZK-System Ereignisse mit Zeit des Lesers, Richtung Eintritt oder Austritt und Ereigniskennung. Die Regeln für das Zuordnen und das Verwerfen von Dubletten werden mit dem ZK-Anbieter festgelegt.
Quellen
Bereiten wir die Spezifikation für den ZK-Anbieter vor
Wir gehen mit Ihrer IT-Abteilung das Format der Buchungen, die Bezeichnungen der Orte und die Erneuerung des Tokens durch, bevor der Anbieter mit der Konfiguration beginnt.
Sprechen wir