Support Hub/API & Integrations/Hoe u dubbele en niet-chronologische punch-gebeurtenissen…
Translated from the English article and reviewed by a person. Read the English original
Developer

Hoe u dubbele en niet-chronologische punch-gebeurtenissen afhandelt

Hoe u dubbele en niet-chronologische punch-gebeurtenissen afhandelt

 

Biometrische aanwezigheidsregistratie in realtime lijkt eenvoudig: iemand scant, uw systeem ontvangt een gebeurtenis en slaat deze op. In de praktijk zijn aanwezigheidsgegevens rommeliger. Dezelfde gebeurtenis kan twee keer binnenkomen. Een medewerker kan twee keer achter elkaar op de scanner tikken. Een apparaat dat de verbinding heeft verloren, kan een uitcheck van 's ochtends pas 's middags verzenden. Iemand kan per ongeluk op de verkeerde inchecktoets drukken. Als uw systeem elke gebeurtenis precies opslaat zoals die binnenkomt, leiden deze kleine problemen tot onjuiste gewerkte uren, salarisgeschillen en rapporten waarop niemand vertrouwt. Deze gids legt uit welke soorten dubbele en niet-chronologische punch-gebeurtenissen er zijn, waarom ze ontstaan, en geeft een duidelijke reeks regels, gebaseerd op OperationID en LogTime, die uw aanwezigheidsregistraties schoon houden.

01 · Het probleem

Waarom schone aanwezigheidsgegevens moeilijker zijn dan ze lijken

Aanwezigheidsgebeurtenissen komen van fysieke apparaten, verspreid over vestigingen, gebruikt door echte mensen, en verbonden via netwerken die soms wegvallen. Elk van deze feiten brengt een manier met zich mee waarop de gegevens onvolledig of onjuist kunnen binnenkomen. Geen van deze factoren is een fout in het biometrische systeem. Het is simpelweg wat er gebeurt wanneer de fysieke wereld en software elkaar ontmoeten.

Het goede nieuws is dat elke punch-gebeurtenis van de Cams Biometrics Gateway de informatie bevat die u nodig heeft om deze op te schonen. Twee velden doen het meeste werk:

Veld Wat het is Wat u ermee kunt doen
OperationID Een unieke referentie voor elke gebeurtenis die de Gateway verzendt Exact dezelfde gebeurtenis herkennen als deze meer dan één keer binnenkomt
LogTime Het tijdstip waarop de persoon daadwerkelijk heeft gescand, met de tijdzoneverschuiving van het apparaat Gebeurtenissen in de werkelijke volgorde van plaatsvinden zetten, ongeacht wanneer ze binnenkomen

Drie andere velden helpen bij de moeilijkere gevallen: UserId identificeert de persoon, SerialNumber identificeert het apparaat, en Type geeft aan of de persoon heeft ingecheckt of uitgecheckt.

Een punch-gebeurtenis van de 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 · Niet alle duplicaten zijn gelijk

Vier soorten dubbele punch-gebeurtenissen

De meest voorkomende fout is dat elk duplicaat op dezelfde manier wordt behandeld. Er zijn vier verschillende soorten, en elk vereist een andere oplossing. Sommige zijn technisch, en andere komen voort uit hoe mensen de apparaten gebruiken.

Soort duplicaat Hoe het eruitziet Hoe u het herkent Wat u moet doen
Opnieuw afgeleverde gebeurtenis Exact dezelfde gebeurtenis komt twee keer binnen Zelfde OperationID Negeer de tweede kopie, maar antwoord nog steeds met done
Overlappende import Een via callback ontvangen gebeurtenis wordt opnieuw geïmporteerd tijdens een afstemming Zelfde UserId, LogTime en SerialNumber, uit een andere bron Negeer de tweede kopie
Dubbele scan Een persoon tikt binnen enkele seconden twee keer op de scanner Verschillende OperationID's, zelfde persoon, LogTime's die zeer dicht bij elkaar liggen Behandel als één punch, met een regel voor de minimale tussentijd
Verkeerd gelabelde punch Een persoon drukt op inchecken terwijl hij uitchecken bedoelde Twee inchecks achter elkaar zonder uitcheck ertussen Pas een koppelingsregel toe bij het berekenen van uren

Technische duplicaten versus menselijke duplicaten

