Support Hub/API & Integrations/डुप्लीकेट और क्रम से बाहर आने वाले पंच इवेंट्स को कैसे संभालें
Translated from the English article and reviewed by a person. Read the English original
Developer

डुप्लीकेट और क्रम से बाहर आने वाले पंच इवेंट्स को कैसे संभालें

डुप्लीकेट और क्रम से बाहर आने वाले पंच इवेंट्स को कैसे संभालें

 

रियल-टाइम बायोमेट्रिक उपस्थिति सुनने में सरल लगती है: कोई स्कैन करता है, आपका सिस्टम एक इवेंट प्राप्त करता है, और आप उसे सेव कर लेते हैं। व्यवहार में, उपस्थिति डेटा अधिक उलझा हुआ होता है। वही इवेंट दो बार आ सकता है। कोई कर्मचारी स्कैनर पर लगातार दो बार टैप कर सकता है। जो डिवाइस कनेक्शन खो चुका हो, वह सुबह का चेक-आउट दोपहर में भेज सकता है। कोई गलत चेक-इन बटन दबा सकता है। यदि आपका सिस्टम हर इवेंट को ठीक वैसे ही सेव करता है जैसे वह आता है, तो ये छोटी समस्याएँ गलत कार्य-घंटों, वेतन विवादों और ऐसी रिपोर्टों में बदल जाती हैं जिन पर कोई भरोसा नहीं करता। यह गाइड डुप्लीकेट और क्रम से बाहर पंच इवेंट्स के अलग-अलग प्रकार, उनके होने के कारण, और OperationID तथा LogTime पर आधारित नियमों का एक स्पष्ट सेट समझाती है, जो आपके उपस्थिति रिकॉर्ड को साफ रखता है।

01 · समस्या

साफ उपस्थिति डेटा दिखने से अधिक कठिन क्यों है

उपस्थिति इवेंट्स भौतिक डिवाइसों से आते हैं, जो अलग-अलग साइटों पर फैले होते हैं, वास्तविक लोग उनका उपयोग करते हैं, और ऐसे नेटवर्कों से जुड़े होते हैं जो कभी-कभी टूट जाते हैं। इनमें से हर तथ्य डेटा के अधूरे या गलत रूप में पहुँचने का एक रास्ता बनाता है। इनमें से कोई भी बायोमेट्रिक सिस्टम की खामी नहीं है। जब भौतिक दुनिया सॉफ्टवेयर से मिलती है, तो बस यही होता है।

अच्छी बात यह है कि Cams Biometrics Gateway से आने वाला हर पंच इवेंट उसे साफ करने के लिए आवश्यक जानकारी रखता है। दो फ़ील्ड्स अधिकांश काम करते हैं:

फ़ील्ड यह क्या है यह आपको क्या करने देता है
OperationID Gateway द्वारा भेजे गए हर इवेंट के लिए एक अद्वितीय संदर्भ यदि वही इवेंट एक से अधिक बार आए, तो उसे पहचानें
LogTime वह समय जब व्यक्ति ने वास्तव में स्कैन किया, डिवाइस के समय क्षेत्र ऑफ़सेट के साथ इवेंट्स को उनके वास्तविक घटित होने के क्रम में रखें, चाहे वे कभी भी आएँ

तीन और फ़ील्ड्स कठिन मामलों में मदद करते हैं: UserId व्यक्ति की पहचान करता है, SerialNumber डिवाइस की पहचान करता है, और Type बताता है कि व्यक्ति ने चेक-इन दबाया या चेक-आउट।

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 · हर डुप्लीकेट एक जैसा नहीं होता

डुप्लीकेट पंच इवेंट्स के चार प्रकार

सबसे आम गलती यह है कि हर डुप्लीकेट के साथ एक जैसा व्यवहार किया जाए। इसके चार अलग प्रकार हैं, और हर एक को अलग समाधान चाहिए। कुछ तकनीकी हैं, और कुछ इस बात से आते हैं कि लोग डिवाइसों का उपयोग कैसे करते हैं।

