استكشاف الأخطاء وإصلاحها

حلول مرتّبة حسب الأعراض لأكثر مشكلات Door & Gate Access شيوعًا. يتبع كل إدخال التسلسل: العَرَض ← السبب ← الحل. لمعرفة معنى أي حالة أو سبب رفض، راجع المرجع؛ ولمعرفة منطق القرار الأساسي، راجع كيف تُتخذ قرارات الوصول.

ابدأ بسجلات الوصول. لكل بلاغ تقريبًا عن "تعذّر الدخول" حدث رفض في سجلات الوصول مع السبب الدقيق. ابحث عن اسم العضو، وانظر إلى أحدث حدث رفض، وانتقل إلى القسم المطابق أدناه.

يظهر الباب بحالة غير متصل

العَرَض: تعرض بطاقة الباب غير متصل على الانترنت، ويرى الأعضاء "Door offline"، ولا يمكن إرسال أوامر الفتح.

السبب: لم تُبلغ وحدة التحكم في الباب عن حالتها منذ أكثر من 5 دقائق، فالطاقة أو الشبكة منقطعة عند الجهاز.

الحل:

1. تحقق من أن وحدة التحكم موصولة بالطاقة ومن اتصالها بالشبكة (كابل Ethernet / Wi-Fi). تتناول صفحة استكشاف أخطاء العتاد وإصلاحها الفحوصات في الموقع (مؤشرات LED، ومقسّم PoE، والكابلات، وشريحة SIM/الهوائي في طرازات 4G).
2. افتح لوحة الباب ← علامة التبويب Overview لعرض Status (آخر ظهور) وIP address ومدة التشغيل. يشير "آخر ظهور" حديث إلى شبكة متقطعة وليس إلى جهاز معطّل.
3. أعد تشغيل وحدة التحكم بفصل الطاقة وإعادتها إذا لزم الأمر.
4. لإجراء تشخيص أعمق، اتبع Open in Device Management for advanced configuration.
5. إذا انقطع اتصال عدة أبواب في الوقت نفسه، فاشتبه في شبكة الموقع أو الإنترنت وليس في الأجهزة.

عندما يكون الباب غير متصل، يرى الأعضاء بيانات الاتصال بالدعم في لوحة المعلومات الخاصة بهم (في الوضع الافتراضي Smart)، حتى يتمكنوا من الاتصال بك.

رُفض وصول عضو: "You don't have access to this door"

العَرَض: حدث رفض بالسبب no_matching_policy_or_grant.

السبب: لم يسمح له أي مسار إضافي: لم تتطابق أي Access Policy مفعّلة مع Who وWhere وWhen معًا، ولم تشمل الباب أي منحة دائمة أو نافذة نشطة للمسؤول أو لعملية التكامل.

الحل:

1. افتح العضو في Users وقارن نوع الشخص وحالة العضوية والوسوم المتزامنة والمخصصة مع Who في السياسة.
2. تحقق من أن Where يتضمن الباب مباشرةً، أو عبر نطاق وصول، أو عبر جميع أبواب المنشأة، وأنه لا يوجد استثناء يزيله.
3. تحقق من When: Anytime، أو نافذة Weekly/One-time نشطة واحدة على الأقل. أوقات الانتهاء غير مشمولة.
4. تذكّر أن السياسات تُجمع بمنطق OR، لكن كل سياسة تتطلب Who وWhere وWhen معًا. التطابق الجزئي لا يمنح الوصول أبدًا.
5. إن كان ذلك مناسبًا، استخدم منحة دائمة منفصلة أو نافذة للمسؤول؛ إذ تبقى هذه المسارات إضافية.

رُفض وصول عضو: "Your access has been suspended"

العَرَض: حدث رفض بالسبب access_disabled؛ ويعرض المستخدم شارة Disabled.

السبب: وصول المستخدم متوقف. يحدث ذلك يدويًا (أوقف أحد المسؤولين Access enabled) أو تلقائيًا (حُذف العضو في عملية التكامل وتعرض اللوحة Removed by integration، أو حُذف حذفًا مؤقتًا).

الحل: افتح المستخدم وأعد تفعيل Access enabled، أو إذا كان يعرض Removed by integration، فأعده في نظام المصدر (أو افصل الصف وفعّل الوصول يدويًا).

سياسة مجدولة لا تسمح بالوصول

العَرَض: يعرض التطبيق إتاحة مستقبلية أو يحتوي السجل على outside_access_time_window؛ أو تظهر نافذة مصدر بحالة Stale أو Unmapped؛ أو يتغير الوصول في وقت غير متوقع.

الحل:

1. تأكد من أن السياسة مفعّلة.
2. تحقق من Who وWhere في السياسة نفسها قبل فحص جدول When الخاص بها.
3. بالنسبة إلى نافذة One-time، قارن المحاولة بالفترة [from, to). لا يمكن للمنطقة الزمنية المعروضة أن تُزيح اللحظة المخزّنة.
4. بالنسبة إلى نافذة Weekly، تحقق من منطقتها الزمنية وفق IANA، ويوم الأسبوع/الفترة المحلية، والحدود النشطة الاختيارية، والانتقال إلى التوقيت الصيفي أو منه. أوقات الانتهاء غير مشمولة ويجب تقسيم الفترات الممتدة عبر منتصف الليل.
5. استخدم policyId وpolicyName في سجل الوصول للتحقق من السياسة المسمّاة التي جرى تقييمها.
6. تأكد من أن blockAllAccess أو Force closed أو تعطيل المستخدم أو السياج الجغرافي أو حالة وحدة التحكم لا تأخذ الأولوية.

بالنسبة إلى نافذة عملية تكامل منفصلة، تحقق أيضًا من تعيين النطاق المنطقي، ومراجعة المصدر، وعمر المصدر، وسلامة التسليم. نوافذ المصدر غير المعروفة أو غير المعيّنة أو القديمة تُغلق الوصول دون إزالة مسارات Access Policy أو المنح الدائمة.

قد تعرض التطبيقات الأقدم Outside hours لأن سبب التوافق هو outside_access_hours؛ بينما يستخدم سجل الوصول والتطبيقات الأحدث تفاصيل outside_access_time_window.

حالات الرفض بسبب السياج الجغرافي: "Move closer" وما يشبهها

العَرَض: أحداث رفض بالأسباب outside_geofence أو gps_too_imprecise أو location_unavailable.

يعرض مربع حوار تفاصيل حدث الرفض الإحداثيات المُبلغ عنها والدقة والمسافة، وهي معلومات قيّمة جدًا للحكم على ما إذا كان العضو موجودًا فعلًا في الموقع.

أُرسل أمر الفتح لكن الباب لم يُفتح (Timed out / Failed)

العَرَض: تنتهي الأحداث بحالة Timed out أو Failed بدلًا من Confirmed unlocked.

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

الحل:

1. تحقق من حالة اتصال الباب ومعلومات الجهاز (علامة التبويب Overview). يشير تكرار انتهاء المهلة على باب واحد إلى شبكته.
2. جرّب Unlock door بصلاحية المسؤول من اللوحة أثناء مراقبة الباب.
3. استخدم Identify device (ثلاث صفارات) للتأكد من أنك أمام وحدة التحكم الصحيحة فعليًا.
4. إذا نقر المرحّل لكن الباب لم يتحرر، فالعطل في دائرة القفل؛ أجرِ اختبارات وصلة التوصيل والمقياس المتعدد في استكشاف أخطاء العتاد وإصلاحها.
5. صعّد الأمر عبر تشخيصات إدارة الجهاز إذا كان الجهاز متصلًا لكنه لا يعمل.

تحقق أيضًا من Maintenance mode: يبقى الباب المضبوط على Force closed مقفلًا أمام الأعضاء عن قصد. يضبط Block all access at this door القيمة الصريحة blockAllAccess ويرفض كل سياسة للأعضاء وكل منحة دائمة وكل Access Time Window.

إذا كانت وحدة التحكم متصلة لكنها توقفت عن الاستجابة بشكل طبيعي، فإن Remotely reboot device (لوحة الباب ← Configuration ← Advanced) يعيد تشغيلها. يحتفظ الباب بحالة القفل الحالية وينقطع اتصاله لدقيقة أو دقيقتين أثناء الإقلاع.

يتعذر على العضو تسجيل الدخول إلى التطبيق

العَرَض: "No record found" في خطوة إرسال الرمز.

السبب: الهاتف أو البريد الإلكتروني الذي كتبه لا يطابق أي سجل في Users.

الحل: ابحث عن صفه في Users وقارن المعرّفات بدقة؛ فالأسباب المعتادة هي اختلاف تنسيق الرقم، أو بريد إلكتروني قديم، أو معرّف مفقود. حدّث الصف (أو اطلب من العضو استخدام المعرّف المسجّل). تذكّر أن كل صف يحتاج إلى هاتف أو بريد إلكتروني على الأقل.

العَرَض: "Too many attempts."

السبب: تحديد المعدّل: 5 طلبات للرمز في الساعة لكل جهة اتصال، إضافةً إلى حد على مستوى الشبكة.

