Support Hub/API & Integrations/So behandeln Sie doppelte und außer der Reihenfolge…
Translated from the English article and reviewed by a person. Read the English original
Developer

So behandeln Sie doppelte und außer der Reihenfolge eingehende Stempelereignisse

So behandeln Sie doppelte und außer der Reihenfolge eingehende Stempelereignisse

 

Biometrische Echtzeit-Zeiterfassung klingt einfach: Eine Person scannt, Ihr System empfängt ein Ereignis und speichert es. In der Praxis sind Anwesenheitsdaten unübersichtlicher. Dasselbe Ereignis kann zweimal eintreffen. Ein Mitarbeiter kann den Scanner zweimal hintereinander antippen. Ein Gerät, das die Verbindung verloren hat, kann einen morgendlichen Check-out erst am Nachmittag senden. Jemand kann die falsche Check-in-Taste drücken. Wenn Ihr System jedes Ereignis genau so speichert, wie es eintrifft, führen diese kleinen Probleme zu falschen Arbeitszeiten, Streitigkeiten bei der Lohnabrechnung und Berichten, denen niemand vertraut. Dieser Leitfaden erklärt die verschiedenen Arten doppelter und außer der Reihenfolge eingehender Stempelereignisse, ihre Ursachen und eine klare Reihe von Regeln, die auf OperationID und LogTime aufbauen und Ihre Anwesenheitsdaten sauber halten.

01 · Das Problem

Warum saubere Anwesenheitsdaten schwieriger sind, als sie scheinen

Anwesenheitsereignisse stammen von physischen Geräten, die über verschiedene Standorte verteilt sind, von echten Menschen benutzt werden und über Netzwerke verbunden sind, die zeitweise ausfallen. Jede dieser Tatsachen schafft eine Möglichkeit, dass die Daten unvollständig oder fehlerhaft ankommen. Keine davon ist ein Fehler des biometrischen Systems. Sie entstehen einfach dort, wo die physische Welt auf Software trifft.

Die gute Nachricht ist, dass jedes Stempelereignis von Cams Biometrics Gateway die Informationen enthält, die Sie zum Bereinigen benötigen. Zwei Felder leisten dabei den Großteil der Arbeit:

Feld Was es ist Was es ermöglicht
OperationID Eine eindeutige Referenz für jedes Ereignis, das das Gateway sendet Dasselbe Ereignis erkennen, wenn es mehr als einmal eintrifft
LogTime Die tatsächliche Scan-Zeit der Person, mit dem Zeitzonen-Offset des Geräts Ereignisse in der tatsächlichen Reihenfolge ihres Auftretens einordnen, unabhängig davon, wann sie eintreffen

Drei weitere Felder helfen bei den schwierigeren Fällen: UserId identifiziert die Person, SerialNumber identifiziert das Gerät, und Type gibt an, ob die Person Check-in oder Check-out gedrückt hat.

Ein Stempelereignis aus der Callback-API

{
  "RealTime": {
    "OperationID": "9nu1wak5616p",
    "LabelName": "Burj Khalifa",
    "SerialNumber": "ZHM11xxxxxxxx",
    "PunchLog": {
      "Type": "CheckOut",
      "Temperature": "36.8",
      "FaceMask": false,
      "InputType": "Fingerprint",
      "UserId": "2",
      "LogTime": "2020-09-17 07:48:22 GMT +0530"
    },
    "AuthToken": "COJJ7eiIPBGUfmIQPvh2PJWWDLX7OuKs",
    "Time": "2020-09-17 04:19:03 GMT +0000"
  }
}

02 · Nicht alle Duplikate sind gleich

Vier Arten doppelter Stempelereignisse

Der häufigste Fehler besteht darin, jedes Duplikat gleich zu behandeln. Es gibt vier verschiedene Arten, und jede erfordert eine andere Lösung. Einige sind technischer Natur, andere ergeben sich aus der Art, wie Personen die Geräte benutzen.