डुप्लीकेट का प्रकार यह कैसा दिखता है इसे कैसे पहचानें क्या करें
दोबारा भेजा गया इवेंट वही इवेंट दो बार आता है वही OperationID दूसरी कॉपी को अनदेखा करें, लेकिन फिर भी done का जवाब भेजें
ओवरलैपिंग इम्पोर्ट कॉलबैक द्वारा प्राप्त इवेंट को रीकंसिलिएशन के दौरान फिर से इम्पोर्ट किया जाता है वही UserId, LogTime और SerialNumber, किसी अलग स्रोत से दूसरी कॉपी को अनदेखा करें
डबल स्कैन व्यक्ति सेकंडों के भीतर स्कैनर पर दो बार टैप करता है अलग-अलग OperationID, वही व्यक्ति, LogTime एक-दूसरे के बहुत करीब न्यूनतम-अंतराल नियम का उपयोग करके इसे एक पंच मानें
गलत लेबल वाला पंच व्यक्ति चेक-आउट करना चाहता था, लेकिन चेक-इन दबाता है बीच में चेक-आउट के बिना लगातार दो चेक-इन कार्य-घंटों की गणना करते समय एक पेयरिंग नियम लागू करें

तकनीकी डुप्लीकेट बनाम मानवीय डुप्लीकेट

पहले दो प्रकार तकनीकी हैं: ये वही स्कैन हैं जो आपके सिस्टम ने दो बार देखे, और इन्हें बस अनदेखा किया जाना चाहिए। आखिरी दो मानवीय हैं: ये वास्तविक, अलग-अलग स्कैन हैं, और यह तय करना कि इनका क्या अर्थ है, एक व्यावसायिक नियम है। दोनों प्रकार के प्रबंधन को अलग रखें। आपका रिसीवर केवल तकनीकी डुप्लीकेट हटाए। यह तय करना कि मानवीय डुप्लीकेट का क्या मतलब है, आपका उपस्थिति तर्क करे।

दोबारा डिलीवरी क्यों होती है

कॉलबैक एक संवाद है: Gateway एक इवेंट भेजता है, और आपका सर्वर done स्वीकृति के साथ जवाब देता है। यदि जवाब कभी नहीं पहुँचता, क्योंकि आपका सर्वर धीमा था, रीस्टार्ट हुआ, या कुछ समय के लिए पहुँच से बाहर था, तो इवेंट दोबारा भेजा जा सकता है। आपका सर्वर पहली कॉपी पहले ही सेव कर चुका हो सकता है। इसीलिए नियम हमेशा एक जैसा है: यदि आप किसी OperationID को पहले ही देख चुके हैं, तो उसे दोबारा सेव न करें, लेकिन done का जवाब अवश्य भेजें ताकि Gateway को पता चले कि इवेंट पहुँच गया। अपने सेटअप के लिए सटीक दोबारा-डिलीवरी व्यवहार की पुष्टि Cams Web API दस्तावेज़ीकरण में करें।

आपके रिसीवर द्वारा हर इवेंट के लिए भेजा गया जवाब, डुप्लीकेट सहित

{ "status": "done" }

03 · आने का क्रम वास्तविक क्रम नहीं है

पंच इवेंट्स क्रम से बाहर क्यों आते हैं

आपका सर्वर इवेंट्स को आने के क्रम में प्राप्त करता है। उपस्थिति की गणना स्कैन के क्रम में होनी चाहिए। अधिकतर समय ये एक ही होते हैं। कभी-कभी ऐसा नहीं होता।

कारण क्या होता है उदाहरण
डिवाइस या साइट ऑफ़लाइन हो जाती है डिवाइस स्कैन स्थानीय रूप से रिकॉर्ड करते रहते हैं, फिर कनेक्शन लौटने पर सब भेज देते हैं दूसरे डिवाइस के 13:35 स्कैन के बाद 13:41 पर 13:01 का चेक-आउट आता है
नेटवर्क देरी अलग-अलग डिवाइसों के इवेंट अलग-अलग रास्तों से जाते हैं और अलग समय लेते हैं एक सेकंड के अंतर वाले दो स्कैन उल्टे क्रम में आते हैं
हर व्यक्ति के लिए कई डिवाइस कर्मचारी मुख्य गेट पर चेक-इन करता है और साइड डोर पर चेक-आउट करता है दो डिवाइसों के इवेंट अप्रत्याशित रूप से आपस में मिल जाते हैं
रीकंसिलिएशन इम्पोर्ट डिवाइस लॉग से लापता इवेंट बाद में भरे जाते हैं सोमवार का एक इवेंट मंगलवार को आपके सिस्टम में जोड़ा जाता है