De eerste twee soorten zijn technisch: het is dezelfde scan die twee keer door uw systeem is waargenomen, en deze moeten eenvoudigweg worden genegeerd. De laatste twee zijn menselijk: het zijn echte, afzonderlijke scans, en bepalen wat ze betekenen is een bedrijfsregel. Houd de twee soorten afhandeling gescheiden. Uw ontvanger mag alleen technische duplicaten verwijderen. Uw aanwezigheidslogica moet bepalen wat menselijke duplicaten betekenen.

Waarom opnieuw afleveren gebeurt

Een callback is een gesprek: de Gateway verstuurt een gebeurtenis, en uw server antwoordt met de done-bevestiging. Als het antwoord nooit aankomt, omdat uw server traag was, opnieuw is opgestart of kortstondig niet bereikbaar was, kan de gebeurtenis opnieuw worden verzonden. Uw server heeft de eerste kopie mogelijk al opgeslagen. Daarom is de regel altijd dezelfde: als u een OperationID al heeft gezien, sla deze dan niet opnieuw op, maar antwoord wel met done zodat de Gateway weet dat de gebeurtenis is aangekomen. Controleer het exacte gedrag bij opnieuw afleveren voor uw situatie in de Cams Web API-documentatie.

Het antwoord dat uw ontvanger voor elke gebeurtenis verstuurt, ook voor duplicaten

{ "status": "done" }

03 · De volgorde van aankomst is niet de echte volgorde

Waarom punch-gebeurtenissen niet in de juiste volgorde binnenkomen

Uw server ontvangt gebeurtenissen in de volgorde van aankomst. Aanwezigheid moet worden berekend in de volgorde van scannen. Meestal zijn dit dezelfde volgorde. Soms is dat niet zo.

Oorzaak Wat er gebeurt Voorbeeld
Apparaat of vestiging is offline Apparaten blijven scans lokaal registreren en verzenden ze allemaal zodra de verbinding terugkeert Een uitcheck van 13:01 komt om 13:41 binnen, na een scan van 13:35 op een ander apparaat
Netwerkvertragingen Gebeurtenissen van verschillende apparaten volgen verschillende routes en doen er verschillend lang over Twee scans met één seconde ertussen komen in omgekeerde volgorde binnen
Meerdere apparaten per persoon Een medewerker checkt in bij de hoofdingang en checkt uit bij een zijdeur Gebeurtenissen van twee apparaten lopen onvoorspelbaar door elkaar
Importen bij afstemming Ontbrekende gebeurtenissen worden later aangevuld vanuit apparaatlogs Een gebeurtenis van maandag wordt dinsdag aan uw systeem toegevoegd

De payload laat het verschil al zien. LogTime is het moment waarop de scan plaatsvond. Time is het tijdstip van het bericht zelf, in GMT. In de voorbeeldpayload hierboven vond de scan plaats om 07:48 lokale tijd, maar werd het bericht verzonden om 04:19 GMT, wat in dezelfde tijdzone 09:49 is, twee uur later. Die kloof is precies hoe een offline periode eruitziet. Als u op aankomsttijd zou sorteren, zou die scan op de verkeerde plek terechtkomen.

De aankomsttijd laat zien wanneer uw server ervan hoorde. LogTime laat zien wanneer het gebeurde. Aanwezigheid moet altijd LogTime volgen.

04 · Acht regels

Het draaiboek voor schone aanwezigheidsgegevens

Deze acht regels behandelen elk van de bovenstaande gevallen. De eerste vier horen thuis in uw callback-ontvanger en opslag. De laatste vier horen thuis in de logica die opgeslagen gebeurtenissen omzet in aanwezigheid.

1

Sla eerst elke ruwe gebeurtenis op

Sla elke payload precies op zoals ontvangen, voordat u er iets anders mee doet. Als een regel later onjuist blijkt, kunt u opnieuw verwerken vanuit de ruwe gegevens.

2

Negeer herhaalde OperationID's

Zorg dat OperationID uniek is in uw opslag. Als dezelfde OperationID opnieuw binnenkomt, sla deze dan niet op en antwoord nog steeds met done.

3

Gebruik een natuurlijke sleutel voor imports

Behandel voor gebeurtenissen die tijdens afstemming worden geïmporteerd de combinatie van UserId, LogTime en SerialNumber als identiteit van de scan, zodat dezelfde scan nooit twee keer uit twee bronnen wordt opgeslagen.