Art des Duplikats Wie es aussieht Wie man es erkennt Was zu tun ist
Erneut zugestelltes Ereignis Dasselbe Ereignis trifft zweimal ein Gleiche OperationID Die zweite Kopie ignorieren, aber trotzdem mit done antworten
Überlappender Import Ein per Callback empfangenes Ereignis wird während eines Abgleichs erneut importiert Gleiche UserId, LogTime und SerialNumber, aus einer anderen Quelle Die zweite Kopie ignorieren
Doppelscan Eine Person tippt innerhalb weniger Sekunden zweimal auf den Scanner Unterschiedliche OperationIDs, gleiche Person, LogTimes sehr nah beieinander Als einen Stempelvorgang behandeln, mithilfe einer Mindestabstandsregel
Falsch zugeordneter Stempel Eine Person drückt Check-in, obwohl sie Check-out meinte Zwei Check-ins hintereinander ohne Check-out dazwischen Bei der Berechnung der Stunden eine Paarungsregel anwenden

Technische Duplikate versus menschliche Duplikate

Die ersten beiden Arten sind technisch: Es handelt sich um denselben Scan, den Ihr System zweimal erfasst hat, und sie sollten einfach ignoriert werden. Die letzten beiden sind menschlich: Es handelt sich um echte, separate Scans, und die Entscheidung, was sie bedeuten, ist eine Geschäftsregel. Halten Sie die beiden Arten der Behandlung getrennt. Ihr Empfänger sollte nur technische Duplikate entfernen. Ihre Anwesenheitslogik sollte entscheiden, was menschliche Duplikate bedeuten.

Warum es zu erneuter Zustellung kommt

Ein Callback ist ein Dialog: Das Gateway sendet ein Ereignis, und Ihr Server antwortet mit der done-Bestätigung. Wenn die Antwort nie ankommt, weil Ihr Server langsam war, neu gestartet wurde oder kurzzeitig nicht erreichbar war, kann das Ereignis erneut gesendet werden. Ihr Server hat die erste Kopie möglicherweise bereits gespeichert. Deshalb gilt immer dieselbe Regel: Wenn Sie eine OperationID bereits gesehen haben, speichern Sie sie nicht erneut, antworten Sie aber mit done, damit das Gateway weiß, dass das Ereignis angekommen ist. Das genaue Verhalten bei erneuter Zustellung für Ihre Umgebung finden Sie in der Dokumentation zur Cams Web API.

Die Antwort Ihres Empfängers für jedes Ereignis, einschließlich Duplikate

{ "status": "done" }

03 · Eingangsreihenfolge ist nicht die tatsächliche Reihenfolge

Warum Stempelereignisse außer der Reihenfolge eintreffen

Ihr Server empfängt Ereignisse in der Reihenfolge ihres Eintreffens. Die Anwesenheit muss jedoch in der Reihenfolge der Scans berechnet werden. Meistens sind beide Reihenfolgen gleich. Manchmal aber nicht.

Ursache Was passiert Beispiel
Gerät oder Standort ist offline Geräte speichern Scans lokal und senden sie alle, sobald die Verbindung wiederhergestellt ist Ein Check-out um 13:01 trifft um 13:41 ein, nach einem Scan um 13:35 von einem anderen Gerät
Netzwerkverzögerungen Ereignisse von verschiedenen Geräten nehmen unterschiedliche Wege und benötigen unterschiedlich lange Zwei Scans im Abstand von einer Sekunde treffen in umgekehrter Reihenfolge ein
Mehrere Geräte pro Person Ein Mitarbeiter checkt am Haupttor ein und an einer Seitentür aus Ereignisse von zwei Geräten verschachteln sich auf unvorhersehbare Weise
Abgleichs-Importe Fehlende Ereignisse werden später aus den Gerätelogs ergänzt Ein Ereignis von Montag wird an Dienstag zu Ihrem System hinzugefügt

