InnerWeb
Zum Inhalt springen

Ereigniszeit im Zutritts-Webhook: Verzögerungen und Massenversand

Die Integration mit dem Zutrittssystem beruht auf Ereignissen, die in Echtzeit mit der Zeit vom Leser, der Richtung und einer Ereigniskennung gesendet werden. Solange die Leitung funktioniert, decken sich Zeit am Leser und Zeit des Versands nahezu. Nach einem Leitungsausfall sendet das Zutrittssystem oft zwischengespeicherte Buchungen als Massenversand, daher sollten die Regeln des Versands mit dem Anbieter vereinbart werden. Im Folgenden die Hinweise für die IT.

2.000
Buchungen pro Werktag in einem großen Werk, Umfang einer Serie nach einem Ausfall
4
Festlegungen mit dem Anbieter für den Versand nach einem Ausfall
Quelle: Spezifikation der Integration

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

Beispielrechnung: Buchungen pro Viertelstunde nach einem AusfallLiniendiagramm: normal 25 Buchungen pro Viertelstunde, nach dreistündigem Ausfall sendet das Zutrittssystem im ersten Viertel 250 Buchungen auf einmal.050100150200250Buchungen0–15 Min.15–30 Min.30–45 Min.45–60 Min.Ohne Ausfall (0–15 Min.): 25 Buchungen25Ohne Ausfall (15–30 Min.): 25 Buchungen25Ohne Ausfall (30–45 Min.): 25 Buchungen25Ohne Ausfall (45–60 Min.): 25 Buchungen25Nach 3 h Ausfall (Massenversand) (0–15 Min.): 250 Buchungen250Nach 3 h Ausfall (Massenversand) (15–30 Min.): 25 Buchungen25Nach 3 h Ausfall (Massenversand) (30–45 Min.): 25 Buchungen25Nach 3 h Ausfall (Massenversand) (45–60 Min.): 25 Buchungen25
  • Ohne Ausfall
  • Nach 3 h Ausfall (Massenversand)
Quelle: Beispielrechnung: Annahme zur Veranschaulichung 100 Buchungen pro Stunde tagsüber und 3 zwischengespeicherte Stunden ( nennt einen Tageswert über 2.000).

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