Anforderung: Zeit des Ereignisses vom Leser
Die Spezifikation der Integration sieht vor, dass das Zutrittssystem jede Kartenbuchung in Echtzeit sendet und die Zeit des Ereignisses am Leser, die Richtung (Eingang oder Ausgang) und die Ereigniskennung mitliefert. InnerWeb nimmt sie über einen authentifizierten Webhook entgegen. Die Regeln für das Paaren von Eingängen und Ausgängen sowie für das Verwerfen von Dubletten werden zusammen mit dem Anbieter in der Spezifikation festgelegt und nicht vorab angenommen.
Der praktische Grund ist einfach: Eine Buchung um 5:58 Uhr sollte in der Erfassung die Uhrzeit 5:58 tragen, auch wenn sie erst um 6:20 Uhr ankommt. Für den Schulungsalarm macht der Unterschied meist keine Rolle, für die Zeiterfassung und die Evakuierungsliste ist er aber wichtig, deshalb ist die Zeit des Lesers die Grundlage jedes Ereignisses.
Szenario: Leitungsausfall und Massenversand
Nach einem Leitungsausfall puffert das Zutrittssystem Ereignisse häufig und sendet sie nach der Wiederherstellung der Verbindung in einem Zug. Für den Empfänger sieht das aus wie ein plötzlicher Anstieg des Verkehrs. In einem Werk mit vielen Zeitarbeitsfirmen kann der Verkehr 2.000 Buchungen pro Werktag überschreiten, daher kann eine Serie nach einem Ausfall groß sein.
Aus diesem Szenario ergeben sich zwei Anforderungen an die Spezifikation. Erstens trägt jedes Ereignis seine eigene Zeit am Leser und seine Kennung, damit eine Serie zwischengespeicherter Buchungen die richtige Reihenfolge behält. Zweitens müssen die Regeln für das Verwerfen von Dubletten so beschrieben werden, dass zwei echte Buchungen derselben Person, die nacheinander in einer Serie gesendet werden, nicht mit einem erneuten Scan verwechselt werden. Die genauen Regeln werden mit dem Anbieter des Zutrittssystems festgelegt.
Beispielrechnung: Buchungen pro Viertelstunde nach einem Ausfall
- Ohne Ausfall
- Nach 3 h Ausfall (Massenversand)
Was mit dem Anbieter des Zutrittssystems zu klären ist
Die Festlegungen sollten in der Spezifikation der Integration und im Abnahmeprotokoll festgehalten werden. Es geht darum, dass auf Seiten des Zutrittssystems klar ist, wie sich der Versand im Störfall verhält.
Die erste Frage betrifft die Reihenfolge: Werden die Ereignisse nach einem Ausfall in zeitlicher Reihenfolge gesendet, vom ältesten an. Die zweite betrifft das Tempo: Ist der Massenversand über die Zeit verteilt, damit der Empfänger nicht überlastet wird. Die dritte betrifft die Wiederholungen: Wie reagiert das Zutrittssystem auf eine abgewiesene Meldung, etwa nach der Erneuerung des Tokens. Die vierte betrifft den Bericht: Weist das Zutrittssystem aus, wie viele Ereignisse nach dem Ausfall gesendet wurden.
- Versand nach dem Ausfall vom ältesten Ereignis an
- Verteilung des Massenversands über die Zeit
- Wiederholung abgewiesener Meldungen nach Erneuerung des Tokens
- Bericht des Zutrittssystems über die Zahl der Ereignisse nach dem Ausfall
Token mit begrenzter Gültigkeit
Die Integration authentifiziert sich mit einem Token, der zeitlich begrenzt gültig ist und automatisch erneuert wird. Hat der Ausfall lange gedauert, kann der vor der Unterbrechung verwendete Token abgelaufen sein, und die ersten Meldungen nach der Wiederherstellung werden bis zur Erneuerung abgewiesen. Eine gute Integration meldet sich erneut an und wiederholt die abgewiesenen Meldungen, eine schlechte verwirft sie spurlos.
Simulieren Sie deshalb im Abnahmetest, wie der Token während des Versands einer Serie abläuft, und prüfen Sie, ob die Zahl der Meldungen auf Seiten des Zutrittssystems mit der Zahl der in InnerWeb angenommenen Buchungen übereinstimmt.
So gleichen Sie die Zahlen nach einem Ausfall ab
Nach jedem Ausfall vergleicht das IT-Team zwei Zahlen: die im Zutrittssystem im Zeitraum des Ausfalls erfassten Buchungen und die nach dessen Ende in InnerWeb angenommenen Buchungen. Eine Differenz zeigt verlorene oder als Dubletten verworfene Meldungen. Auch eine fehlende Differenz muss bestätigt werden, denn Stille ist kein Beleg für einen gesunden Zustand.
Bei Personen, deren Buchungen verspätet eingingen, können in der Zeiterfassung Ausnahmen entstehen. Die Warteschlange der Ausnahmen in der mRCP ermöglicht es, sie zu korrigieren und zu schließen, und der Erinnerungsanruf bei nicht gescanntem Ausgang schließt die Lücke.
Empfehlung: Spezifikation als Grundlage
Treten Verzögerungen im Werk häufig auf, sollten Sie den Versand in Echtzeit als übergeordnete Anforderung in der Spezifikation mit dem Anbieter festhalten und Zeit am Leser, Richtung und Ereigniskennung als Pflichtfelder jeder Meldung vorgeben. Eine solche Spezifikation ist Teil des Integrationsprojekts und Grundlage des Abnahmetests.
Videomaterial
Häufig gestellte Fragen
Welche Daten sollte eine Meldung aus der Zutrittskontrolle enthalten?
Die Zeit des Ereignisses am Leser, die Richtung (Eingang oder Ausgang) und die Ereigniskennung. Die Meldung gelangt über einen authentifizierten Webhook zu InnerWeb.
Was geschieht mit den Buchungen nach einem Leitungsausfall?
Das Zutrittssystem sendet die zwischengespeicherten Ereignisse nach Wiederherstellung der Verbindung, am besten vom ältesten an, jeweils mit eigener Zeit am Leser. Es empfiehlt sich, die Zahl der Buchungen in der Zutrittskontrolle und in InnerWeb zu vergleichen.
Wer legt die Regeln für das Paaren von Ein- und Ausgängen und für Dubletten fest?
Diese Regeln werden in der Spezifikation der Integration zusammen mit dem Anbieter des Zutrittssystems festgelegt. So verwechselt der Massenversand nach einem Ausfall keine zwei echten Buchungen mit einem erneuten Scan.
Möchten Sie den Versand nach einem Ausfall testen?
Vereinbaren Sie ein Gespräch mit dem Team von InnerWeb. Wir bereiten für Ihren Anbieter der Zutrittskontrolle ein Testszenario für den Massenversand und die Erneuerung des Tokens vor.
Sprechen wir