دمج نظام سند للموارد البشرية مع أجهزة الحضور البيومترية

الخلفية

تُعد سجلات الدخول والخروج من جهاز البصمة (Attendance Punch Logs) عبارة عن سجلات دخول وخروج الموظف. يحتوي نظام سند للموارد البشرية على إمكانية لتخزين هذه السجلات في مستند يسمى تسجيل دخول الموظف.

يمكن بعد ذلك تسجيل الحضور بناءً على سجلات تسجيل دخول الموظف ونوع الشفت الخاص بالموظف باستخدام ميزة الحضور التلقائي.

وبالتالي، يمكن دمج جهاز الحضور البيومتري الخاص بك (أو أي نظام تحكم في الوصول يجمع سجلات الدخول/الخروج) باتباع الخطوات التالية:

1. إعداد الحضور التلقائي لتسجيل الحضور من سجلات تسجيل دخول الموظف

قبل استيراد أو مزامنة سجلات الدخول والخروج للموظفين في نظام سند للموارد البشرية، يجب أولاً إعداد الموظفين ومناوباتهم لتتمكن من توليد الحضور باستخدام ميزة الحضور التلقائي.

يرجى الرجوع إلى الرابط التالي لإعداد الحضور التلقائي: إعداد الحضور التلقائي

بعد إعداد سجل الموظف وتعيين المناوبات للموظفين، يمكنك الانتقال للخطوة التالية.

2. ملء سجلات البصمة في مستند تسجيل دخول الموظف في نظام سند

اعتمادًا على نظام البصمة وميزاته، هناك عدة طرق يمكنك من خلالها تعبئة سجلات البصمة في نظام سند للموارد البشرية:

1. استخدام أداة استيراد البيانات

• الحل الأبسط (من حيث تعقيد التنفيذ) هو إنشاء ملف Excel/CSV يحتوي على سجلات الدخول والخروج، واستخدام أداة استيراد البيانات المدمجة في نظام سند لاستيراد السجلات دوريًا إلى مستند تسجيل دخول الموظف.

• يرجى مراجعة الوثائق الخاصة بأداة استيراد البيانات لمزيد من التفاصيل حول كيفية القيام بذلك.

2. دمج عبر API

• يمكنك أتمتة عملية مزامنة سجلات البصمة عن طريق دمجها مع API المتاحة في نظام سند للموارد البشرية.
• تتطلب هذه الطريقة معرفة تقنية، ومن الأفضل التواصل مع مسؤول نظام سند أو بائع أجهزة البصمة.
• الخطوات:

1. أنشئ مستخدمًا في نظام سند ليتم استخدامه لإنشاء السجلات، لأن طريقة API تتطلب تسجيل الدخول. تأكد من أنهذا المستخدم لديه جميع الصلاحيات اللازمة لإنشاء تسجيل دخول الموظف.

2. أنشئ مفتاح API وAPI Secret للمستخدم لاستخدامهما في المصادقة.

3. تأكد من تعيين معرف جهاز الحضور للموظفين بناءً على جهاز البصمة المستخدم.

4. تفاصيل تنفيذ API يمكن الاطلاع عليها هنا، ويمكن الوصول إلى API عبر: /api/method/hrms.hr.doctype.employeecheckin.employeecheckin.addlogbasedonemployee_field

5. يمكنك كتابة سكريبت لإرسال طلب POST إلى API. تقوم هذه النقطة بتحديد الموظف المناسب باستخدام قيمة حقل الموظف وإنشاء سجل تسجيل دخول الموظف.

تفاصيل نقاط API:

• URL: /api/method/hrms.hr.doctype.employeecheckin.employeecheckin.addlogbasedonemployee_field
• Method: POST

• Params:

• employeefieldvalue: قيمة البحث في حقل الموظف (معرف جهاز الحضور في سجلات البصمة ومحدد في سجل الموظف).

• timestamp: الطابع الزمني للسجل، بصيغة نصية مثل: '2022-04-08 10:48:08.000000'

• device_id (اختياري): الموقع / معرف الجهاز.

• log_type (اختياري): اتجاه الضربة إذا كان متاحًا (IN/OUT).

• skipautoattendance (اختياري): لتخطي الحضور التلقائي لهذا السجل (0/1).

• employeefieldname (الافتراضي: attendancedevice_id): اسم الحقل في مستند الموظف للبحث.

• latitude (اختياري): خط العرض لموقع الشفت إذا تم تعيينه.

• longitude (اختياري): خط الطول لموقع الشفت إذا تم تعيينه.

• Response: يعيد مستند تسجيل دخول الموظف الذي تم إدخاله.

3. إعداد سكريبت Python لتكامل أجهزة ZKTeco أو ما يشابهها

• تعمل هذه الطريقة فقط مع أجهزة ZKTeco أو الأجهزة المشابهة التي تستخدم ZKProtocol للتواصل عبر TCP/IP.
• السكريبت متاح على: github:frappe/biometric-attendance-sync-tool.
• اتبع التعليمات في صفحة السكريبت لإعداده على جهاز الكمبيوتر الخاص بك.
• يقوم هذا السكريبت بسحب سجلات البصمة من جهاز مدعوم واستخدام API المذكورة لدفع البيانات إلى نظام سند.

الأسئلة الشائعة

1. كيف أختار جهاز بصمة متوافق مع نظام سند؟

• إذا كنت تستخدم الطريقة 1 أو 2، لا داعي للقلق بشأن التوافق.
• بالنسبة للطريقة الثالثة، يستخدم التطبيق الداخلي للبيومترية سكريبت متوافق مع الأجهزة المدرجة هنا. عادةً أي جهاز ZKTeco أو مشابه يستخدم ZKProtocol عبر TCP/IP سيكون متوافقًا. يُنصح بتجربة الجهاز مع البائع قبل الشراء إذا أمكن، لضمان التوافق مع أداة المزامنة.

2. كيف أعرف أي طريقة أستخدم لدمج جهاز البصمة مع نظام سند؟

• الطريقة 1 صالحة في جميع الحالات لكنها تتطلب الاستيراد اليدوي الدوري للسجلات.
• الطريقتان 2 و3 تحتاجان إلى إعداد مرة واحدة ومراقبة لاحقة لأتمتة مزامنة السجلات.

إعداد موقع واحد:

• في طريقة Push Biometric Device، يجب أن يكون الجهاز قادرًا على التواصل مع جهاز البصمة عبر TCP/IP، ويفضل تشغيله على نفس شبكة LAN الخاصة بالجهاز. يستخدم النظام API لمزامنة السجلات إلى نظام سند، ويعمل بشكل أفضل عند إعداد موقع واحد.

إعداد متعدد المواقع:

• في هذه الحالة، نوصي عادة بالطريقة 2 حيث يوفر معظم بائعي البصمة خدمات لمزامنة سجلات أجهزة البصمة من مواقع متعددة عبر API.

• يمكن للطريقة 3 أيضًا العمل إذا كانت لديك خبرة في الشبكات.