Die Nutzlast zeigt den Unterschied bereits an. LogTime ist der Zeitpunkt des Scans. Time ist der Zeitstempel der Nachricht selbst, in GMT. Im obigen Beispiel-Payload fand der Scan um 07:48 Ortszeit statt, die Nachricht wurde aber um 04:19 GMT gesendet, was in derselben Zeitzone 09:49 entspricht, also zwei Stunden später. Diese Lücke ist genau das Muster, das eine Offline-Phase hinterlässt. Würden Sie nach dem Eingangszeitpunkt sortieren, landete dieser Scan an der falschen Stelle.

Die Eingangszeit zeigt, wann Ihr Server davon erfahren hat. LogTime zeigt, wann es geschehen ist. Die Anwesenheit muss immer LogTime folgen.

04 · Acht Regeln

Das Playbook für saubere Anwesenheitsdaten

Diese acht Regeln behandeln alle oben genannten Fälle. Die ersten vier gehören in Ihren Callback-Empfänger und Ihre Speicherung. Die letzten vier gehören in die Logik, die gespeicherte Ereignisse in Anwesenheitsdaten umwandelt.

1

Jedes Rohereignis zuerst speichern

Speichern Sie jede Nutzlast genau so, wie sie empfangen wurde, bevor Sie irgendetwas anderes damit tun. Stellt sich später heraus, dass eine Regel falsch war, können Sie anhand der Rohdaten neu verarbeiten.

2

Wiederholte OperationIDs ignorieren

Machen Sie OperationID in Ihrer Speicherung eindeutig. Wenn dieselbe OperationID erneut eintrifft, überspringen Sie das Speichern und antworten trotzdem mit done.

3

Einen natürlichen Schlüssel für Importe verwenden

Behandeln Sie bei Ereignissen, die während des Abgleichs importiert werden, die Kombination aus UserId, LogTime und SerialNumber als Identität des Scans, damit derselbe Scan nie aus zwei Quellen doppelt gespeichert wird.

4

Nach LogTime sortieren, niemals nach Eingang

Verarbeiten Sie LogTime mit seinem Zeitzonen-Offset und sortieren Sie bei der Berechnung der Anwesenheit immer danach.

5

Verspätet berechnen, nicht beim Eintreffen

Schließen Sie die Arbeitsstunden eines Tages nicht ab, sobald ein Check-out eintrifft. Berechnen Sie neu, wenn verspätete Ereignisse eintreffen, und sperren Sie einen Tag erst nach einem Abwartezeitraum, etwa bevor die Lohnabrechnung läuft.

6

Doppelscans mit einem Mindestabstand zusammenführen

Behandeln Sie Scans derselben Person innerhalb eines kurzen Zeitfensters, zum Beispiel zwei Minuten, als einen einzigen Stempelvorgang. Wählen Sie ein Zeitfenster, das zu Ihrem Arbeitsplatz passt.

7

Stempel mit einer klaren Regel paaren

Legen Sie fest, wie falsch zugeordnete Stempel behandelt werden, etwa durch Paarung der Scans in zeitlicher Reihenfolge oder durch Verwendung des ersten Scans als Kommen und des letzten als Gehen. Wenden Sie überall dieselbe Regel an.

8

Jede Korrektur dokumentieren

Wenn eine Regel einen Scan zusammenführt, ignoriert oder neu kennzeichnet, halten Sie fest, was geschehen ist und warum. HR und Prüfer müssen nachvollziehen können, wie aus Rohscans Arbeitsstunden wurden.

Gerätezeiten genau halten

LogTime stammt von der Uhr des Geräts. Ist die Zeit eines Geräts falsch, ist jeder Scan darauf falsch, und kein Sortieren kann das beheben. Stellen Sie sicher, dass jedes Gerät das korrekte Datum, die richtige Uhrzeit und Zeitzone hat, und prüfen Sie diese nach Stromausfällen oder Firmware-Updates.

