الموصّل هو برنامج ويندوز الصغير الذي يقرأ أجهزة الحضور ويرسل البصمات إلى SolaHR. تشرح هذه الصفحة التنزيل والتثبيت والربط والتحديث والإزالة، وما يجب فحصه عند تعطل شيء. وإذا أردت الفكرة أولًا فاقرأ النظرة العامة.
نسخة تجريبية. بُني الموصّل وفُحص على المحاكيات وعلى طراز جهاز حقيقي واحد. وهو غير موقّع رقميًا بعد، لذا سيحذّرك ويندوز عند تشغيله. جرّبه أولًا على كمبيوتر واحد وجهاز واحد.
#قبل أن تبدأ
| المتطلبات | التفاصيل |
|---|---|
| كمبيوتر أو خادم ويندوز | ويندوز 10 أو 11، أو ويندوز سيرفر 2016 وما بعده، 64 بت. ويندوز 7/8 وويندوز 32 بت ومعالجات ARM غير مدعومة. |
| يعمل دائمًا | يجب أن يبقى الكمبيوتر مشغَّلًا ومستيقظًا في الشبكة نفسها (والـVLAN نفسه) مع الأجهزة. يكفي كمبيوتر مكتبي صغير أو خادم. |
| صلاحيات المسؤول | للتثبيت، ولاحقًا لتسجيل حزمة SDK للمصنّع. |
| الإنترنت | HTTPS صادر إلى عنوان SolaHR لديك (مثل https://solavel.com/hr). لا حاجة إلى منفذ وارد. |
| مستخدم SolaHR يستطيع إدارة الأجهزة | المالك أو مدير الموارد البشرية. |
| عنوان IP للجهاز | ومفتاح الاتصال إن كان له مفتاح. راجع إضافة جهاز. |
لا حاجة إلى عتاد خاص؛ يكفي كمبيوتر مكتبي عادي (لم ننشر حدودًا دنيا مقيسة بعد).
#اختيار حزمة
في SolaHR افتح الوقت والحضور ← أجهزة الحضور ← أجهزة الربط ← إضافة جهاز ربط. يُعرض تنزيلان لويندوز 10 / 11 · 64 بت، لكلٍّ منهما إصداره وحجمه.
| الحزمة | ما هو هذا الرابط | استخدمه عندما |
|---|---|---|
برنامج تثبيت ويندوز .exe (موصى به) |
يثبّت الموصّل كـخدمة ويندوز: تبدأ تلقائيًا عند الإقلاع، وتعيد تشغيل نفسها بعد أي عطل، وتحتفظ ببياناتها عند الترقية. | استخدام عادي. |
| ZIP محمول | دون برنامج تثبيت. فك الضغط وشغّل install.cmd، فيسجّل مهمة مجدولة تشغّل الموصّل عند الإقلاع. وهي ليست خدمة ويندوز. |
اختبار سريع، أو كمبيوتر لا يمكن تشغيل برنامج تثبيت عليه. |
كلاهما مُعلَّم نسخة تجريبية. وإذا قالت الصفحة «سيتوفر برنامج تثبيت ويندوز هنا قريبًا.» فلم تُنشر أي حزمة بعد.
تحقق من تنزيلك. تحت التفاصيل تجد ملاحظات الإصدار وأمر PowerShell. شغّله وقارن: يجب أن تساوي نتيجة Get-FileHash قيمة SHA-256 المعروضة في الصفحة.
#التثبيت والربط خطوة بخطوة
- شغّل برنامج التثبيت كمسؤول (انقر بزر الفأرة الأيمن، تشغيل كمسؤول). وللـZIP: انقر بالزر الأيمن على الملف، استخراج الكل، وانقر مرتين على
install.cmdوأجب نعم. - SmartScreen. لأن النسخة التجريبية غير موقّعة، قد يعرض ويندوز «Windows protected your PC». بعد التحقق من SHA-256 انقر مزيد من المعلومات ثم تشغيل على أي حال. يزول هذا التحذير عند توقيع البرنامج؛ وحتى ذلك الحين هو متوقع ولا يدل على مشكلة.
- تُفتح صفحة الموصّل في متصفحك على العنوان
http://127.0.0.1:8790. وهذه الصفحة متاحة على ذلك الكمبيوتر فقط. وفي قائمة ابدأ أيضًا SolaHR Device Connect. - احصل على رمز ربط. في SolaHR انقر إضافة جهاز ربط وانسخ رمز الربط. يعمل مرة واحدة وتنتهي صلاحيته بعد 15 دقيقة؛ أنشئ رمزًا جديدًا إن انتهى.
- اربط. في صفحة الموصّل أدخل عنوان SolaHR لديك (مثل
https://solavel.com/hr) والرمز، ثم اضغط Pair. - في SolaHR يظهر الموصّل متصل خلال دقيقة. الآن أضف جهازًا وعيّنه لهذا الموصّل.
لفرق تقنية المعلومات، يعمل برنامج التثبيت أيضًا بصمت، مع العنوان والرمز اختياريًا:
SolaHR-Device-Connect-Setup-<version>.exe /S /SERVER=https://solavel.com/hr /CODE=<pairing code>
#ما يضعه برنامج التثبيت على الكمبيوتر
| البند | أين |
|---|---|
| البرنامج | C:\Program Files\SolaHR Device Connect |
| خدمة ويندوز | SolaHRDeviceConnect (بدء تلقائي، يعيد تشغيل نفسه بعد أي عطل) |
| البيانات: الإعدادات والأسرار المشفّرة والبصمات التي لم تُرسل بعد والسجلات | C:\ProgramData\SolaHR Device Connect (مقروء لمسؤولي ويندوز والنظام فقط) |
| الصفحة المحلية | http://127.0.0.1:8790 (هذا الكمبيوتر فقط) |
| أداة سطر الأوامر | solahr-dc (pair, status, diagnostics, run, version) |
تحقق من أنه يعمل: في موجه أوامر ويندوز يجب أن يقول sc query SolaHRDeviceConnect RUNNING.
#جدار الحماية والشبكة
| الاتجاه | ماذا | ملاحظات |
|---|---|---|
| كمبيوتر الموصّل إلى SolaHR | HTTPS (443) | صادر فقط. إذا كان مكتبك يستخدم وسيطًا أو يرشّح المواقع فاسمح بعنوان SolaHR لديك. |
| كمبيوتر الموصّل إلى جهاز ZKTeco | TCP وUDP 4370 | المنفذ الخاص بالجهاز. |
| من حاسوب الموصّل إلى جهاز Anviz | TCP 5010 | منفذ Anviz الافتراضي؛ تحقق منه على الجهاز. |
| من حاسوب الموصّل إلى جهاز Hikvision | HTTP/HTTPS (منفذ الويب الخاص بالجهاز، وهو 80 افتراضيًا) | |
| من حاسوب الموصّل إلى خادم Suprema BioStar 2 | HTTPS (443 افتراضيًا) | يقرأ عبر خادم BioStar 2 لا عبر الجهاز. |
| من الأجهزة الأخرى إلى حاسوب الموصّل | لا شيء | لا شيء يتصل بـ الموصّل. |
يسمح جدار حماية Windows عادةً بالاتصالات الصادرة. وإذا كانت شبكتك تفصل الحاسوب عن الأجهزة (شبكات VLAN مختلفة)، فاسمح بهذه المنافذ بينها.
#صفحة الموصّل
افتح http://127.0.0.1:8790 (أو عنصر قائمة ابدأ). تعرض الصفحة هل الموصّل مقترن ومتصل، وأجهزته، وعدد البصمات المنتظرة للإرسال. وتعمل بالإنجليزية والعربية، بالوضع الفاتح والداكن. وتتيح أيضًا:
- البحث عن الأجهزة: بحث للقراءة فقط في الشبكة المحلية عن الأجهزة المدعومة. وتظهر النتائج في SolaHR ضمن اكتشفها الموصّل لديك.
- إعداد البرنامج المطلوب: إعداد موجَّه لـ SDK الخاص بالمصنّع. راجع إعداد SDK الخاص بالمصنّع.
- السماح بإجراء تغييرات على الأجهزة: معطّل افتراضيًا. وما دام معطّلًا يستطيع SolaHR القراءة فقط ولا يستطيع تعديل المستخدمين أو تفعيلهم أو تعطيلهم أو حذفهم أو إرسالهم، ويعرض العبارة "التغييرات على هذا الجهاز متوقفة على حاسوب الموصّل."
- إلغاء الاقتران.
#الترقية
شغّل برنامج التثبيت الأحدث. فهو يستبدل ملفات البرنامج ويعيد تشغيل الخدمة. ويُحتفظ بالاقتران والإعدادات والبصمات المنتظرة، لذا لا تحتاج إلى الاقتران من جديد. وينطبق الأمر نفسه عند الانتقال من ZIP المحمول إلى برنامج التثبيت: تُزال المهمة المجدولة القديمة حتى لا يعمل موصّلان معًا.
#النقل والإلغاء والإزالة
- النقل إلى حاسوب آخر. ثبّت الموصّل الجديد واقرنه، ثم غيّر الموصّل الخاص بالجهاز في SolaHR. وألغِ الموصّل القديم من تبويب الموصّلات.
- الإلغاء. اضغط إلغاء على الموصّل في SolaHR. تتوقف أجهزته عن المزامنة. وتبقى البصمات المنتظرة على ذلك الحاسوب ولا تُرسل ما لم تقترن من جديد.
- الإزالة. من الإعدادات ← التطبيقات في Windows. ستُسأل "هل تريد حذف بيانات الموصّل أيضًا؟". الخيار الافتراضي لا: تُحفظ البيانات، بما فيها البصمات التي لم تُرسل بعد، ليتابع الموصّل عمله عند إعادة التثبيت. ويحذف الخيار نعم البصمات غير المرسلة.
#الأمان باختصار
- تستمع صفحة الموصّل إلى
127.0.0.1فقط وترفض العناوين الأخرى. - يُخزَّن رمز الاقتران ومفاتيح Comm Key مشفّرة. ومع ذلك يستطيع أي شخص يملك صلاحيات المسؤول على ذلك الحاسوب الوصول إليها: عامل الحاسوب كما تعامل الخادم.
- تُزال الرموز والمفاتيح من السجلات. ويُنشئ
solahr-dc diagnosticsحزمة دعم خالية من الأسرار. - لا تُرسل البصمات الحيوية ولا صور الوجه إلى SolaHR أبدًا.
#استكشاف أخطاء التثبيت
| العَرَض | ما الذي يجب فحصه |
|---|---|
| يحظر Windows الملف أو يحذّر منه | أمر متوقع في النسخة التجريبية غير الموقّعة. تحقق من SHA-256، ثم اضغط مزيد من المعلومات ← التشغيل على أي حال. وإذا كانت سياسة شركتك تمنع البرامج غير الموقّعة، فاطلب من قسم تقنية المعلومات السماح به، أو انتظر الإصدار الموقّع. |
| يذكر برنامج التثبيت أنه يحتاج إلى صلاحيات المسؤول | انقر بزر الفأرة الأيمن، ثم تشغيل كمسؤول. |
| "انتهت صلاحية الرمز" عند الاقتران | مدة صلاحية الرمز 15 دقيقة ويعمل مرة واحدة فقط. أنشئ رمزًا جديدًا. |
| فشل الاقتران | هل كُتب عنوان SolaHR بدقة (مع https://)؟ وهل يستطيع الحاسوب فتحه في المتصفح؟ وهل يحجبه خادم وسيط؟ |
| يبقى الموصّل غير متصل في SolaHR | هل الحاسوب يعمل ومتصل بالإنترنت؟ وهل الخدمة تعمل (sc query SolaHRDeviceConnect)؟ تخبرك صفحة الموصّل إن كان يحتاج إلى اقتران جديد. |
لا يفتح 127.0.0.1:8790 |
قد يكون برنامج آخر يستخدم المنفذ 8790. وتظل الخدمة تزامن بدون الصفحة. |
| "الموصّل يحتاج إلى اقتران جديد" / "أُلغي الموصّل" | أنشئ رمز اقتران جديدًا واقرن من جديد. تُحفظ البصمات المنتظرة. |
| تتوقف الخدمة بعد بدئها مباشرة | شغّل solahr-dc run في موجّه أوامر بصلاحيات المسؤول لرؤية الخطأ على الشاشة، وأرسل مخرجات solahr-dc diagnostics إلى الدعم. |
المزيد في استكشاف الأخطاء والأسئلة الشائعة.