مسؤولو الموارد البشرية
اعرف أي تصدير تسحبه من برنامج الجهاز قبل أول استيراد شهري، وافهم سبب رفض الملف.
صيغ ملفات أجهزة البصمة وتحويلها إلى Excel
أغلب برامج الحضور والانصراف بالبصمة تصدّر الملف بصيغة Excel أو CSV، لكن أسماء الأعمدة تختلف من برنامج لآخر ومن إصدار لآخر. يوضّح هذا الدليل شكل الأعمدة التي يُختبر عليها محلل وثيقة في أجهزة ZKTeco وHikvision وDahua وAnviz وSuprema وFingerTec وMatrix COSEC وeSSL، وما الذي يقرأه من كل منها، ولماذا قد يُرفض الملف. يتعرّف المحلل على الصيغ الشائعة، فاختبر ملفك الحقيقي.
صيغ التصدير حسب برنامج الجهاز
ZKTeco (تصدير BioTime وبرامج ZKTime)
التصدير: يشير دليل الاستيراد لدينا إلى قائمة التقارير ثم الحضور (Reports > Attendance) مع التصدير بصيغة CSV، وأسماء القوائم تتغيّر بين إصدارات البرنامج، فاستخدم عمومًا تصدير الحضور أو الحركات إلى Excel أو CSV. شكل الأعمدة المغطى بالاختبارات: AC-No. وName وDate وTime وState. يقرأ وثيقة AC-No. كرقم الموظف، وعمودَي التاريخ والوقت، وState كعلامة دخول أو خروج (تُعرف قيم مثل Check In وCheck Out وC/In وC/Out و0 و1). الفخ الشائع: بعض تصديرات ZKTeco بصيغة XLS تضع التاريخ والوقت كاملين في عمود Time، ويكتشف وثيقة ذلك ويقرؤه كبصمة واحدة، فلا تقسّم العمود ولا تعدّله قبل الرفع.
Hikvision (عمود Person ID مع أعمدة الدخول والخروج)
التصدير: استخدم تصدير الحضور أو الأحداث من برنامج الجهاز إلى Excel أو CSV. شكل الأعمدة المغطى بالاختبارات: Person ID وName وDepartment وCheck-in Time وCheck-out Time. يقرأ وثيقة Person ID كرقم الموظف، وعمودَي الدخول والخروج كدخول اليوم وخروجه. الفخ الشائع: إذا كان في الملف عمودا دخول وخروج فلا بد من عمود تاريخ مستقل مثل Date أو Attendance Date أو Event Date، وإلا يُرفض الملف برسالة «لم نجد عمود تاريخ الحضور». وإذا وُجد عمود Access Result فتُحتسب فقط الصفوف الناجحة (granted أو allowed أو success)، لأن محاولات الدخول المرفوضة ليست حضورًا.
Dahua (تصدير بصمات بنمط SmartPSS)
التصدير: استخدم تصدير الحضور أو الحركات إلى Excel أو CSV. شكل الأعمدة المغطى بالاختبارات: UserID وName وTime وType. يقرأ وثيقة UserID كرقم الموظف، وTime كتاريخ ووقت البصمة، وType كاتجاه البصمة. الفخ الشائع: إذا احتوى Type على رموز ليست قيم دخول وخروج معروفة يُرفض الملف برسالة «رموز اتجاه البصمة غير معروفة» بدل التخمين. أعد التصدير بقيم دخول وخروج واضحة.
Anviz (تصدير CrossChex وتصدير User ID)
التصدير: استخدم تصدير سجل الحضور من CrossChex إلى Excel أو CSV. الشكلان المغطيان بالاختبارات: EnNo وName وDateTime وMode، والثاني No. وUser ID وName وDept وDevice No. وRecord Type وVerify Mode وTime. يقرأ وثيقة EnNo أو User ID كرقم الموظف، وDateTime أو Time كوقت البصمة. الفخ الشائع: عمود No. في البداية رقم تسلسلي للسجل وليس رقم الموظف. عندما يكون User ID معبّأً يُفضَّل على No.، ولا يُستخدم No. إلا إن لم يوجد غيره. وعمودا Mode وRecord Type ليسا من أعمدة الاتجاه التي يبحث عنها المحلل، فتُعدّ أول بصمة في اليوم دخولًا وآخر بصمة خروجًا.
Suprema (سجل أحداث BioStar 2)
التصدير: استخدم تصدير الأحداث أو تقرير الحضور من BioStar 2 إلى Excel أو CSV. شكل الأعمدة المغطى بالاختبارات: User ID وName وDatetime وDevice وEvent. يقرأ وثيقة User ID والاسم وعمود Datetime المدمج، وEvent كاتجاه للبصمة، وتُعرف القيمتان T&A In وT&A Out. الفخ الشائع: سجل الأحداث الخام قد يخلط بصمات الحضور بأحداث أخرى. إذا وُجد عمود Access Result تُحتسب فقط الصفوف الناجحة، وإذا كانت قيمة Event ليست رمز دخول أو خروج معروفًا يُرفض الملف.
FingerTec (تصدير TCMS)
التصدير: استخدم تصدير سجل الحضور من TCMS إلى Excel أو CSV. شكل الأعمدة المغطى بالاختبارات: User ID وName وDate وTime. يقرأ وثيقة User ID كرقم الموظف مع عمودَي التاريخ والوقت المنفصلين. الفخ الشائع: هذا الشكل لا يحتوي على عمود دخول أو خروج، فتُعدّ أول بصمة في اليوم دخولًا وآخر بصمة خروجًا. واليوم الذي فيه بصمة واحدة بلا خروج يظهر كبصمة ناقصة لمراجعة الموارد البشرية، وليس كغياب مؤكد.
Matrix COSEC (أعمدة In Time وOut Time اليومية)
التصدير: استخدم تصدير تقرير الحضور من COSEC إلى Excel أو CSV. شكل الأعمدة المغطى بالاختبارات: Employee Code وEmployee Name وDate وIn Time وOut Time. يقرأ وثيقة Employee Code كرقم الموظف، بصف لكل موظف في كل يوم، وIn Time وOut Time كوقتَي اليوم. الفخ الشائع: هذا تقرير يومي، فيجب أن يبقى عمود Date في الملف. ولا مشكلة في بضعة أسطر عنوان فوق صف العناوين، لأن صف العناوين يُبحث عنه في أول عشرة صفوف.
eSSL (برنامج eTimeTrackLite)
التصدير: استخدم تصدير سجل الحضور من eTimeTrackLite إلى Excel أو CSV. شكل الأعمدة المغطى بالاختبارات: EmployeeCode وEmployeeName وDateTime. يقرأ وثيقة EmployeeCode كرقم الموظف وDateTime كوقت البصمة. مطابقة العناوين تتجاهل المسافات والنقاط والشرطات والشرطة السفلية، فـ EmployeeCode وEmployee Code سواء عند المحلل. الفخ الشائع: لا يوجد عمود دخول وخروج، فتحدّد أول بصمة وآخر بصمة في اليوم الدخول والخروج، وأي بصمة زائدة بالخطأ تغيّر النتيجة.
ملفات USB وTXT وDAT العامة
التصدير: استخدم التنزيل عبر USB من الجهاز أو تصدير برنامجه، واحتفظ بالملف كما خرج دون تعديل. الشكل المعتاد: PIN وDateTime وStatus وVerify وDeviceID. يقرأ وثيقة ملفات txt وcsv وtsv وdat ويجرّب الفاصلة والتبويب والفاصلة المنقوطة والخط العمودي. الفخ الشائع: لا بد من صف عناوين. الملف الخام الذي أول صف فيه بصمة فعلية يُرفض لأنه بلا صف عناوين؛ أضف سطر عناوين في أعلاه، مثل ID وDateTime وStatus، ثم ارفعه من جديد. تُقرأ القيمتان 0 و1 في Status كدخول وخروج، وتُرفض الرموز الأخرى.
المميزات
| الميزة | الوصف |
|---|---|
| عمود رقم الموظف | يتعرّف على أعمدة مثل AC-No وPerson ID وUser ID وEnNo وEmployee Code وEmployee Number وPIN وCard No وID Number وما يشبهها، إضافة إلى الأسماء العربية. وإذا وُجد CardNo وID Number وكان CardNo فارغًا في كل الصفوف يُستخدم عمود ID Number المعبّأ. |
| الملخص اليومي مقابل البصمات الخام: ما يُقرأ | يُقرأ ملف البصمات الخام (صف لكل بصمة، بعمود تاريخ ووقت مدمج أو عمودين منفصلين) ويُقرأ التقرير اليومي (صف لكل موظف في كل يوم مع عمود تاريخ وعمودَي دخول وخروج). |
| الملخص اليومي مقابل البصمات الخام: ما يُرفض | الملخص الذي لا يحتوي على أوقات كل بصمة أو كل يوم، مثل إجماليات الشهر (أيام الحضور وعدد التأخيرات) أو جدول بعمود لكل يوم، لا يوجد فيه ما يُحلَّل، فيُرفض برسالة «لم نجد عمود وقت البصمة». صدّر سجل البصمات الخام أو التقرير اليومي بدلًا منه. |
| معاينة قبل القرار | تعرض المعاينة حتى 20 صفًا تحت صف العناوين وحتى 40 عمودًا من أي ملف مقروء، حتى لو كان ملخصًا لا يقبله المحلل، لترى ما الذي صدّره الجهاز فعلًا. |
| العناوين العربية | تُعرف الأعمدة العربية مثل رقم الموظف واسم الموظف والتاريخ والوقت والتاريخ والحالة، وقيم البصمة مثل حضور ودخول وخروج وانصراف. وتُعامل صيغ الكتابة المختلفة (ة وه، وأشكال الهمزة) والتشكيل كحرف واحد. |
| أنواع الملفات والترميز | يقبل xlsx وxls وcsv وtxt وtsv وdat حتى 5 ميجابايت. تُقرأ ملفات CSV والنص بترميز UTF-8 أو UTF-8 مع BOM أو UTF-16. وملفات xls القديمة التي لا تعلن ترميزها تُقرأ أولًا بترميز Windows-1256 العربي ثم يُعاد المحاولة بترميز Windows-1252 إذا بدت العناوين مشوّهة. |
| التواريخ الهجرية | إذا كانت أعمدة التاريخ بسنوات في النطاق الهجري (من 1300 إلى 1500) يكتشف المحلل ذلك ويطلب منك تأكيد التقويم بدل اعتبارها تواريخ ميلادية بصمت. |
| مرفوض: لا يوجد عمود رقم الموظف | الرسالة: «لم نتعرف على عمود رقم الموظف في الملف» مع قائمة الأعمدة الموجودة. غيّر العنوان في نسخة من الملف، أو أرسل عينة إلى hello@watheeqahr.com (بعد تغيير أسماء الموظفين) وسنراجع شكل الملف. |
| مرفوض: لا يوجد تاريخ أو وقت بصمة | يُرفض الملف الذي لا يحتوي على عمود وقت البصمة، أو فيه أعمدة دخول وخروج دون عمود تاريخ. ارفع سجل الحضور وليس قائمة الموظفين. |
| مرفوض: رموز اتجاه غير معروفة | عمود نوع البصمة الذي لا تُعرف قيمه كدخول أو خروج يُرفض بدل التخمين. وإذا كانت كل القيم مجرد طريقة التحقق (FP أو Face أو Card أو Password) يُهمل العمود كاتجاه. |
| مرفوض: فارغ أو عناوين فقط أو بلا صف عناوين | الملف الفارغ، والورقة التي فيها صف عناوين بلا سجلات، والملف الذي بلا صف عناوين، والبيانات الموجودة في ورقة أخرى، لكلٍّ منها رسالة محددة. صدّر فترة فيها بصمات وارفع الملف الأصلي دون تعديل. |
| مرفوض: التاريخ أو الوقت غير مفهوم | عُرفت الأعمدة لكن لم يُستخرج أي سجل، غالبًا لأن صيغة التاريخ أو الوقت لم تُفهم. اختر صيغة التاريخ في المحلل أو ارفع التصدير الأصلي من الجهاز. |
من يستخدم هذا؟
أصحاب الشركات
حوّل ملف البصمة إلى اكسل وتقرير حضور جاهز دون إعادة كتابة البصمات من الجهاز.
مسؤولو الأجهزة والدعم الفني
اختر سجل البصمات الخام أو التقرير اليومي بدل ملخص شهري لا يمكن تحليله.
الأسئلة الشائعة
كيف أحوّل ملف البصمة إلى اكسل؟
إذا كان برنامج جهازك يصدّر Excel أو CSV، ارفع الملف إلى محلل الحضور المجاني ونزّل النتيجة كتقرير Excel. يقرأ وثيقة الملف المصدَّر ولا يتصل بالجهاز نفسه.
أين أجد تصدير تقرير الحضور من جهاز بصمة ZKTeco؟
استخدم تصدير تقرير الحضور أو الحركات في برنامج ZKTeco واختر Excel أو CSV. يذكر دليل الاستيراد لدينا قائمة التقارير ثم الحضور، لكن أسماء القوائم تختلف من إصدار لآخر، فابحث عن خيار التصدير في تقرير الحضور.
هل أصدّر الملخص اليومي أم البصمات الخام؟
الاثنان يصلحان إذا كان كل صف بصمة، أو يومًا لكل موظف مع أعمدة التاريخ والدخول والخروج. أما الإجمالي الشهري بلا أوقات يومية فيُرفض. وإن لم تكن متأكدًا فصدّر سجل البصمات الخام.
ملف CSV يظهر فيه العربي حروفًا مشوّهة، ماذا أفعل؟
تُقرأ ملفات CSV والنص بترميز UTF-8 أو UTF-16. إذا ظهرت الحروف مشوّهة فأعد التصدير بصيغة CSV بترميز UTF-8، أو افتح الملف في Excel واحفظه بصيغة xlsx ثم ارفعه.
هل يجب أن يكون جهازي من الشركات المذكورة؟
لا. تُكتشف الصيغة من الأعمدة وليس من اسم الشركة. وإذا لم يُعرف عمود ما في الاستيراد الكامل يمكنك ربطه مرة واحدة وحفظ الربط، وإذا رفض المحلل ملفك يمكنك إرسال عينة إلينا.
ما الحد الأقصى لحجم الملف؟
5 ميجابايت للملف الواحد. وللمواقع الكبيرة صدّر شهرًا واحدًا في كل مرة.
صفحات ذات صلة
ابدأ بملف الحضور الفعلي
ارفع ملف Excel أو CSV وراجع النتيجة مجانًا — دون إنشاء حساب.
حلّل ملف الحضور مجانًا إنشاء حساب مجاني