كيفية التعامل مع أحداث التسجيل المكررة والواردة خارج الترتيب
يبدو تسجيل الحضور بالبصمة في الوقت الفعلي أمرًا بسيطًا: يمرّر الموظف بصمته، ويستقبل نظامك الحدث، ثم تحفظه. لكن في الواقع تكون بيانات الحضور أكثر فوضوية. قد يصل الحدث نفسه مرتين. قد يلمس الموظف الجهاز مرتين متتاليتين. وقد يرسل جهاز فقد اتصاله تسجيل انصراف صباحي في فترة ما بعد الظهر. وقد يضغط شخص على زر تسجيل حضور خاطئ. إذا حفظ نظامك كل حدث تمامًا كما يصل، فستتحول هذه المشكلات البسيطة إلى ساعات عمل غير صحيحة، ونزاعات على الرواتب، وتقارير لا يثق بها أحد. يشرح هذا الدليل أنواع أحداث التسجيل المكررة والواردة خارج الترتيب، وأسباب حدوثها، ومجموعة واضحة من القواعد المبنية على OperationID وLogTime، والتي تحافظ على نظافة سجلات الحضور.
01 · المشكلة
لماذا يصعب الحفاظ على نظافة بيانات الحضور أكثر مما يبدو
تأتي أحداث الحضور من أجهزة مادية موزعة على مواقع متعددة، يستخدمها أشخاص حقيقيون، وتتصل عبر شبكات قد تنقطع أحيانًا. وكل من هذه العوامل يمثل طريقة قد تصل بها البيانات بشكل غير دقيق. ولا يُعد أي منها خللًا في نظام البصمة نفسه، بل هي ببساطة ما يحدث عندما يلتقي العالم المادي بالبرمجيات.
الخبر الجيد أن كل حدث تسجيل من Cams Biometrics Gateway يحمل المعلومات التي تحتاجها لتنظيفه. ويقوم حقلان بمعظم العمل:
| الحقل | ما هو | ما الذي يتيحه لك |
|---|---|---|
| OperationID | مرجع فريد لكل حدث ترسله البوابة | التعرف على الحدث نفسه تمامًا إذا وصل أكثر من مرة |
| 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 متقاربة جدًا | اعتبارهما تسجيلًا واحدًا باستخدام قاعدة الحد الأدنى للفاصل الزمني |
| تسجيل بنوع خاطئ | يضغط الشخص على تسجيل الحضور وكان يقصد تسجيل الانصراف | تسجيلان للحضور متتاليان دون تسجيل انصراف بينهما | تطبيق قاعدة إقران عند حساب الساعات |
|
التكرارات التقنية مقابل التكرارات البشرية النوعان الأولان تقنيان: فهما المسح نفسه كما رآه نظامك مرتين، ويجب ببساطة تجاهلهما. أما النوعان الأخيران فهما بشريان: فهما مسحان حقيقيان ومنفصلان، ويُعد تحديد معناهما قاعدة من قواعد العمل. افصل بين طريقتي التعامل مع النوعين. يجب أن يزيل المستقبِل لديك التكرارات التقنية فقط. أما منطق الحضور لديك فيجب أن يحدد معنى التكرارات البشرية. |
لماذا تحدث إعادة الإرسال
رد الاتصال أشبه بحوار: ترسل البوابة حدثًا، ويرد خادمك بإقرار done. إذا لم يصل الرد أبدًا، لأن خادمك كان بطيئًا أو أُعيد تشغيله أو تعذر الوصول إليه لفترة قصيرة، فقد يُعاد إرسال الحدث. ربما يكون خادمك قد حفظ النسخة الأولى بالفعل. لذلك تكون القاعدة دائمًا كما يلي: إذا رأيت OperationID من قبل، فلا تحفظه مرة أخرى، لكن أرسل رد done حتى تعرف البوابة أن الحدث وصل. وتأكد من سلوك إعادة الإرسال الدقيق لإعدادك في وثائق Cams Web API.
|
الرد الذي يرسله المستقبِل لديك لكل حدث، بما في ذلك التكرارات { "status": "done" }
|
03 · ترتيب الوصول ليس الترتيب الحقيقي
لماذا تصل أحداث التسجيل خارج الترتيب
يستقبل خادمك الأحداث حسب ترتيب وصولها. أما الحضور فيجب حسابه حسب ترتيب المسح. وفي معظم الأوقات يكون الترتيبان متطابقين، لكن ليس دائمًا.
| السبب | ما الذي يحدث | مثال |
|---|---|---|
| انقطاع الجهاز أو الموقع عن الشبكة | تستمر الأجهزة في تسجيل المسح محليًا، ثم ترسله كله عند عودة الاتصال | يصل تسجيل انصراف الساعة 13:01 في الساعة 13:41، بعد مسح في الساعة 13:35 من جهاز آخر |
| تأخيرات الشبكة | تسلك الأحداث القادمة من أجهزة مختلفة مسارات مختلفة وتستغرق أوقاتًا مختلفة | يصل مسحان بفارق ثانية واحدة بترتيب معكوس |
| عدة أجهزة لكل شخص | يسجل الموظف الحضور عند البوابة الرئيسية، ويسجل الانصراف عند الباب الجانبي | تتداخل أحداث جهازين بطريقة غير متوقعة |
| استيرادات المطابقة | تُستكمل الأحداث الناقصة لاحقًا من سجلات الأجهزة | يُضاف حدث يوم الاثنين إلى نظامك يوم الثلاثاء |
تُظهر الحمولة نفسها الفرق بالفعل. LogTime هو وقت حدوث المسح. وTime هو الطابع الزمني للرسالة نفسها بتوقيت GMT. في الحمولة النموذجية أعلاه، حدث المسح في الساعة 07:48 بالتوقيت المحلي، لكن أُرسلت الرسالة في الساعة 04:19 بتوقيت GMT، أي 09:49 في المنطقة الزمنية نفسها، بفارق ساعتين. وهذه الفجوة بالضبط هي ما يبدو عليه فترة الانقطاع عن الشبكة. فإذا رتبت الأحداث حسب وقت الوصول، فسيقع ذلك المسح في المكان الخاطئ.
|
يخبرك وقت الوصول بالوقت الذي اكتشف فيه خادمك الحدث. ويخبرك LogTime بالوقت الذي حدث فيه. ويجب أن يتبع الحضور دائمًا LogTime. |
04 · ثماني قواعد
دليل عمل بيانات الحضور النظيفة
تعالج هذه القواعد الثماني كل حالة مذكورة أعلاه. تنتمي القواعد الأربع الأولى إلى المستقبِل ومخزن رد الاتصال لديك. أما القواعد الأربع الأخيرة فتنتمي إلى المنطق الذي يحوّل الأحداث المخزنة إلى سجلات حضور.
|
خزّن كل حدث خام أولًا احفظ كل حمولة كما استُلمت تمامًا قبل القيام بأي شيء آخر معها. وإذا تبيّن لاحقًا أن قاعدة ما خاطئة، فيمكنك إعادة المعالجة من البيانات الخام. |
|
|
تجاهل OperationID المكررة اجعل OperationID فريدًا في مخزنك. وإذا وصل OperationID نفسه مرة أخرى، فتخطَّ حفظه وأرسل رد done. |
|
|
استخدم مفتاحًا طبيعيًا للاستيراد بالنسبة للأحداث المستوردة أثناء المطابقة، اعتبر مجموعة UserId وLogTime وSerialNumber هي هوية المسح، بحيث لا يُخزَّن المسح نفسه مرتين من مصدرين. |
|
|
رتّب حسب LogTime، وليس حسب وقت الوصول أبدًا قم بتحليل LogTime مع فرق المنطقة الزمنية الخاص به، ورتّب الأحداث حسبه دائمًا عند حساب الحضور. |
|
|
احسب بعد التأخير، لا عند الوصول لا تُنهِ حساب ساعات اليوم فور وصول تسجيل انصراف. أعد الحساب عند وصول الأحداث المتأخرة، ولا تُقفل اليوم إلا بعد فترة تسوية، مثل ما قبل تشغيل الرواتب. |
|
|
ادمج المسحات المزدوجة بفاصل زمني أدنى عامل المسحات الصادرة من الشخص نفسه ضمن نافذة زمنية قصيرة، مثل دقيقتين، على أنها تسجيل واحد. واختر نافذة زمنية تناسب مكان عملك. |
|
|
أقرن التسجيلات بقاعدة واضحة حدد كيفية التعامل مع التسجيلات ذات الأنواع الخاطئة، مثل إقران المسحات حسب ترتيبها الزمني، أو اعتبار أول مسح وقتًا للحضور وآخر مسح وقتًا للانصراف. طبّق القاعدة نفسها في كل مكان. |
|
|
احتفظ بسجل لكل تصحيح عندما تقوم قاعدة بدمج مسح أو تجاهله أو إعادة تصنيفه، سجّل ما حدث ولماذا. يحتاج فريق الموارد البشرية والمدققون إلى رؤية كيف تحولت المسحات الخام إلى ساعات عمل. |
|
حافظ على دقة ساعات الأجهزة يأتي LogTime من ساعة الجهاز. فإذا كان وقت الجهاز خاطئًا، فكل مسح عليه يكون خاطئًا، ولن تصلح أي عملية فرز ذلك. تأكد من أن كل جهاز يحتوي على التاريخ والوقت والمنطقة الزمنية الصحيحة، وتحقق منها بعد انقطاع الكهرباء أو تحديثات البرامج الثابتة. |
05 · تطبيق القواعد معًا
مثال عملي: موظف واحد ويوم فوضوي
إليك يومًا واقعيًا للموظف رقم 2 في موقع Burj Khalifa، معروضًا بالترتيب الذي وصلت به الأحداث إلى الخادم. انقطع اتصال الموقع لجزء من اليوم.
| وقت الوصول | 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 | وصل متأخرًا من فترة الانقطاع: يُوضع قبل 13:35 حسب LogTime |
| 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 لتحميل السجلات | تتيح لك جلب سجلات الأجهزة عند الطلب لإجراء المطابقة وسد أي فجوات |
| مطالبات مولّد الشيفرة بالذكاء الاصطناعي | توليد مستقبِل رد اتصال يتحقق من الرموز ويسجل كل حدث، جاهز لإضافة القواعد الواردة في هذا الدليل |
|
من يفعل ماذا تُسلّم Cams Gateway كل مسح موثّق مع المعلومات اللازمة لتنظيفه. ويتم إزالة التكرارات التقنية في المستقبِل الخاص برد الاتصال لديك. أما دمج المسحات المزدوجة، وإقران التسجيلات، وحساب الساعات، فتنتمي إلى نظام الموارد البشرية HRMS، أو الرواتب، أو منطق الحضور لديك، حيث توجد قواعد عملك بالفعل. |
الأسئلة الشائعة
|
هل يجب أن يرفض المستقبِل لديّ الأحداث المكررة برسالة خطأ؟ لا. أرسل رد done للأحداث المكررة أيضًا. فالحدث وصل بأمان بالفعل، وقد يؤدي رد الخطأ إلى إعادة إرساله. فقط تخطَّ حفظه. |
|
هل يمكنني استخدام LogTime وحده لاكتشاف التكرارات؟ لا، ليس وحده. يمكن لشخصين مختلفين أن يسجلا الحضور في الثانية نفسها. استخدم OperationID للأحداث المعاد إرسالها، ومجموعة UserId وLogTime وSerialNumber للاستيرادات. |
|
ما المدة المناسبة لنافذة المسح المزدوج؟ يجب أن تكون طويلة بما يكفي لالتقاط الضغطات المتكررة العرضية، وقصيرة بما يكفي كي لا تدمج تسجيلات منفصلة حقيقية. تناسب نافذة من دقيقة إلى دقيقتين معظم أماكن العمل، لكن اختر ما يناسب ورديات عملك وتخطيط موقعك. |
|
متى ينبغي قفل حضور يوم ما؟ بعد فترة تسوية تسمح بوصول الأحداث المتأخرة، مثلًا في صباح اليوم التالي أو قبل تشغيل الرواتب مباشرة. وحتى ذلك الحين، أعد الحساب كلما وصلت أحداث جديدة لذلك اليوم. |
|
هل ينطبق هذا على مسح الوجه والبطاقة ورمز PIN أيضًا؟ نعم. تصل كل أنواع المدخلات بتنسيق الحدث نفسه، مع حقلي OperationID وLogTime نفسيهما، لذلك تنطبق القواعد نفسها بغض النظر عن طريقة التحقق من الشخص. |
الخلاصة: الثقة تأتي من القواعد، لا من الحظ
أحداث التسجيل المكررة والواردة خارج الترتيب ليست حالات نادرة هامشية. إنها جزء طبيعي من تشغيل تسجيل الحضور بالبصمة عبر أجهزة حقيقية، وشبكات حقيقية، وأشخاص حقيقيين. والفرق بين بيانات الحضور التي تثق بها الموارد البشرية والبيانات التي تسبب النزاعات ليس الحظ. بل هو مجموعة صغيرة من القواعد الواضحة، تُطبق باتساق.
تجاهل OperationID المكررة. رتّب كل شيء حسب LogTime. عامل التكرارات البشرية كقواعد عمل، لا كأخطاء تقنية. احسب بعد التأخير، وسجّل كل تصحيح، وحافظ على دقة ساعات الأجهزة. ومع وجود هذه القواعد، يصبح كل مسح موثّق سجلًا موثوقًا.
تمنحك Cams Biometrics Gateway البيانات اللازمة لتطبيق هذه القواعد. يحمل كل حدث Callback معرّف OperationID، وLogTime مع فرق المنطقة الزمنية، وتفاصيل المستخدم والجهاز والموقع اللازمة لتحديد كل مسح، من أجهزة تتجاوز 15 علامة تجارية. تحمي ذاكرة التخزين المؤقت وقائمة الانتظار دون اتصال الأحداث أثناء الانقطاعات، وتتيح لك عمليات RESTful المطابقة مع سجلات الأجهزة متى احتجت إليها. استكشف المنصة على CamsBiometrics.com، واقرأ وثائق Web API الكاملة على developer.camsbiometrics.com، وأنشئ مستقبِل رد الاتصال الخاص بك باستخدام مطالبات مولّد الشيفرة بالذكاء الاصطناعي.