4

Sorteer op LogTime, nooit op aankomst

Lees LogTime in met de tijdzoneverschuiving en sorteer er altijd op bij het berekenen van aanwezigheid.

5

Bereken achteraf, niet direct bij aankomst

Rond de uren van een dag niet af op het moment dat een uitcheck binnenkomt. Herbereken wanneer late gebeurtenissen binnenkomen, en vergrendel een dag pas na een afwikkelingsperiode, bijvoorbeeld voordat de salarisadministratie wordt uitgevoerd.

6

Voeg dubbele scans samen met een minimale tussentijd

Behandel scans van dezelfde persoon binnen een kort tijdvenster, bijvoorbeeld twee minuten, als één punch. Kies een tijdvenster dat past bij uw werkplek.

7

Koppel punches met een duidelijke regel

Bepaal hoe verkeerd gelabelde punches worden behandeld, bijvoorbeeld door scans in tijdsvolgorde te koppelen, of door de eerste scan als aankomst en de laatste als vertrek te gebruiken. Pas dezelfde regel overal toe.

8

Houd een registratie bij van elke correctie

Wanneer een regel een scan samenvoegt, negeert of opnieuw labelt, leg dan vast wat er is gebeurd en waarom. HR en auditors moeten kunnen zien hoe ruwe scans gewerkte uren zijn geworden.

Houd apparaatklokken nauwkeurig

LogTime komt van de klok van het apparaat. Als de tijd van een apparaat onjuist is, is elke scan op dat apparaat onjuist, en geen enkele hoeveelheid sorteren kan dat oplossen. Zorg dat elk apparaat de juiste datum, tijd en tijdzone heeft, en controleer deze na stroomstoringen of firmware-updates.

05 · De regels samenbrengen

Een uitgewerkt voorbeeld: één medewerker, één rommelige dag

Hier is een realistische dag voor medewerker 2 op de vestiging Burj Khalifa, weergegeven in de volgorde waarin de gebeurtenissen de server bereikten. De vestiging verloor gedurende een deel van de dag de verbinding.

Aangekomen OperationID Type LogTime Wat de regels doen
09:02 op-1001 CheckIn 08:58 Opgeslagen
09:03 op-1001 CheckIn 08:58 Zelfde OperationID: genegeerd, done verzonden
09:04 op-1002 CheckIn 08:59 Binnen twee minuten van 08:58: samengevoegd als dubbele scan
13:40 op-1004 CheckIn 13:35 Opgeslagen
13:41 op-1003 CheckOut 13:01 Laat aangekomen vanuit offline periode: geplaatst vóór 13:35 op basis van LogTime
18:05 op-1005 CheckIn 18:04 Tweede inchecken achter elkaar: gekoppeld als de uitcheck van de dag

Gesorteerd op LogTime en opgeschoond, wordt de dag twee duidelijke werkperiodes:

Periode Begin Einde Duur
Ochtend 08:58 13:01 4 uur 3 minuten
Middag 13:35 18:04 4 uur 29 minuten
Totaal gewerkt 8 uur 32 minuten

Zonder de regels had dezelfde reeks ruwe gebeurtenissen drie inchecks in de ochtend kunnen opleveren, een uitcheck die na een middagincheck verschijnt, en geen uitcheck aan het einde van de dag. De salarisadministratie had fouten gesignaleerd of, erger nog, de verkeerde uren berekend zonder dat iemand het opmerkte.

06 · Gebouwd voor schone gegevens

Hoe Cams Gateway u helpt de registratie schoon te houden

Schone aanwezigheidsgegevens beginnen met gebeurtenissen die de juiste informatie bevatten. De Cams Biometrics Gateway is ontworpen zodat elke gebeurtenis die uw systeem ontvangt, kan worden geïdentificeerd, geordend en herleid.

