Support Hub/API & Integrations/Cum să gestionați evenimentele de pontaj duplicate și…
Translated from the English article and reviewed by a person. Read the English original
Developer

Cum să gestionați evenimentele de pontaj duplicate și nesortate în ordinea corectă

Cum să gestionați evenimentele de pontaj duplicate și nesortate în ordinea corectă

 

Prezența biometrică în timp real pare simplă: cineva scanează, sistemul primește un eveniment și îl salvează. În practică, datele de prezență sunt mai dezordonate. Același eveniment poate ajunge de două ori. Un angajat poate apăsa scannerul de două ori la rând. Un dispozitiv care și-a pierdut conexiunea poate trimite după-amiaza o ieșire de dimineață. Cineva poate apăsa butonul greșit de intrare. Dacă sistemul salvează fiecare eveniment exact cum sosește, aceste mici probleme se transformă în ore lucrate eronate, dispute privind salarizarea și rapoarte în care nimeni nu mai are încredere. Acest ghid explică diferitele tipuri de evenimente de pontaj duplicate și nesortate, motivele apariției lor și un set clar de reguli, bazate pe OperationID și LogTime, care mențin evidențele de prezență curate.

01 · Problema

De ce datele de prezență curate sunt mai greu de obținut decât par

Evenimentele de prezență provin de la dispozitive fizice, răspândite în mai multe locații, folosite de persoane reale și conectate prin rețele care uneori se întrerup. Fiecare dintre aceste aspecte introduce un mod în care datele pot ajunge imperfect. Niciunul nu reprezintă o defecțiune a sistemului biometric. Sunt pur și simplu rezultatul întâlnirii dintre lumea fizică și software.

Vestea bună este că fiecare eveniment de pontaj trimis de Cams Biometrics Gateway conține informațiile necesare pentru a-l curăța. Două câmpuri fac cea mai mare parte a muncii:

Câmp Ce reprezintă Ce vă permite să faceți
OperationID O referință unică pentru fiecare eveniment trimis de Gateway Să recunoașteți exact același eveniment dacă ajunge de mai multe ori
LogTime Ora la care persoana a scanat efectiv, cu decalajul de fus orar al dispozitivului Să ordonați evenimentele în ordinea reală în care au avut loc, indiferent când sosesc

Încă trei câmpuri ajută în cazurile mai dificile: UserId identifică persoana, SerialNumber identifică dispozitivul, iar Type indică dacă persoana a apăsat intrarea sau ieșirea.

Un eveniment de pontaj de la 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 · Nu toate duplicatele sunt la fel

Patru tipuri de evenimente de pontaj duplicate

Cea mai frecventă greșeală este tratarea tuturor duplicatelor în același mod. Există patru tipuri diferite, iar fiecare necesită o soluție diferită. Unele sunt de natură tehnică, iar altele provin din modul în care oamenii folosesc dispozitivele.

Tipul duplicatului Cum arată Cum se recunoaște Ce trebuie făcut
Eveniment retrimis Același eveniment exact ajunge de două ori Același OperationID Ignorați a doua copie, dar trimiteți totuși răspunsul done
Import suprapus Un eveniment primit prin callback este importat din nou în timpul unei reconcilieri Același UserId, LogTime și SerialNumber, dintr-o sursă diferită Ignorați a doua copie
Scanare dublă O persoană apasă scannerul de două ori în câteva secunde OperationID-uri diferite, aceeași persoană, LogTime-uri foarte apropiate Tratați-le ca un singur pontaj, folosind o regulă de interval minim
Pontaj etichetat greșit O persoană apasă intrarea, deși voia să apese ieșirea Două intrări consecutive, fără o ieșire între ele Aplicați o regulă de asociere la calcularea orelor

Duplicate tehnice versus duplicate umane

