وكيل المزامنة

مزامنة تلقائية لبيانات الحضور من أجهزة ZKTeco البيومترية إلى سحابة AttendUX.

دليل الاستخدام وكيل المزامنة

نظرة عامة

وكيل مزامنة AttendUX هو تطبيق سطح مكتب خفيف لنظام Windows يربط أجهزة ZKTeco البيومترية المحلية بمنصة AttendUX السحابية.

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

نصيحة: يحتاج وكيل المزامنة للتثبيت على جهاز كمبيوتر واحد فقط متصل بنفس الشبكة المحلية لأجهزة ZKTeco.

التحميل والتثبيت

حمّل مثبت وكيل المزامنة واتبع معالج الإعداد:

1

تحميل المثبت

حمّل أحدث إصدار من وكيل المزامنة: تحميل Attendux-Sync-Agent.exe

2

تشغيل المثبت

انقر نقراً مزدوجاً على الملف المحمّل واتبع معالج التثبيت. اقبل الإعدادات الافتراضية.

3

تشغيل الوكيل

بعد التثبيت، سيبدأ وكيل المزامنة تلقائياً. ستراه في شريط النظام.

AttendUX Sync Agent — Setup

AttendUX Sync Agent

v2.1.0 · Windows Desktop

Installation Complete!
Launch Agent
Close
لقطة شاشة: مثبت وكيل المزامنة

الإعدادات

قم بتكوين وكيل المزامنة بتفاصيل الخادم ومعلومات الجهاز:

الحقل الوصف مثال
عنوان الخادمعنوان خادم AttendUX الخاص بكhttps://yourcompany.attendux.com
رمز الشركةمعرّف شركتك الفريدCOMP-001
مفتاح APIمفتاح المصادقة من الإعدادات ← التكاملاتsk_live_xxx...
فترة المزامنةكم مرة يتم مزامنة البيانات (بالدقائق)5
عنوان IP للجهازعنوان IP المحلي لجهاز ZKTeco192.168.1.201
AttendUX Sync Agent — Config
الإعدادات
https://company.attendux.com
COMP-001
sk_live_xxxxxxxxxxxxx
192.168.1.201
5 min
Connected · Last sync: 2 min ago
Save & Sync Now
لقطة شاشة: إعدادات وكيل المزامنة

كيف تعمل المزامنة

تتم عملية المزامنة وفق الخطوات التالية تلقائياً:

1

الاتصال بالجهاز

يتصل الوكيل بجهاز ZKTeco عبر الشبكة المحلية باستخدام TCP/IP.

2

جلب السجلات الجديدة

يسترجع جميع سجلات البصمة الجديدة منذ آخر مزامنة.

3

الرفع إلى السحابة

يتم إرسال السجلات بشكل آمن إلى خادم AttendUX عبر HTTPS ومطابقتها مع الموظفين تلقائياً.

نصيحة: يحتفظ وكيل المزامنة بسجل محلي لجميع عمليات المزامنة. تحقق من تبويب السجلات إذا اشتبهت في فقدان سجلات.

التشغيل كخدمة

لأقصى موثوقية، يمكنك تكوين وكيل المزامنة للعمل كخدمة Windows بحيث يبدأ تلقائياً عند تشغيل الكمبيوتر.

افتح إعدادات وكيل المزامنة وفعّل "التشغيل كخدمة Windows". هذا يضمن استمرار المزامنة حتى عندما لا يكون أي مستخدم مسجل الدخول.

تحذير: يجب أن يبقى الكمبيوتر الذي يشغّل وكيل المزامنة قيد التشغيل ومتصلاً بنفس شبكة أجهزة ZKTeco.

استكشاف الأخطاء

مشاكل المزامنة الشائعة وكيفية حلها:

لا يمكن الاتصال بالجهاز

تحقق من صحة عنوان IP للجهاز، وتأكد من أن الجهاز مشغّل، وأن الكمبيوتر والجهاز على نفس الشبكة. جرّب عمل ping لعنوان IP.

لا يتم مزامنة أي بيانات

تأكد من صحة مفتاح API وأنه غير منتهي. تحقق من أن عنوان الخادم يتضمن https://. تأكد من وجود سجلات حضور جديدة على الجهاز.

ظهور سجلات مكررة

يحتوي الوكيل على نظام إزالة تكرار مدمج. إذا ظهرت سجلات مكررة، امسح ذاكرة التخزين المؤقت وأعد المزامنة. تأكد من تشغيل نسخة واحدة فقط من الوكيل.