पेलोड पहले ही अंतर बता देता है। LogTime वह समय है जब स्कैन हुआ। Time GMT में स्वयं संदेश का टाइमस्टैम्प है। ऊपर के नमूना पेलोड में, स्कैन स्थानीय समय 07:48 पर हुआ, लेकिन संदेश 04:19 GMT पर भेजा गया, जो उसी समय क्षेत्र में 09:49 है, यानी दो घंटे बाद। यही अंतर ठीक वैसा है जैसा ऑफ़लाइन अवधि दिखती है। यदि आप आने के समय से क्रमबद्ध करते, तो वह स्कैन गलत जगह पर आ जाता।

आने का समय बताता है कि आपके सर्वर को कब पता चला। LogTime बताता है कि यह कब हुआ। उपस्थिति हमेशा LogTime का अनुसरण करनी चाहिए।

04 · आठ नियम

साफ उपस्थिति डेटा की प्लेबुक

ये आठ नियम ऊपर के हर मामले को संभालते हैं। पहले चार आपके कॉलबैक रिसीवर और स्टोरेज में लागू होते हैं। अंतिम चार उस तर्क में लागू होते हैं जो संग्रहीत इवेंट्स को उपस्थिति में बदलता है।

1

कच्चे इवेंट्स को पहले सेव करें

किसी भी और काम से पहले हर पेलोड को जैसा प्राप्त हुआ वैसा ही सेव करें। यदि कोई नियम बाद में गलत निकले, तो आप कच्चे डेटा से दोबारा प्रोसेस कर सकते हैं।

2

दोहराए गए OperationID को अनदेखा करें

OperationID को अपने स्टोरेज में अद्वितीय बनाएँ। यदि वही OperationID फिर आए, तो उसे सेव करना छोड़ दें और फिर भी done का जवाब दें।

3

इम्पोर्ट के लिए नेचुरल की का उपयोग करें

रीकंसिलिएशन के दौरान इम्पोर्ट किए गए इवेंट्स के लिए UserId, LogTime और SerialNumber के संयोजन को स्कैन की पहचान मानें, ताकि एक ही स्कैन दो स्रोतों से कभी दो बार सेव न हो।

4

LogTime से क्रमबद्ध करें, आगमन से कभी नहीं

LogTime को उसके समय क्षेत्र ऑफ़सेट के साथ पार्स करें, और उपस्थिति की गणना करते समय हमेशा उसी से क्रमबद्ध करें।

5

देर से आने वाले इवेंट्स के लिए गणना बाद में करें

चेक-आउट आते ही किसी दिन के घंटे अंतिम रूप न दें। देर से आने वाले इवेंट्स पर पुनर्गणना करें, और किसी दिन को केवल एक सेटलमेंट विंडो के बाद लॉक करें, जैसे वेतन चलने से पहले।

6

न्यूनतम अंतराल से डबल स्कैन मिलाएँ

एक ही व्यक्ति के छोटे अवधि के भीतर के स्कैन, जैसे दो मिनट, को एक पंच मानें। अपने कार्यस्थल के अनुकूल विंडो चुनें।

7

स्पष्ट नियम से पंच पेयर करें

गलत लेबल वाले पंचों को कैसे संभालना है, यह तय करें, जैसे समय के क्रम में स्कैन पेयर करना, या पहले स्कैन को आगमन और अंतिम को प्रस्थान मानना। हर जगह एक ही नियम लागू करें।

8

हर सुधार का रिकॉर्ड रखें

जब कोई नियम स्कैन को मिलाता, अनदेखा करता या पुनः लेबल करता है, तो लिखें कि क्या हुआ और क्यों। HR और ऑडिटर्स को यह देखना होता है कि कच्चे स्कैन कार्य-घंटों में कैसे बदले।

डिवाइस घड़ियाँ सटीक रखें

LogTime डिवाइस की घड़ी से आता है। यदि किसी डिवाइस का समय गलत है, तो उस पर हर स्कैन गलत है, और कोई भी क्रमबद्ध करना इसे ठीक नहीं कर सकता। सुनिश्चित करें कि हर डिवाइस की तारीख, समय और समय क्षेत्र सही हों, और बिजली कटौती या फ़र्मवेयर अपडेट के बाद उन्हें जाँचें।

05 · नियमों को एक साथ लागू करना