Primele două tipuri sunt tehnice: reprezintă aceeași scanare văzută de două ori de sistemul dumneavoastră și ar trebui pur și simplu ignorate. Ultimele două sunt umane: sunt scanări reale, distincte, iar stabilirea semnificației lor ține de o regulă de business. Păstrați separate cele două tipuri de tratare. Receptorul dumneavoastră trebuie să elimine doar duplicatele tehnice. Logica de prezență trebuie să decidă ce înseamnă duplicatele umane.

De ce apare retrimiterea

Un callback este o conversație: Gateway trimite un eveniment, iar serverul dumneavoastră răspunde cu confirmarea done. Dacă răspunsul nu ajunge niciodată, deoarece serverul a fost lent, a fost repornit sau a fost temporar inaccesibil, evenimentul poate fi trimis din nou. Serverul dumneavoastră ar fi putut deja să salveze prima copie. De aceea, regula este întotdeauna aceeași: dacă ați văzut deja un OperationID, nu îl salvați din nou, dar trimiteți răspunsul done, astfel încât Gateway să știe că evenimentul a ajuns. Confirmați comportamentul exact al retrimiterii pentru configurația dumneavoastră în documentația Cams Web API.

Răspunsul trimis de receptorul dumneavoastră pentru fiecare eveniment, inclusiv pentru duplicate

{ "status": "done" }

03 · Ordinea sosirii nu este ordinea reală

De ce evenimentele de pontaj ajung în afara ordinii

Serverul dumneavoastră primește evenimentele în ordinea sosirii. Prezența trebuie calculată în ordinea scanărilor. De cele mai multe ori, acestea coincid. Uneori, nu coincid.

Cauza Ce se întâmplă Exemplu
Dispozitivul sau locația este offline Dispozitivele continuă să înregistreze scanările local, apoi le trimit pe toate când se restabilește conexiunea O ieșire de la 13:01 sosește la 13:41, după o scanare de la 13:35 de pe alt dispozitiv
Întârzieri de rețea Evenimentele de la dispozitive diferite parcurg rute diferite și durează timpi diferiți Două scanări, la o secundă distanță, sosesc în ordine inversă
Mai multe dispozitive pentru fiecare persoană Un angajat se înregistrează la intrarea principală și iese pe o ușă laterală Evenimentele de la două dispozitive se intercalează imprevizibil
Importuri de reconciliere Evenimentele lipsă sunt completate ulterior din jurnalele dispozitivelor Un eveniment de luni este adăugat în sistemul dumneavoastră marți

Payload-ul indică deja diferența. LogTime reprezintă momentul în care a avut loc scanarea. Time este marca de timp a mesajului în sine, în GMT. În exemplul de payload de mai sus, scanarea a avut loc la 07:48 ora locală, dar mesajul a fost trimis la 04:19 GMT, adică 09:49 în același fus orar, cu două ore mai târziu. Acest decalaj este exact ceea ce arată o perioadă offline. Dacă ați sorta după ordinea sosirii, această scanare ar ajunge în locul greșit.

Ora sosirii indică momentul în care serverul dumneavoastră a aflat despre eveniment. LogTime indică momentul în care evenimentul a avut loc. Prezența trebuie să urmeze întotdeauna LogTime.

04 · Opt reguli

Ghidul pentru date de prezență curate

Aceste opt reguli acoperă fiecare dintre cazurile de mai sus. Primele patru se aplică în receptorul callback și în stocare. Ultimele patru se aplică în logica care transformă evenimentele stocate în prezență.

1

Stocați mai întâi fiecare eveniment brut

Salvați fiecare payload exact cum a fost primit, înainte de a face orice altceva cu el. Dacă o regulă se dovedește ulterior greșită, puteți reprocesa datele din forma brută.

2

Ignorați OperationID-urile repetate

Asigurați-vă că OperationID este unic în stocarea dumneavoastră. Dacă același OperationID sosește din nou, nu îl salvați și trimiteți totuși răspunsul done.

3

Folosiți o cheie naturală pentru importuri

Pentru evenimentele importate în timpul reconcilierii, tratați combinația dintre UserId, LogTime și SerialNumber drept identitatea scanării, astfel încât aceeași scanare să nu fie stocată niciodată de două ori din două surse.