الحل: انتظر حتى انقضاء المدة؛ فالحد الخاص بكل جهة اتصال إجراء أمني ولا يمكن رفعه.

مشكلات الدعوات

راجع الجدول المخصص في الدعوات ← استكشاف الأخطاء وإصلاحها. حلول سريعة: Send failed ← تحقق من العنوان وأعد الإرسال؛ عدم التضمين في الإرسال الجماعي ← لأنه تلقى دعوة بالفعل، أو استخدم التطبيق، أو ليس لديه بريد إلكتروني، أو ليس لديه وصول.

المستخدمون المتزامنون مفقودون أو غير محدّثين

العَرَض: شخص موجود في نظام الأعضاء لديك لكنه غير موجود في Users؛ أو بياناته قديمة.

الحل:

1. تحقق من Settings → Sync settings: هل المصدر مفعّل؟ هل عملية التكامل المحددة مفعّلة؟ إذا كانت البطاقة تعرض N removals held back for review، فهناك عملية إزالة كبيرة تنتظر أن يراجعها مسؤول.
2. وسّع Sync activity & troubleshooting وابحث عن الشخص؛ يخبرك سبب التخطي بالضبط بالسبب (معرّف مفقود، أو صف مفصول، أو عملية تكامل متوقفة، وما إلى ذلك). راجع جدول أسباب التخطي.
3. تحقق من مفتاح Track source updates الخاص بالمستخدم؛ فالصف المفصول لا يُحدَّث من المصدر أبدًا.
4. إذا كان الصف يعرض Not synced – duplicate، فهناك سجل آخر يشترك في البريد الإلكتروني أو الهاتف نفسه. راجع حل التكرارات.
5. استخدم Sync now لفرض تمريرة بدلًا من انتظار المزامنة الكاملة اليومية.
6. بالنسبة إلى Access Time Windows، افحص أيضًا عمر المصدر، ونتيجة المراجعة (updated/idempotent/stale/conflict)، وتعيين scope_key. يجب أن تترك عملية الجلب الفاشلة اللقطة السابقة دون تغيير بدلًا من مسحها.

جدول الفتح التلقائي لا يفتح الباب

العَرَض: لا يبقى الباب مفتوحًا خلال نافذته المجدولة.

الحل:

1. افتح علامة التبويب Schedule الخاصة بالباب وتأكد من تفعيل Auto-unlock. تحقق من معاينة Next 14 days لمعرفة متى يجب أن يُفتح الباب.
2. مع ساعات وجود الموظفين في المنشأة، تحقق من ساعات وجود الموظفين وساعات العطلات في المنشأة في تهيئة المنشآت والأنظمة. في العطلة الرسمية، يحدد On public holidays ما إذا كان الباب يتبع ساعات العطلة، أو يبقى مقفلًا، أو يتجاهل العطلة.
3. مع Custom schedule، تحقق من أن اليوم يحتوي فعلًا على فترة زمنية.
4. تحقق مما إذا كان الموظفون قد استخدموا Lock now: تعرض البطاقة Locked by staff until HH:MM. يعيد Resume schedule الجدول.
5. تذكّر أن تغييرات الجدول لا تسري إلا بعد الحفظ، الذي يعيد تحميل وحدة التحكم (عادةً خلال 10–15 ثانية).
6. وضع الصيانة له الأولوية: الباب المضبوط على Force closed لن يُفتح تلقائيًا.
7. الأوقات وفق المنطقة الزمنية للمنشأة؛ تحقق من إعداد المنطقة الزمنية للمنشأة إذا كانت النوافذ تعمل في ساعات غريبة.

غيّر أحد المسؤولين الإعدادات لكن لم يحدث شيء

العَرَض: تعديل السياسات أو السياج الجغرافي أو الرسائل دون أي أثر.

السبب: لا تُطبَّق تغييرات علامة التبويب Settings إلى أن يُنقر على Save changes في شريط الحفظ؛ ويؤدي الانتقال بعيدًا إلى عرض خيار تجاهلها.

الحل: أعد تطبيق التغييرات واحفظها. تُستخدم تغييرات السياسات والسياج الجغرافي في محاولات التفويض اللاحقة؛ وتظهر الإعدادات الخاصة بالتطبيق عند تحديث تطبيقات الأعضاء في المرة التالية.

صفحات ذات صلة

• استكشاف أخطاء العتاد وإصلاحها: تشخيص الطاقة والمرحّل وتوصيلات القفل
• سجلات الوصول
• جداول Access Policy
• المرجع: جميع أسباب الرفض والقيم الافتراضية
• الأسئلة الشائعة