InnerWeb
Zum Inhalt springen

Zutrittsdaten und Zeiterfassung: Spezifikation der Integration

InnerWeb liefert keine Leser und keine Karten. Die Buchungen übernimmt es aus dem Zutrittssystem des Kunden per Webhook und verbindet sie mit der Arbeitszeit und der Evakuierungsliste. Im Folgenden zeigen wir, was der Anbieter des Zutrittssystems übermitteln muss und was die IT vor dem Start prüft.

13 s
Aktualisierung der Evakuierungsliste
6
Gruppen auf der Evakuierungsliste

Umfang der Integration und ihre Grenzen

InnerWeb liefert keine Leser und keine Zutrittskarten. Die Buchungen übernimmt es aus dem Zutrittssystem des Kunden (Webhook) und verbindet sie mit Qualifikationen, Genehmigungen, Anwesenheit und Arbeitszeiterfassung, und dem Anbieter des Zutrittssystems wird die Spezifikation der Integration übergeben. Der Kunde tauscht also weder Leser noch Karten, und die vorhandene Infrastruktur bleibt an ihrem Platz.

Die Verantwortung ist klar abgegrenzt. Der Anbieter des Zutrittssystems verantwortet Leser, Karten und den Versand des Ereignisses, InnerWeb verantwortet den Empfang, die Zuordnung der Person und die Eintragung in die Erfassung. Wer ein fehlendes Buchungsereignis bemängelt, prüft zuerst, ob das Ereignis das Zutrittssystem verlassen hat.

Was der Anbieter des Zutrittssystems übermitteln muss

Die Spezifikation für den Anbieter des Zutrittssystems beschreibt den Mindestsatz an Daten eines Ereignisses. Das Ereignis muss die Person, den Zeitpunkt der Buchung und die Richtung des Durchgangs eindeutig angeben, denn daraus entstehen Eintritt und Austritt in der Erfassung. Das genaue Format der Felder wird aus der Spezifikation der Integration festgelegt, hier beschreiben wir die Logik, die die IT prüfen sollte.

Die Ereignisse werden per Webhook versendet, daher muss der Anbieter des Zutrittssystems ein erneutes Senden bei Nichterreichbarkeit des Empfängers sicherstellen sowie eine dauerhafte Identifikation der Person, etwa über eine Personalnummer, die dem Konto in InnerWeb entspricht.

  • Personenkennung, die der Personalnummer des Kontos entspricht.
  • Zeitpunkt der Buchung mit eindeutiger Zeitzone.
  • Richtung des Durchgangs: Eintritt oder Austritt.
  • Kennung des Tors oder der Zone, falls sie die Evakuierungsliste beeinflussen soll.
  • Erneutes Senden bei fehlender Antwort des Empfängers.

Was InnerWeb mit einer Buchung macht

Die Scans am Tor, die auch für die Evakuierungsliste verwendet werden, bilden die Arbeitszeiterfassung im Modul mRCP: Tagesansichten, Monatsansichten und Jahresansichten, eine Konsole des Teams für die Vorgesetzten, Warteschlangen für Ausnahmen, den Abschluss des Zeitraums und die Zeitkarten als PDF. Das Modul ist standardmäßig ausgeschaltet und wird über eine Einstellung aktiviert, daher ist die Integration der Buchungen eine eigene Entscheidung gegenüber der Inbetriebnahme des Moduls selbst.

Die Evakuierungsliste aktualisiert sich alle 13 Sekunden, entsteht aus den Scans am Tor und teilt die Personen in sechs Gruppen ein: Gäste, Kuriere, Lieferanten, Beschäftigte des Werks, externe Firmen mit Registerkarten je Firma sowie eine unsichere Gruppe. Der Ausdruck ist eine Seite pro Gruppe, damit der Einsatzleiter die Blätter an die Koordinatoren am Sammelpunkt verteilen kann.

Unsymmetrischer Fehler auf der Evakuierungsliste

Die Liste ist auf einen unsymmetrischen Fehler ausgelegt: Eine Person, die trotz Austritt auf der Liste steht, kostet unnötige Suche, eine übersehene Person ist dagegen jemand, den niemand sucht. Im Zweifel zeigt die Liste mehr Personen, nicht weniger. Für die Integration heißt das: Eine fehlende Buchung des Austritts entfernt die Person nicht von der Liste, daher sollte der Anbieter des Zutrittssystems die Vollständigkeit der Austrittsereignisse sicherstellen, damit die Liste nicht unnötig wächst.

Was die IT vor dem Start prüft

Die IT sollte fünf Dinge prüfen: die Erreichbarkeit der Empfängeradresse aus dem Netz des Zutrittssystems, die Übereinstimmung der Personenkennungen, die Zeitzone der Ereignisse, das Verhalten beim erneuten Senden und die Vollständigkeit der Austritte. Jeden dieser Punkte kann man mit einer Testgruppe von Personen vor der Aktivierung der Integration für das ganze Werk prüfen.

Der Test sollte mit einigen Personen aus verschiedenen Gruppen erfolgen und den vollständigen Zyklus durchlaufen: Eintritt, Austritt, Eintritt ohne Austritt und der Versuch eines doppelten Ereignisses. Das Ergebnis vergleicht man mit der Tagesansicht der Erfassung und mit der Evakuierungsliste.

Fallen und Verteilung der Verantwortung

Die erste Falle ist der Unterschied der Zeitzonen. Ein Ereignis, das in UTC gespeichert und als Ortszeit gelesen wird, verschiebt den Eintritt um eine oder zwei Stunden und verfälscht die Arbeitszeit. Die zweite ist eine Personenkennung im Zutrittssystem, die von der Kennung in InnerWeb abweicht, was in der Gruppe der unsicheren Personen endet. Die dritte ist das fehlende erneute Senden, durch das Ereignisse aus der Zeit der Nichterreichbarkeit des Empfängers verloren gehen.

Alle drei lassen sich vor dem Start mit einem Test erkennen. Der Anbieter des Zutrittssystems sollte eine Checkliste als Anlage zur Spezifikation erhalten, und das Werk sollte die Ergebnisse des Tests in der Dokumentation der Einführung festhalten.

Checkliste

Videomaterial

Häufig gestellte Fragen

Müssen die Leser des Zutrittssystems ausgetauscht werden?

Nein. InnerWeb liefert keine Leser und keine Karten, und die Buchungen werden aus dem vorhandenen Zutrittssystem des Kunden übernommen.

Was geschieht mit einer Person, der der Austritt im Zutrittssystem fehlt?

Die Evakuierungsliste ist auf einen unsymmetrischen Fehler ausgelegt: Im Zweifel zeigt sie mehr Personen, nicht weniger.

Schaltet sich mRCP automatisch ein?

Nein. Das Modul ist standardmäßig ausgeschaltet und wird über eine Einstellung aktiviert.

Sprechen wir über die Integration mit Ihrem Zutrittssystem

Wir übergeben dem Anbieter des Zutrittssystems die Spezifikation der Integration und gehen mit der IT-Abteilung den Test vor dem Start durch. Vereinbaren Sie ein Gespräch mit dem Team von InnerWeb.

Sprechen wir