4

Ordonați după LogTime, niciodată după ordinea sosirii

Analizați LogTime împreună cu decalajul de fus orar și sortați întotdeauna după acesta atunci când calculați prezența.

5

Calculați târziu, nu în momentul sosirii

Nu finalizați orele unei zile în momentul în care sosește o ieșire. Recalculați atunci când sosesc evenimentele întârziate și blocați o zi doar după o perioadă de stabilizare, de exemplu înainte de rularea salarizării.

6

Uniți scanările duble printr-un interval minim

Tratați scanările aceleiași persoane într-un interval scurt, de exemplu două minute, drept un singur pontaj. Alegeți un interval potrivit locului de muncă.

7

Asociați pontajele printr-o regulă clară

Stabiliți cum tratați pontajele etichetate greșit, de exemplu asociind scanările în ordine cronologică sau folosind prima scanare drept sosire și ultima drept plecare. Aplicați aceeași regulă peste tot.

8

Păstrați o evidență a fiecărei corecții

Atunci când o regulă unește, ignoră sau reetichetează o scanare, înregistrați ce s-a întâmplat și de ce. Departamentul HR și auditorii trebuie să vadă cum s-au transformat scanările brute în ore lucrate.

Mențineți ceasurile dispozitivelor exacte

LogTime provine de la ceasul dispozitivului. Dacă ora unui dispozitiv este greșită, fiecare scanare de pe acesta este greșită, iar sortarea nu va remedia acest lucru. Asigurați-vă că fiecare dispozitiv are data, ora și fusul orar corecte și verificați-le după întreruperi de curent sau actualizări de firmware.

05 · Aplicarea regulilor împreună

Un exemplu practic: un angajat, o zi dezordonată

Iată o zi realistă pentru angajatul 2 de la locația Burj Khalifa, prezentată în ordinea în care evenimentele au ajuns la server. Locația și-a pierdut conexiunea pentru o parte din zi.

Sosit OperationID Type LogTime Ce fac regulile
09:02 op-1001 CheckIn 08:58 Salvat
09:03 op-1001 CheckIn 08:58 Același OperationID: ignorat, răspuns done trimis
09:04 op-1002 CheckIn 08:59 În interval de două minute față de 08:58: unit ca scanare dublă
13:40 op-1004 CheckIn 13:35 Salvat
13:41 op-1003 CheckOut 13:01 Sosit târziu din perioada offline: plasat înainte de 13:35 după LogTime
18:05 op-1005 CheckIn 18:04 A doua intrare consecutivă: asociată drept ieșirea finală a zilei

Sortate după LogTime și curățate, datele zilei devin două perioade clare de lucru:

Perioada Început Sfârșit Durată
Dimineața 08:58 13:01 4 ore și 3 minute
După-amiaza 13:35 18:04 4 ore și 29 de minute
Total lucrat 8 ore și 32 de minute

Fără reguli, aceleași evenimente brute ar fi putut produce trei intrări dimineața, o ieșire care apare după o intrare de după-amiază și nicio ieșire la sfârșitul zilei. Salarizarea ar fi semnalat erori sau, mai grav, ar fi calculat orele greșit fără ca cineva să observe.

06 · Construit pentru date curate

Cum vă ajută Cams Gateway să păstrați evidențe curate

Datele de prezență curate încep cu evenimente care conțin informațiile potrivite. Cams Biometrics Gateway este proiectat astfel încât fiecare eveniment primit de sistemul dumneavoastră să poată fi identificat, ordonat și urmărit.

