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 پاسخ دهید
درون‌ریزی همپوشان رویدادی که از طریق callback دریافت شده، در جریان مغایرت‌گیری دوباره درون‌ریزی می‌شود UserId، LogTime و SerialNumber یکسان، از منبعی متفاوت نسخه دوم را نادیده بگیرید
اسکن دوگانه فردی ظرف چند ثانیه دو بار دستگاه اسکن را لمس می‌کند OperationID های متفاوت، همان فرد، و LogTime هایی که بسیار به هم نزدیک هستند با استفاده از یک قاعده حداقل فاصله، به عنوان یک ثبت واحد در نظر گرفته شود
ثبت با برچسب اشتباه فردی دکمه ورود را فشار می‌دهد در حالی که قصد خروج داشته است دو ورود پشت سر هم بدون خروج بین آن‌ها هنگام محاسبه ساعات کاری، یک قاعده جفت‌سازی اعمال شود

موارد تکراری فنی در برابر موارد تکراری انسانی

دو نوع اول فنی هستند: همان اسکن است که دو بار توسط سیستم شما دیده شده و باید به سادگی نادیده گرفته شوند. دو نوع آخر انسانی هستند: آن‌ها اسکن‌های واقعی و جداگانه‌ای هستند و تعیین معنای آن‌ها یک قاعده کسب‌وکار است. این دو نوع مدیریت را از هم جدا نگه دارید. دریافت‌کننده شما باید فقط موارد تکراری فنی را حذف کند. منطق حضور و غیاب شما باید تعیین کند که موارد تکراری انسانی به چه معناست.

چرا ارسال مجدد رخ می‌دهد

callback یک گفتگو است: Gateway رویدادی را ارسال می‌کند و سرور شما با تأییدیه done پاسخ می‌دهد. اگر پاسخ هرگز نرسد، مثلاً به دلیل کندی، راه‌اندازی مجدد یا در دسترس نبودن موقت سرور شما، ممکن است رویداد دوباره ارسال شود. سرور شما ممکن است نسخه اول را قبلاً ذخیره کرده باشد. به همین دلیل قاعده همیشه یکسان است: اگر قبلاً OperationID را دیده‌اید، آن را دوباره ذخیره نکنید، اما با done پاسخ دهید تا Gateway بداند رویداد دریافت شده است. رفتار دقیق ارسال مجدد برای تنظیمات خود را در مستندات Cams Web API تأیید کنید.

پاسخی که دریافت‌کننده شما برای هر رویداد، از جمله موارد تکراری، ارسال می‌کند

{ "status": "done" }

03 · ترتیب دریافت، ترتیب واقعی نیست

چرا رویدادهای ثبت خارج از ترتیب می‌رسند

سرور شما رویدادها را به ترتیب رسیدن دریافت می‌کند. اما حضور باید بر اساس ترتیب اسکن محاسبه شود. در بیشتر مواقع این دو یکسان هستند. اما گاهی این‌طور نیست.

علت چه اتفاقی می‌افتد مثال
دستگاه یا سایت آفلاین می‌شود دستگاه‌ها اسکن‌ها را به صورت محلی ثبت می‌کنند و سپس همه آن‌ها را پس از برقراری مجدد اتصال ارسال می‌کنند خروج ساعت 13:01 پس از یک اسکن ساعت 13:35 از دستگاه دیگر، در ساعت 13:41 می‌رسد
تأخیر شبکه رویدادهای دستگاه‌های مختلف مسیرهای متفاوتی را طی می‌کنند و زمان‌های متفاوتی می‌برند دو اسکن با یک ثانیه فاصله، به ترتیب معکوس می‌رسند
چند دستگاه برای هر فرد کارمندی در دروازه اصلی ورود ثبت می‌کند و در یک درب جانبی خروج می‌کند رویدادهای دو دستگاه به صورت نامنظم با یکدیگر درهم می‌آمیزند
درون‌ریزی‌های مغایرت‌گیری اسکن‌های گم‌شده بعداً از لاگ‌های دستگاه تکمیل می‌شوند رویدادی از دوشنبه روز سه‌شنبه به سیستم شما اضافه می‌شود

خود داده‌های پیام تفاوت را نشان می‌دهند. LogTime زمان وقوع اسکن است. Time زمان‌مهر خود پیام به وقت GMT است. در نمونه داده بالا، اسکن ساعت 07:48 به وقت محلی انجام شده، اما پیام ساعت 04:19 به وقت GMT ارسال شده است که معادل ساعت 09:49 در همان منطقه زمانی و دو ساعت بعد است. این فاصله دقیقاً چیزی است که یک دوره آفلاین به نظر می‌رسد. اگر بر اساس زمان دریافت مرتب کنید، آن اسکن در جای اشتباهی قرار می‌گیرد.

