Ausgangslage: Leser sind vorhanden, Daten fehlen in der Zeiterfassung
Das Werk betreibt ein funktionierendes Zutrittskontrollsystem mit Lesern an den Toren und Zugängen zur Produktion. Die Personalabteilung braucht Daten über Kommen und Gehen für die Abrechnung der Arbeitszeit, doch die Buchungen bleiben im KD-System und erreichen die Zeiterfassung nicht. Jeden Monat werden die Stunden deshalb von Hand nachgetragen.
Ein Austausch der Leser oder Controller hätte Kosten, Stillstand an den Toren und monatelange Verhandlungen mit dem Anbieter bedeutet. Das Werk entschied sich für einen Weg, bei dem die Leser bleiben und nur verändert wird, was das KD-System weiter übermittelt.
Lösung: InnerWeb nimmt Ereignisse aus dem KD-System entgegen
InnerWeb stellt keine Leser oder Zutrittskarten her und tauscht sie nicht aus. Das System empfängt die Kartenbuchungen aus dem KD-System über einen Webhook und verknüpft sie mit Qualifikationen, Freigaben, Anwesenheit und der Zeiterfassung. Dies ist das Einführungsmuster beim Verpackungshersteller: Integration der Kartenbuchungen aus dem KD-System in die Zeiterfassung nach einer Spezifikation für den KD-Anbieter.
Die Spezifikation legt fest, welche Felder jedes Ereignis enthält, in welchem Format es gesendet wird und wie oft. Der KD-Anbieter arbeitet auf seiner Seite, und das Team des Werks muss die internen Tabellen des Zutrittssystems nicht kennen.
Was in die Spezifikation für den KD-Anbieter gehört
Die Spezifikation ist kurz und konkret, weil der KD-Anbieter sie in der bestehenden Software umsetzen soll.
- Kennung der Karte oder des Mitarbeiterkontos in einer zwischen den Systemen abgestimmten Form.
- Kennung des Lesers, die einem im System definierten Ort entspricht.
- Zeitpunkt des Ereignisses am Leser mit Zeitzone.
- Durchgangsrichtung (Eingang oder Ausgang) und die vom KD-System vergebene Ereigniskennung.
- Wiederholung beim Versand, wenn der Empfang vorübergehend ausfällt, und Authentifizierung des Webhooks mit einem Token mit begrenzter Gültigkeit, das die Integration automatisch erneuert.
Beispielhafte Parameter der Buchungspaarung in der Spezifikation
Worauf bei der Prüfung der Daten zu achten ist
Der Import der Konten aus dem KD-System ersetzt kein Buchungsregister: Der Verlauf von Kommen und Gehen erfordert eine eigene Ereignisspezifikation, in der das KD-System jede Buchung als eigenes Ereignis in Echtzeit sendet.
Die zweite Falle betrifft den Ort. Eine Buchung von einem Leser ohne zugeordneten Ort, also ohne Aktionspunkt, löst keinen Schulungsalarm aus. Die Konfiguration der Leser muss den Orten im System entsprechen, sonst kommt das Ereignis zwar an, bleibt aber ohne Wirkung.
Der dritte Punkt ist der Inhalt des Ereignisses. Die Spezifikation verlangt, dass das KD-System Zeitpunkt am Leser, Richtung (Eingang oder Ausgang) und Ereigniskennung übermittelt. Die Regeln für die Paarung von Ein- und Ausgängen sowie für das Verwerfen von Dubletten werden zusammen mit dem KD-Anbieter festgelegt, zum Beispiel ein Paarungsfenster von 13 Stunden und eine Dublette bei einem Abstand unter 180 Sekunden. Wir beschreiben sie auf einer eigenen Seite mit Umsetzungshinweisen für den Webhook der Buchungen.
Rolle der Personalabteilung und des KD-Integrators
Die Personalabteilung legt fest, was in der Zeiterfassung erscheinen soll: den Umfang der Stunden, die Rundungsregeln und die Kennzeichnung fehlender Buchungen. Der Integrator des KD-Systems liefert die Ereignisse im abgestimmten Format. InnerWeb übernimmt auf seiner Seite den Empfang, die Verknüpfung mit dem Konto und die Ansicht für berechtigte Personen.
Die Aufteilung ist klar: Leser und Karten sind Sache des KD-Anbieters, die Regeln der Erfassung sind Sache der Personalabteilung, und die Verbindung der Daten ist eine gemeinsame Aufgabe, die in der Spezifikation beschrieben ist. So verändert keine der Seiten das System der anderen.
Schlussfolgerungen für ein ähnliches Werk
Prüfen Sie zuerst, was das KD-System tatsächlich speichert: ein vollständiges Journal mit Richtung oder nur die letzte Anmeldung. Beschreiben Sie danach die Felder des Ereignisses und senden Sie die Spezifikation an den KD-Anbieter zusammen mit der Bitte um einen Umsetzungstermin. Prüfen Sie abschließend, ob jeder Leser im System einen Ort zugeordnet hat.
Diese Reihenfolge erlaubt es, die Integration ohne Austausch der Hardware zu starten. Entscheidet sich das Werk später für einen neuen Kartentyp, etwa DESFire, bleibt die Freigabelogik in InnerWeb unverändert.
Was vor dem Start der Integration zu prüfen ist
Bevor Sie die Spezifikation an den KD-Anbieter senden, prüfen Sie drei Punkte. Erstens, ob das KD-System ein vollständiges Journal der Buchungen führt oder nur die letzte Anmeldung eines Kontos. Zweitens, ob die Kennung des Kontos im KD-System mit der Kennung im Freigabesystem übereinstimmt. Drittens, ob das Netzwerkteam des Werks ausgehenden Verkehr vom Server zulässt, denn bei einer Sperre muss ein anderer Empfangsweg und die Zwischenspeicherung der Ereignisse auf Seiten des KD-Systems vereinbart werden.
Diese Liste nimmt eine Besprechung mit dem KD-Anbieter in Anspruch und verkürzt spätere Korrekturen. Sie erfordert keine Änderungen an den Lesern und keine Änderungen an der Software des KD-Systems außer dem Versand der Ereignisse nach der Spezifikation.
Videomaterial
Häufig gestellte Fragen
Müssen für die Integration die Leser des KD-Systems ausgetauscht werden?
Nein. Das Muster sieht eine Integration nach einer Spezifikation für den KD-Anbieter vor, ohne Leser von InnerWeb und ohne Austausch der vorhandenen Leser.
Was ist, wenn der Import der Konten aus dem KD-System nur die letzte Anmeldung zeigt?
Dann ist eine eigene Spezifikation der Buchungsereignisse nötig. Die letzte Anmeldung ersetzt kein Register der Kommen- und Gehen-Buchungen mit Richtung.
Warum hat eine Buchung am Leser keinen Schulungsalarm ausgelöst?
Meist hat der Leser im System keinen zugeordneten Ort, also keinen Aktionspunkt. Die Konfiguration der Leser muss den Orten entsprechen.
Möchten Sie KD und Zeiterfassung ohne Austausch der Leser verbinden?
Wir erarbeiten mit Ihnen die Spezifikation der Ereignisse für den KD-Anbieter und zeigen, wie die Buchungen in die Erfassung gelangen. Vereinbaren Sie ein Gespräch.
Sprechen wir