05 · Die Regeln im Zusammenspiel

Ein Beispiel: Ein Mitarbeiter, ein chaotischer Tag

Hier ist ein realistischer Tag für Mitarbeiter 2 am Standort Burj Khalifa, dargestellt in der Reihenfolge, in der die Ereignisse den Server erreichten. Der Standort hat für einen Teil des Tages die Verbindung verloren.

Eingetroffen OperationID Type LogTime Was die Regeln bewirken
09:02 op-1001 CheckIn 08:58 Gespeichert
09:03 op-1001 CheckIn 08:58 Gleiche OperationID: ignoriert, done gesendet
09:04 op-1002 CheckIn 08:59 Innerhalb von zwei Minuten nach 08:58: als Doppelscan zusammengeführt
13:40 op-1004 CheckIn 13:35 Gespeichert
13:41 op-1003 CheckOut 13:01 Verspätet aus Offline-Phase eingetroffen: anhand von LogTime vor 13:35 eingeordnet
18:05 op-1005 CheckIn 18:04 Zweites Check-in hintereinander: als letzter Check-out des Tages gepaart

Nach LogTime sortiert und bereinigt ergibt der Tag zwei klare Arbeitsphasen:

Zeitraum Beginn Ende Dauer
Vormittag 08:58 13:01 4 Stunden 3 Minuten
Nachmittag 13:35 18:04 4 Stunden 29 Minuten
Insgesamt gearbeitet 8 Stunden 32 Minuten

Ohne die Regeln hätten dieselben Rohereignisse drei Check-ins am Vormittag ergeben, einen Check-out, der nach einem Check-in am Nachmittag erscheint, und am Ende des Tages keinen Check-out. Die Lohnabrechnung hätte Fehler gemeldet oder, schlimmer noch, falsche Stunden berechnet, ohne dass es jemandem aufgefallen wäre.

06 · Für saubere Daten gebaut

Wie Cams Gateway Ihnen hilft, Datensätze sauber zu halten

Saubere Anwesenheitsdaten beginnen mit Ereignissen, die die richtigen Informationen enthalten. Cams Biometrics Gateway ist so konzipiert, dass jedes Ereignis, das Ihr System empfängt, identifiziert, geordnet und nachverfolgt werden kann.

Cams-Funktion Wie es hilft
OperationID bei jedem Ereignis Bietet Ihrem System eine verlässliche Möglichkeit, erneut zugestellte Ereignisse zu erkennen und zu ignorieren
LogTime mit Zeitzonen-Offset Ermöglicht es, Ereignisse in ihre tatsächliche Reihenfolge zu bringen, unabhängig davon, wo und wann sie eintreffen
UserId, SerialNumber und LabelName Identifizieren Person, Gerät und Standort, die zusammen einen natürlichen Schlüssel für Importe bilden
Offline-Cache und Warteschlange Hält Ereignisse bei Verbindungsunterbrechungen zurück und liefert sie mit ihren ursprünglichen Zeitstempeln aus
Die done-Bestätigung Liefert ein klares Signal, dass jedes Ereignis angekommen ist, sodass die Zustellung bestätigt werden kann
RESTful-Operationen zum Laden von Logs Ermöglichen es, Gerätelogs bei Bedarf abzurufen, um sie abzugleichen und Lücken zu schließen
KI-Prompts für Codegenerierung Generieren einen Callback-Empfänger, der Tokens validiert und jedes Ereignis protokolliert, bereit für Sie, um die Regeln aus diesem Leitfaden hinzuzufügen

Wer macht was