Cams-mogelijkheid Hoe het helpt
OperationID bij elke gebeurtenis Geeft uw systeem een betrouwbare manier om opnieuw afgeleverde gebeurtenissen te herkennen en te negeren
LogTime met tijdzoneverschuiving Maakt het mogelijk gebeurtenissen in hun werkelijke volgorde te zetten, waar en wanneer ze ook binnenkomen
UserId, SerialNumber en LabelName Identificeren de persoon, het apparaat en de vestiging, die samen een natuurlijke sleutel voor imports vormen
Offline cache en wachtrij Houdt gebeurtenissen vast tijdens verbindingsonderbrekingen en levert ze af met hun oorspronkelijke tijdstempels
De done-bevestiging Geeft een duidelijk signaal dat elke gebeurtenis is aangekomen, zodat de aflevering kan worden bevestigd
RESTful-bewerkingen om logs te laden Laten u apparaatlogs op verzoek ophalen om af te stemmen en eventuele hiaten op te vullen
AI Code Generator Prompts Genereert een callback-ontvanger die tokens valideert en elke gebeurtenis registreert, klaar om de regels uit deze gids toe te voegen

Wie doet wat

Cams Gateway levert elke geverifieerde scan met de informatie die nodig is om deze op te schonen. Het verwijderen van technische duplicaten hoort thuis in uw callback-ontvanger. Het samenvoegen van dubbele scans, het koppelen van punches en het berekenen van uren horen thuis in uw HRMS, salarisadministratie of aanwezigheidslogica, waar uw bedrijfsregels al zijn vastgelegd.

Veelgestelde vragen

Moet mijn ontvanger dubbele gebeurtenissen weigeren met een foutmelding?

Nee. Antwoord ook voor duplicaten met done. De gebeurtenis is veilig aangekomen, en een foutantwoord kan ertoe leiden dat deze opnieuw wordt verzonden. Sla deze simpelweg niet op.

Kan ik alleen LogTime gebruiken om duplicaten te detecteren?

Niet alleen. Twee verschillende personen kunnen op dezelfde seconde scannen. Gebruik OperationID voor opnieuw afgeleverde gebeurtenissen, en de combinatie van UserId, LogTime en SerialNumber voor imports.

Hoe lang moet het tijdvenster voor dubbele scans zijn?

Lang genoeg om onbedoeld herhaald tikken op te vangen, kort genoeg om echte afzonderlijke punches niet samen te voegen. Een venster van één tot twee minuten past bij de meeste werkplekken, maar kies wat past bij uw diensten en de indeling van uw vestiging.

Wanneer moet de aanwezigheid van een dag worden vergrendeld?

Na een afwikkelingsperiode die vertraagde gebeurtenissen de ruimte geeft om binnen te komen, bijvoorbeeld de volgende ochtend of vlak voordat de salarisadministratie wordt uitgevoerd. Herbereken tot die tijd telkens wanneer er nieuwe gebeurtenissen voor die dag binnenkomen.

Geldt dit ook voor gezichts-, kaart- en pincodescans?

Ja. Elk invoertype komt aan in hetzelfde gebeurtenisformaat, met dezelfde OperationID- en LogTime-velden, dus dezelfde regels gelden ongeacht hoe de persoon is geverifieerd.

Conclusie: vertrouwen komt van regels, niet van geluk

Dubbele en niet-chronologische punch-gebeurtenissen zijn geen zeldzame uitzonderingen. Ze horen bij het normale gebruik van biometrische aanwezigheidsregistratie met echte apparaten, echte netwerken en echte mensen. Het verschil tussen aanwezigheidsgegevens waarop HR vertrouwt en gegevens die voor geschillen zorgen, is niet geluk. Het is een kleine reeks duidelijke regels, consequent toegepast.

Negeer herhaalde OperationID's. Sorteer alles op LogTime. Behandel menselijke duplicaten als bedrijfsregels, niet als technische fouten. Reken achteraf, registreer elke correctie en houd apparaatklokken nauwkeurig. Met die regels op hun plaats wordt elke geverifieerde scan een betrouwbare registratie.

De Cams Biometrics Gateway levert de gegevens om die regels te laten werken. Elke Callback-gebeurtenis bevat een OperationID, een LogTime met de tijdzoneverschuiving, en de gebruikers-, apparaat- en vestigingsgegevens die nodig zijn om elke scan te identificeren, van apparaten van meer dan 15 merken. Offline cache en wachtrij beschermen gebeurtenissen tijdens onderbrekingen, en RESTful-bewerkingen laten u wanneer nodig afstemmen op apparaatlogs. Ontdek het platform op CamsBiometrics.com, lees de volledige Web API-documentatie op developer.camsbiometrics.com, en genereer uw callback-ontvanger met de AI Code Generator Prompts.

Was this article helpful?