زمان دریافت نشان می‌دهد که سرور شما چه زمانی از وقوع آن مطلع شده است. LogTime نشان می‌دهد که رویداد چه زمانی اتفاق افتاده است. حضور و غیاب همیشه باید از LogTime پیروی کند.

04 · هشت قاعده

راهنمای داده‌های پاکیزه حضور و غیاب

این هشت قاعده همه موارد بالا را پوشش می‌دهند. چهار قاعده اول به دریافت‌کننده callback و ذخیره‌سازی شما مربوط هستند. چهار قاعده آخر به منطقی مربوط می‌شوند که رویدادهای ذخیره‌شده را به داده‌های حضور تبدیل می‌کند.

1

ابتدا هر رویداد خام را ذخیره کنید

هر payload را دقیقاً همان‌طور که دریافت شده، قبل از هر کار دیگری ذخیره کنید. اگر بعداً مشخص شود که یک قاعده اشتباه بوده است، می‌توانید از داده‌های خام دوباره پردازش انجام دهید.

2

OperationID های تکراری را نادیده بگیرید

OperationID را در ذخیره‌سازی خود یکتا کنید. اگر همان OperationID دوباره دریافت شد، از ذخیره آن صرف‌نظر کنید و همچنان با done پاسخ دهید.

3

برای درون‌ریزی‌ها از کلید طبیعی استفاده کنید

برای رویدادهایی که در جریان مغایرت‌گیری درون‌ریزی می‌شوند، ترکیب UserId، LogTime و SerialNumber را به عنوان هویت اسکن در نظر بگیرید تا یک اسکن از دو منبع هرگز دو بار ذخیره نشود.

4

همیشه بر اساس LogTime مرتب کنید، نه بر اساس زمان دریافت

LogTime را همراه با اختلاف منطقه زمانی آن تجزیه کنید و هنگام محاسبه حضور، همیشه بر اساس آن مرتب کنید.

5

محاسبه را به تأخیر بیندازید، نه در لحظه دریافت

ساعات یک روز را لحظه‌ای که خروجی دریافت می‌شود نهایی نکنید. هنگام رسیدن رویدادهای تأخیری دوباره محاسبه کنید و تنها پس از یک بازه تثبیت، مانند قبل از اجرای حقوق و دستمزد، روز را قفل کنید.

6

اسکن‌های دوگانه را با حداقل فاصله ادغام کنید

اسکن‌های یک فرد در یک بازه کوتاه، مثلاً دو دقیقه، را به عنوان یک ثبت واحد در نظر بگیرید. بازه‌ای را انتخاب کنید که با محیط کاری شما مناسب باشد.

7

ثبت‌ها را با یک قاعده مشخص جفت کنید

تصمیم بگیرید که ثبت‌های با برچسب اشتباه را چگونه مدیریت کنید، مانند جفت‌سازی اسکن‌ها بر اساس ترتیب زمانی، یا استفاده از اولین اسکن به عنوان ورود و آخرین اسکن به عنوان خروج. همین قاعده را در همه جا اعمال کنید.

8

از هر اصلاحی سابقه نگه دارید

هرگاه قاعده‌ای یک اسکن را ادغام، نادیده یا دوباره برچسب‌گذاری کند، آنچه رخ داده و دلیل آن را ثبت کنید. منابع انسانی و حسابرسان باید ببینند که چگونه اسکن‌های خام به ساعات کاری تبدیل شده‌اند.

ساعت دستگاه‌ها را دقیق نگه دارید

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 با تأخیر از دوره آفلاین رسید: بر اساس 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 برای بارگذاری لاگ‌ها به شما امکان می‌دهد لاگ‌های دستگاه را در صورت نیاز دریافت کنید تا مغایرت‌گیری کرده و هر شکافی را پر کنید
پرامپت‌های تولید کد با هوش مصنوعی یک دریافت‌کننده callback تولید می‌کند که توکن‌ها را اعتبارسنجی کرده و همه رویدادها را ثبت می‌کند، و آماده است تا قواعد این راهنما را به آن اضافه کنید

هر بخش چه مسئولیتی دارد

Cams Gateway هر اسکن تأییدشده را همراه با اطلاعات لازم برای پاکسازی آن تحویل می‌دهد. حذف موارد تکراری فنی در دریافت‌کننده callback شما انجام می‌شود. ادغام اسکن‌های دوگانه، جفت‌سازی ثبت‌ها و محاسبه ساعات کاری در 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 بخوانید و دریافت‌کننده callback خود را با پرامپت‌های تولید کد با هوش مصنوعی تولید کنید.

Was this article helpful?