Cams Gateway liefert jeden verifizierten Scan mit den Informationen, die zu seiner Bereinigung nötig sind. Das Entfernen technischer Duplikate gehört in Ihren Callback-Empfänger. Das Zusammenführen von Doppelscans, das Paaren von Stempeln und die Berechnung der Stunden gehören in Ihr HRMS, Ihre Lohnabrechnung oder Ihre Anwesenheitslogik, wo Ihre Geschäftsregeln bereits festgelegt sind.

Häufig gestellte Fragen

Sollte mein Empfänger doppelte Ereignisse mit einem Fehler ablehnen?

Nein. Antworten Sie auch bei Duplikaten mit done. Das Ereignis ist sicher angekommen, und eine Fehlerantwort könnte dazu führen, dass es erneut gesendet wird. Speichern Sie es einfach nicht.

Kann ich LogTime allein zur Erkennung von Duplikaten verwenden?

Nicht allein. Zwei verschiedene Personen können in derselben Sekunde scannen. Verwenden Sie OperationID für erneut zugestellte Ereignisse und die Kombination aus UserId, LogTime und SerialNumber für Importe.

Wie lang sollte das Zeitfenster für Doppelscans sein?

Lang genug, um versehentliche Mehrfachantippen zu erfassen, und kurz genug, um echte, getrennte Stempelvorgänge nicht zusammenzuführen. Ein Zeitfenster von einer bis zwei Minuten passt für die meisten Arbeitsplätze, doch wählen Sie das, was zu Ihren Schichten und Ihrem Standortlayout passt.

Wann sollte die Anwesenheit eines Tages gesperrt werden?

Nach einem Abwartezeitraum, der verspätete Ereignisse eintreffen lässt, zum Beispiel am nächsten Morgen oder kurz vor dem Lauf der Lohnabrechnung. Bis dahin berechnen Sie neu, wann immer für diesen Tag neue Ereignisse eintreffen.

Gilt das auch für Gesichts-, Karten- und PIN-Scans?

Ja. Jeder Eingabetyp kommt im selben Ereignisformat mit denselben Feldern OperationID und LogTime an, daher gelten dieselben Regeln, unabhängig davon, wie sich die Person verifiziert hat.

Fazit: Vertrauen entsteht durch Regeln, nicht durch Glück

Doppelte und außer der Reihenfolge eintreffende Stempelereignisse sind keine seltenen Ausnahmefälle. Sie sind ein normaler Bestandteil des Betriebs einer biometrischen Zeiterfassung mit echten Geräten, echten Netzwerken und echten Menschen. Der Unterschied zwischen Anwesenheitsdaten, denen die Personalabteilung vertraut, und Daten, die zu Streitigkeiten führen, liegt nicht im Glück. Er liegt in einer kleinen Menge klarer Regeln, die konsequent angewendet werden.

Ignorieren Sie wiederholte OperationIDs. Ordnen Sie alles nach LogTime. Behandeln Sie menschliche Duplikate als Geschäftsregeln, nicht als technische Fehler. Berechnen Sie verspätet, dokumentieren Sie jede Korrektur und halten Sie die Gerätezeiten genau. Mit diesen Regeln wird jeder verifizierte Scan zu einem verlässlichen Datensatz.

Cams Biometrics Gateway liefert Ihnen die Daten, damit diese Regeln funktionieren. Jedes Callback-Ereignis enthält eine OperationID, ein LogTime mit Zeitzonen-Offset sowie die Angaben zu Benutzer, Gerät und Standort, die nötig sind, um jeden Scan zu identifizieren, von Geräten aus mehr als 15 Marken. Der Offline-Cache und die Warteschlange schützen Ereignisse bei Unterbrechungen, und RESTful-Operationen ermöglichen es Ihnen, jederzeit mit den Gerätelogs abzugleichen. Entdecken Sie die Plattform unter CamsBiometrics.com, lesen Sie die vollständige Web-API-Dokumentation unter developer.camsbiometrics.com, und generieren Sie Ihren Callback-Empfänger mit den KI-Prompts für Codegenerierung.

Was this article helpful?