एक कार्य उदाहरण: एक कर्मचारी, एक उलझा हुआ दिन

बुर्ज खलीफा साइट पर कर्मचारी 2 के लिए एक वास्तविक दिन यहाँ है, जो उसी क्रम में दिखाया गया है जिसमें इवेंट्स सर्वर तक पहुँचे। दिन के एक हिस्से में साइट का कनेक्शन टूट गया था।

आया OperationID Type LogTime नियम क्या करते हैं
09:02 op-1001 CheckIn 08:58 सेव किया गया
09:03 op-1001 CheckIn 08:58 वही OperationID: अनदेखा, done भेजा गया
09:04 op-1002 CheckIn 08:59 08:58 के दो मिनट के भीतर: डबल स्कैन के रूप में मिलाया गया
13:40 op-1004 CheckIn 13:35 सेव किया गया
13:41 op-1003 CheckOut 13:01 ऑफ़लाइन अवधि से देर से आया: LogTime द्वारा 13:35 से पहले रखा गया
18:05 op-1005 CheckIn 18:04 लगातार दूसरा चेक-इन: दिन के अंतिम चेक-आउट के रूप में पेयर किया गया

LogTime के अनुसार क्रमबद्ध और साफ करने के बाद, दिन दो स्पष्ट कार्य-अवधियों में बदल जाता है:

अवधि शुरू समाप्त अवधि की लंबाई
सुबह 08:58 13:01 4 घंटे 3 मिनट
दोपहर 13:35 18:04 4 घंटे 29 मिनट
कुल कार्य 8 घंटे 32 मिनट

नियमों के बिना, वही कच्चे इवेंट्स सुबह तीन चेक-इन, दोपहर के चेक-इन के बाद दिखने वाला चेक-आउट, और दिन के अंत में कोई चेक-आउट नहीं पैदा कर सकते थे। वेतन प्रणाली त्रुटियाँ चिह्नित करती, या इससे भी बुरा, किसी को पता चले बिना गलत घंटों की गणना कर देती।

06 · साफ डेटा के लिए निर्मित

Cams Gateway आपके रिकॉर्ड साफ रखने में कैसे मदद करता है

साफ उपस्थिति डेटा सही जानकारी वाले इवेंट्स से शुरू होता है। Cams Biometrics Gateway इस तरह बनाया गया है कि आपके सिस्टम को मिलने वाले हर इवेंट की पहचान, क्रम और ट्रेस किया जा सके।

Cams क्षमता यह कैसे मदद करती है
हर इवेंट पर OperationID आपके सिस्टम को दोबारा भेजे गए इवेंट्स को विश्वसनीय रूप से पहचानने और अनदेखा करने का तरीका देता है
समय क्षेत्र ऑफ़सेट के साथ LogTime इवेंट्स को जहाँ और जब भी आएँ, उनके वास्तविक क्रम में रखने देता है
UserId, SerialNumber और LabelName व्यक्ति, डिवाइस और साइट की पहचान करता है, जो मिलकर इम्पोर्ट के लिए नेचुरल की बनाते हैं
ऑफ़लाइन कैश और क्यू कनेक्टिविटी रुकावटों के दौरान इवेंट्स रखता है और उन्हें मूल टाइमस्टैम्प के साथ पहुँचाता है
done स्वीकृति स्पष्ट संकेत देता है कि हर इवेंट पहुँचा, ताकि डिलीवरी की पुष्टि हो सके
लॉग लोड करने के लिए RESTful ऑपरेशन आवश्यकता पड़ने पर डिवाइस लॉग मांगने देता है ताकि रीकंसाइल किया जा सके और किसी भी अंतर को भरा जा सके
AI Code Generator Prompts एक कॉलबैक रिसीवर तैयार करता है जो टोकन सत्यापित करता है और हर इवेंट लॉग करता है, जिसमें आप इस गाइड के नियम जोड़ सकते हैं

कौन क्या करता है

Cams Gateway हर सत्यापित स्कैन को उसे साफ करने के लिए आवश्यक जानकारी के साथ पहुँचाता है। तकनीकी डुप्लीकेट हटाना आपके कॉलबैक रिसीवर का काम है। डबल स्कैन मिलाना, पंच पेयर करना और घंटों की गणना करना आपके HRMS, वेतन या उपस्थिति तर्क में होना चाहिए, जहाँ आपके व्यावसायिक नियम पहले से रहते हैं।