Funcționalitate Cams Cum ajută
OperationID pentru fiecare eveniment Oferă sistemului dumneavoastră un mod fiabil de a recunoaște și ignora evenimentele retrimise
LogTime cu decalaj de fus orar Vă permite să plasați evenimentele în ordinea lor reală, oricând și oriunde ar sosi
UserId, SerialNumber și LabelName Identifică persoana, dispozitivul și locația, care împreună formează o cheie naturală pentru importuri
Cache și coadă offline Păstrează evenimentele în timpul întreruperilor de conectivitate și le livrează cu marcajele de timp originale
Confirmarea done Oferă un semnal clar că fiecare eveniment a ajuns, astfel încât livrarea poate fi confirmată
Operațiuni RESTful pentru încărcarea jurnalelor Vă permit să preluați jurnalele dispozitivelor la cerere, pentru a reconcilia datele și a completa eventualele lacune
AI Code Generator Prompts Generează un receptor callback care validează token-urile și înregistrează fiecare eveniment, pregătit pentru adăugarea regulilor din acest ghid

Cine ce face

Cams Gateway livrează fiecare scanare verificată împreună cu informațiile necesare pentru a o curăța. Eliminarea duplicatelor tehnice aparține receptorului callback. Unirea scanărilor duble, asocierea pontajelor și calcularea orelor aparțin HRMS-ului, salarizării sau logicii de prezență, unde se află deja regulile de business.

Întrebări frecvente

Ar trebui receptorul meu să respingă evenimentele duplicate cu o eroare?

Nu. Trimiteți și pentru duplicate răspunsul done. Evenimentul a ajuns în siguranță, iar un răspuns de eroare poate determina retrimiterea acestuia. Pur și simplu nu îl salvați.

Pot folosi doar LogTime pentru a detecta duplicatele?

Nu, singur nu este suficient. Două persoane diferite pot scana în aceeași secundă. Folosiți OperationID pentru evenimentele retrimise și combinația dintre UserId, LogTime și SerialNumber pentru importuri.

Cât de lung ar trebui să fie intervalul pentru scanările duble?

Suficient de lung pentru a prinde apăsările repetate accidentale, dar suficient de scurt pentru a nu uni pontaje distincte reale. Un interval de unu până la două minute se potrivește majorității locurilor de muncă, dar alegeți ce se potrivește programului dumneavoastră de lucru și amenajării locației.

Când ar trebui blocată prezența unei zile?

După o perioadă de stabilizare care permite sosirea evenimentelor întârziate, de exemplu a doua zi dimineața sau chiar înainte de rularea salarizării. Până atunci, recalculați ori de câte ori sosesc evenimente noi pentru acea zi.

Se aplică acest lucru și scanărilor facială, cu card și cu PIN?

Da. Fiecare tip de intrare sosește în același format de eveniment, cu aceleași câmpuri OperationID și LogTime, deci aceleași reguli se aplică indiferent de modul în care persoana a fost verificată.

Concluzie: încrederea vine din reguli, nu din noroc

Evenimentele de pontaj duplicate și nesortate în ordinea corectă nu sunt cazuri rare. Ele fac parte în mod normal din funcționarea prezenței biometrice pe dispozitive reale, în rețele reale și cu persoane reale. Diferența dintre datele de prezență în care are încredere departamentul HR și datele care generează dispute nu ține de noroc. Ține de un set mic de reguli clare, aplicate constant.

Ignorați OperationID-urile repetate. Ordonați totul după LogTime. Tratați duplicatele umane ca reguli de business, nu ca erori tehnice. Calculați târziu, înregistrați fiecare corecție și mențineți ceasurile dispozitivelor exacte. Cu aceste reguli aplicate, fiecare scanare verificată devine o înregistrare fiabilă.

Cams Biometrics Gateway vă oferă datele necesare pentru a face aceste reguli să funcționeze. Fiecare eveniment Callback conține un OperationID, un LogTime cu decalajul de fus orar și detaliile despre utilizator, dispozitiv și locație necesare pentru a identifica fiecare scanare, de la dispozitive din peste 15 mărci. Cache-ul și coada offline protejează evenimentele în timpul întreruperilor, iar operațiunile RESTful vă permit să reconciliați datele cu jurnalele dispozitivelor ori de câte ori aveți nevoie. Explorați platforma la CamsBiometrics.com, citiți documentația completă a Web API la developer.camsbiometrics.com și generați receptorul callback cu ajutorul AI Code Generator Prompts.

Was this article helpful?