अक्सर पूछे जाने वाले प्रश्न

क्या मेरा रिसीवर डुप्लीकेट इवेंट्स को त्रुटि के साथ अस्वीकार करे?

नहीं। डुप्लीकेट के लिए भी done का जवाब दें। इवेंट सुरक्षित रूप से पहुँच गया है, और त्रुटि का जवाब उसे दोबारा भेजे जाने का कारण बन सकता है। बस उसे सेव करना छोड़ दें।

क्या मैं अकेले LogTime से डुप्लीकेट पहचान सकता हूँ?

अकेले नहीं। दो अलग-अलग लोग एक ही सेकंड में स्कैन कर सकते हैं। दोबारा भेजे गए इवेंट्स के लिए OperationID का उपयोग करें, और इम्पोर्ट के लिए UserId, LogTime और SerialNumber के संयोजन का।

डबल-स्कैन विंडो कितनी लंबी होनी चाहिए?

इतनी लंबी कि गलती से दोहराए गए टैप पकड़ में आएँ, और इतनी छोटी कि वास्तविक अलग पंच न मिलें। एक से दो मिनट की विंडो अधिकांश कार्यस्थलों के लिए उपयुक्त है, लेकिन अपनी शिफ्ट और साइट लेआउट के अनुसार चुनें।

किसी दिन की उपस्थिति कब लॉक की जानी चाहिए?

एक सेटलमेंट विंडो के बाद, जो देर से आने वाले इवेंट्स को पहुँचने दे, उदाहरण के लिए अगली सुबह या वेतन चलने से ठीक पहले। तब तक, उस दिन के लिए नए इवेंट्स आने पर पुनर्गणना करें।

क्या यह चेहरा, कार्ड और PIN स्कैन पर भी लागू होता है?

हाँ। हर इनपुट प्रकार एक ही इवेंट प्रारूप में, उन्हीं OperationID और LogTime फ़ील्ड्स के साथ आता है, इसलिए व्यक्ति ने कैसे सत्यापन किया, इससे फर्क नहीं पड़ता, वही नियम लागू होते हैं।

निष्कर्ष: भरोसा नियमों से आता है, संयोग से नहीं

डुप्लीकेट और क्रम से बाहर पंच इवेंट्स दुर्लभ अपवाद नहीं हैं। वास्तविक डिवाइसों, वास्तविक नेटवर्कों और वास्तविक लोगों के साथ बायोमेट्रिक उपस्थिति चलाने का यह एक सामान्य हिस्सा है। जिस उपस्थिति डेटा पर HR भरोसा करता है और जो विवाद पैदा करता है, उनके बीच का अंतर संयोग नहीं है। यह नियमों का एक छोटा, स्पष्ट सेट है, जिसे लगातार लागू किया जाए।

दोहराए गए OperationID को अनदेखा करें। हर चीज़ को LogTime से क्रमबद्ध करें। मानवीय डुप्लीकेट को तकनीकी त्रुटियाँ नहीं, बल्कि व्यावसायिक नियम मानें। गणना देर से करें, हर सुधार दर्ज करें, और डिवाइस घड़ियाँ सटीक रखें। इन नियमों के लागू होने पर, हर सत्यापित स्कैन एक विश्वसनीय रिकॉर्ड बन जाता है।

Cams Biometrics Gateway आपको इन नियमों को काम करने का डेटा देता है। हर Callback इवेंट में एक OperationID, समय क्षेत्र ऑफ़सेट के साथ एक LogTime, और हर स्कैन की पहचान के लिए आवश्यक उपयोगकर्ता, डिवाइस और साइट का विवरण होता है, जो 15 से अधिक ब्रांड के डिवाइसों से आता है। ऑफ़लाइन कैश और क्यू रुकावटों के दौरान इवेंट्स की सुरक्षा करता है, और RESTful ऑपरेशन आपको जब भी ज़रूरत हो डिवाइस लॉग से रीकंसाइल करने देते हैं। प्लेटफ़ॉर्म को CamsBiometrics.com पर देखें, पूरा Web API दस्तावेज़ developer.camsbiometrics.com पर पढ़ें, और AI Code Generator Prompts के साथ अपना कॉलबैक रिसीवर तैयार करें।

Was this article helpful?