المرجع
في هذه الصفحة
جداول شاملة لـ Door & Gate Access: كل حالة حدث، وسبب رفض، وإعداد، وقيمة افتراضية، وحد، وقيمة خيار في مكان واحد. استخدم هذه الصفحة للبحث عن المعنى الدقيق لأي قيمة؛ وتشرح صفحات الأدلة المرتبطة كيفية استخدام كل ميزة.
حالات أحداث الوصول
تظهر في سجلات الوصول:
| الحالة | المعنى |
|---|---|
| Request received | وصل طلب الفتح ويجري تقييمه (مؤقتة) |
| Pending | اجتاز الطلب عمليات التحقق وينتظر الإرسال (مؤقتة) |
| Unlocked | أُبلغ عن نجاح الفتح |
| Confirmed unlocked | أكدت وحدة التحكم في الباب تحرير المُرحّل |
| Admin Unlocked | شغّل مسؤول الفتح من Performance Hub (تجاوز المسؤول)؛ يُسجَّل عند إرسال الأمر |
| Denied | رُفض الطلب؛ راجع سبب الرفض في الحدث |
| Timed out | أُرسل الأمر لكن وحدة التحكم لم تؤكده في الوقت المحدد |
| Failed | تعذّر إكمال الفتح بسبب خطأ |
| Locked by staff | استخدم الموظفون Lock now بينما كان جدول الفتح التلقائي يُبقي الباب مفتوحًا (حدث جدول، لا محاولة فتح) |
| Schedule resumed | استأنف جدول الفتح التلقائي التحكم (حدث جدول، لا محاولة فتح) |
دورة حياة الحدث: الاستلام ← الإرسال ← تأكيد الفتح / الرفض / انتهاء المهلة / الفشل.
أسباب الرفض
تسجّل كل عملية فتح مرفوضة أو فاشلة سببًا. يربط الجدول السبب بما يراه العضو وبطريقة إصلاحه:
| السبب (كما يُسجَّل) | الرسالة التي يراها العضو | السبب | الحل |
|---|---|---|---|
access_disabled | "Your access has been suspended — please contact the facility" | المفتاح Access enabled الخاص بالمستخدم متوقف | أعد تفعيله في لوحة المستخدم ضمن Users |
no_matching_policy_or_grant | "You don't have access to this door" | لم تطابق أي Access Policy الشروط Who وWhere وWhen معًا ولم يسمح أي مسار منح تراكمي بالوصول | راجع Access Policies، وسمات المستخدم، والأهداف والاستثناءات، والجدول الزمني، والمنح |
no_matching_policy_target | "You don't have access to this door" | لا تستهدف أي Access Policy مفعّلة هذا الباب بالنسبة إلى الطلب | أضف الباب أو نطاق الوصول الخاص به إلى سياسة، أو استخدم هدفًا يشمل كل الأبواب |
no_matching_policy_audience | "You don't have access to this door" | تستهدف السياسات الباب، لكن لا تطابق أيٌّ منها نوع الشخص أو حالته أو وسومه | راجع قسم Who في السياسة وسجل Users |
outside_policy_schedule | "Outside allowed access hours" | يتطابق Who وWhere، لكن كل جداول السياسات المطابقة غير نشطة أو منتهية | راجع قسم When في السياسة والمنطقة الزمنية للمنشأة |
outside_geofence | "Move closer — you're outside the location's geofence." | يقع الموقع المُبلغ عنه أبعد من نصف القطر + دقة GPS + الهامش من مركز السياج الجغرافي | يقترب العضو أكثر؛ أو راجع نصف قطر السياج الجغرافي أو الدبوس |
gps_too_imprecise | "Couldn't pin down your location accurately. Try again outdoors." | دقة GPS في الهاتف أسوأ من حد Require GPS accuracy better than | يعيد العضو المحاولة في مكان مفتوح أو بعيدًا عن التداخل؛ أو ارفع الحد |
location_unavailable | "Couldn't read your location. Make sure Location is enabled and set to Precise, then try again." | لم يُبلغ الهاتف عن موقع قابل للاستخدام | يفعّل العضو الموقع (Precise) للتطبيق |
geofence_misconfigured | Unlock denied | السياج الجغرافي مفعّل لكن مركزه أو دبوسه مفقود؛ فيفشل النظام في الوضع المغلق | ضع دبوس السياج الجغرافي في الإعدادات ← Geofencing |
device_offline | "Door is offline. Please contact the facility." | لم ترسل وحدة التحكم في الباب تقريرًا (لا توجد نبضة اتصال خلال 5 دقائق) | أعد الطاقة أو الشبكة إلى وحدة التحكم، راجع استكشاف الأخطاء وإصلاحها |
user_deleted | "You don't have access…" | حُذف سجل Users | أعد إنشاء المستخدم أو استعده |
outside_access_time_window | الباب معطّل مع عرض موعد الإتاحة التالي عند معرفته | نافذة مستقبلية هي مسار السماح المحتمل الوحيد للمستخدم ولم تصبح نشطة بعد | تحقق من الإتاحة المقدّمة، والمنطقة الزمنية، وحداثة المصدر، والتعيين؛ ولا تزال Access Policies والمنح تُطبَّق باستقلال |
تعرض بعض إصدارات التطبيق الرسالة الأعم "You don't have access to this door" أو "Outside allowed access hours" لحالات الرفض الخاصة بالسياسات. وتحتفظ سجلات الوصول بالسبب المفصّل للمسؤولين.
سياسات الوصول
| الخاصية | المعنى |
|---|---|
| بنية السياسة | اسم فريد، ووصف اختياري، وعلامة التفعيل، وجمهور Who، وأهداف Where واستثناءاته، وجدول When |
| مطابقة السياسة | Who وWhere وWhen معًا |
| السياسات المتعددة | "أو"؛ أي سياسة مفعّلة مطابقة تسمح بالوصول |
| Who | نوع الشخص مع حالات اختيارية، أو وسوم متزامنة أو مخصصة؛ خلو الحالات = أي حالة |
| Where | كل أبواب المنشأة، أو نطاقات الوصول، أو الأبواب الفردية، أو مجموعات منها؛ وتتقدم الاستثناءات ضمن تلك السياسة |
| When | Anytime، أو نوافذ Weekly/One-time مجمّعة بمنطق "أو" |
| مسارات السماح الأخرى | تظل المنح الدائمة ونوافذ المسؤول والتكامل منفصلة وتراكمية |
| السلامة | لا تزال تُطبَّق عمليات التحقق من المستخدمين المحذوفين أو المعطّلين أو المحظورين بسبب المزامنة، وحذف الباب أو حظره، والصيانة، والسياج الجغرافي، وحدود المعدل، ووحدة التحكم |
| التهيئة الحالية | تُستورد تلقائيًا إلى سياسات مسمّاة مكافئة ذات قيم Who وWhere وWhen صريحة |
نسب السياسات
تحدد سجلات الوصول السياسة المطابقة باسمها، ويمكنها عرض جمهورها وهدفها وجدولها الزمني. ويمكن أن تتضمن المطابقات المجدولة أيضًا البداية والنهاية الفعليتين النشطتين.
مرجع Access Time Window
| الخاصية | المعنى |
|---|---|
| التفويض | نوافذ جدول السياسة هي When الخاص بالسياسة؛ أما نوافذ المسؤول والتكامل فمسارات سماح تراكمية منفصلة |
| الحد المطلق | لحظات UTC بالثواني بصيغة Unix كأعداد صحيحة، [from, to) |
| المنطقة الزمنية المطلقة | بيانات وصفية للعرض والتدقيق؛ لا تُزيح القيم الزمنية |
| الحد الأسبوعي | كتل HH:mm محلية بنهايات غير شاملة |
| المنطقة الزمنية الأسبوعية | منطقة زمنية IANA صالحة تحدد اليوم والوقت المحليين والتوقيت الصيفي |
| الحدود الأسبوعية | بداية ونهاية سريان اختياريتان بالثواني بصيغة Unix؛ النهاية غير شاملة |
| الفترات الليلية / التداخل | غير مقبولة؛ قسّم الفترات الليلية على الأيام وأبقِ الكتل غير متداخلة |
| ملكية المستخدم | المسؤول وكل مصدر تكامل معزولون؛ لا يمكن لأحدهم محو نوافذ الآخر |
| نطاق التكامل | مفتاح scope_key ثابت للمصدر، والقيمة الافتراضية default، مُعيَّن إلى أهداف PH؛ يفشل غير المعروف أو غير المُعيَّن في الوضع المغلق |
| حداثة المصدر | تُضبط وفق وتيرة كل تكامل؛ ويجب أن يكون السلوك عند تقادم المصدر صريحًا |
| السلامة | لا تتجاوز أبدًا المستخدمين المعطّلين أو المحذوفين أو المتعارضين، أو blockAllAccess، أو الصيانة، أو السياج الجغرافي، أو حدود المعدل، أو عمليات التحقق من وحدة التحكم |
الحدود الأولية: 50 نافذة لكل حاوية سياسة أو منح أو مصدر؛ وحد أقصى للمدى المطلق قدره 90 يومًا؛ و120 حرفًا للمعرّفات والتسميات ومفاتيح النطاقات؛ وثماني كتل أسبوعية لكل يوم؛ ولا يمكن أن تكون الإدخالات المكتوبة حديثًا منتهية بالفعل بأكثر من ساعة واحدة.
الإعدادات والقيم الافتراضية والنطاقات
إعدادات الباب
| الإعداد | القيمة الافتراضية | النطاق / الخيارات |
|---|---|---|
| مدة الإبقاء مفتوحًا | 10 ثوانٍ | 1–30 ثانية |
| وضع الصيانة | Normal | Normal / Force open / Force closed |
| صوت فتح الباب | Off | On / Off |
| تسمية موقع الباب | — | نص حر، 64 حرفًا كحد أقصى |
| الرمز | Door | 10 خيارات (أدناه) |
| جدول الفتح التلقائي | Off | ساعات وجود الموظفين في المنشأة أو Custom schedule، بالمنطقة الزمنية للمنشأة |
| توقيت الفتح / القفل التلقائي | At opening / At closing | At opening / At closing، أو قبل ذلك أو بعده بـ 5 أو 10 أو 15 أو 30 أو 45 أو 60 أو 90 أو 120 دقيقة |
| الفتح التلقائي في العطلات الرسمية | Ignore holidays | Follow the facility's holiday hours / Stay locked all day / Ignore holidays |
| تفويض الوصول (لكل باب) | Access Policies | يسرد السياسات المطابقة ويتيح blockAllAccess |
| السياج الجغرافي (لكل باب) | Inherit from facility | Inherit from facility / Override for this door / Disable geofence for this door |
| حد الاتصال | — | تُعدّ وحدة التحكم متصلة إذا أرسلت نبضة اتصال خلال آخر 5 دقائق |
رموز الأبواب
| الرمز | الاستخدام المقصود |
|---|---|
| Door | باب مفرد قياسي (افتراضي) |
| Sliding door | باب منزلق / تلقائي |
| Double door | باب مزدوج / فرنسي |
| Garage | باب مرآب / باب لفّاف |
| Boom gate | حاجز ذو ذراع / ذراع حاجز |
| Pedestrian | مدخل مشاة / مدخل الموظفين |
| Security | باب مقيّد / باب أمني |
| Office | مكتب / غرفة مخصصة للموظفين فقط |
| Delivery | رصيف تحميل / منطقة تسليم |
| Locker | خزانة / تخزين |
إعدادات السياج الجغرافي
| الإعداد | القيمة الافتراضية | النطاق |
|---|---|---|
| تفعيل السياج الجغرافي | On (لتهيئة منشأة جديدة) | On / Off |
| نصف القطر | 200 m | 50–5000 m (بخطوات 10 m؛ قيم مُعدّة مسبقًا 50 / 200 / 500 / 1000 m) |
| هامش الدقة | 25 m | — |
| Require GPS accuracy better than | 100 m | — |
| صيغة المسافة المسموح بها | — | نصف القطر + دقة GPS المُبلغ عنها + هامش الدقة |
فترات السماح بالوصول
ضمن الإعدادات ← Access Time Windows:
| الإعداد | الخيارات |
|---|---|
| Allow early access | Off / 5 / 10 / 15 / 30 دقيقة |
| Allow access after end | Off / 5 / 10 / 15 / 30 دقيقة |
إعدادات قفل التطبيق
| الإعداد | القيمة الافتراضية | الخيارات |
|---|---|---|
| Enforce app lock for this facility | Off | On / Off |
| Grace period before re-prompting | 5 دقائق | Always prompt / 1 min / 5 min / 15 min / 30 min / 1 hour |
| السلوك مع عدة منشآت | — | يُفرض إذا فرضته أي منشأة مرتبطة؛ وتُطبَّق أقصر فترة سماح بين المنشآت التي تفرضه |
جهات اتصال الدعم
| الوضع | السلوك |
|---|---|
| Smart (default) | تُعرض تلقائيًا عندما يكون باب غير متصل أو تكون المعلومات في الواجهة محدودة |
| Always show | معروضة دائمًا على لوحة القيادة في التطبيق |
| Never show | لا تُعرض أبدًا |
رسائل التطبيق
| الحقل | الحد / الخيارات |
|---|---|
| نوع الإشعار | Information / Notice / Urgent |
| العنوان | 120 حرفًا |
| النص | 2000 حرف (تحذير غير مُلزم عند 500) |
| رابط URL | http(s) فقط، 2000 حرف |
| تسمية الرابط | 80 حرفًا، والقيمة الافتراضية "More info" |
| الجدول الزمني | Starts at / Ends at اختياريان |
| العناصر النائبة (القواعد التلقائية) | {firstName}، {lastName} |
| حقول مطابقة القواعد التلقائية | Membership status / Person type / Tag (تطابق الوسوم المتزامنة والمخصصة، دون تمييز بين الأحرف الكبيرة والصغيرة) / Door visibility |
| أولوية القواعد | تُطبَّق أول قاعدة مفعّلة مطابقة (حسب ترتيب القائمة) |
حقول المستخدم
| الحقل | الحد / الملاحظات |
|---|---|
| الاسم الأول / اسم العائلة | 80 حرفًا لكل منهما |
| الهاتف المحمول / البريد الإلكتروني | أحدهما على الأقل مطلوب (يُستخدم لتسجيل الدخول برمز OTP)؛ وتُوحَّد أرقام الهواتف بالتنسيق الدولي |
| الوسوم | 80 حرفًا لكل وسم؛ تستبدل المزامنة الوسوم المتزامنة، والوسوم المخصصة يملكها المسؤول |
| الملاحظات | 2000 حرف |
| Access enabled | مفعّل افتراضيًا؛ الإيقاف = رفض كل عمليات الفتح |
| المنح | على مستوى المنشأة، أو قائمة أبواب، أو قائمة نطاقات، مع ساعات تشغيل اختيارية |
| Access Policies | يمكن أن تشمل المستخدم سياسة مسمّاة واحدة أو أكثر؛ وتستخدم القائمة والوصول الفعلي Access granted via policy |
| Access Time Windows | نوافذ قابلة للتعديل يملكها المسؤول، إضافة إلى نوافذ للقراءة فقط يملكها المصدر؛ منفصلة عن جداول السياسات |
المصادر والحالات والقيم المعدودة الأخرى
| القائمة | القيم |
|---|---|
| مصدر المستخدم | Manually added / External Integration / CCTV-Computer Vision / Performance Hub staff |
| مربعات المستخدمين | All users / Has access / No access / Not synced |
| حالة الدعوة | Not invited / Invited / Send failed |
| مستلمو الدعوات | Only users with door access / All eligible synced users |
| حقول قواعد الدعوات | Membership status / Person type / Tag / Sync source / Integration؛ والعاملان is any of / is not any of |
| طرق عرض سجلات الوصول | Door events / No visit recorded |
| استخدام التطبيق | Active (استخدم التطبيق) / Not yet active |
| المعرّف المطلوب (المزامنة) | Email OR phone (افتراضي) / Email required / Phone required / Both required |
| نتائج سجل المزامنة | Added / Updated / Skipped / Disabled / Processed / Stale snapshot |
| حالات النوافذ | Active / Upcoming / Expired / Stale / Unmapped |
| تسميات حالة العضوية | Active، Current، Expired، On hold، Cancelled، Pending (إضافة إلى أي قيم من نظامك المصدر) |
| قوالب نطاقات الوصول | Custom، Main entrances، Staff-only، Restricted area، 24/7 access، Business hours، Vehicle access، Service entries |
| قوالب الرسائل التلقائية | No door access، Expired membership، Payment overdue، Account on hold / suspended، Welcome (new member)، Trial / prospect، Document / waiver required |
أسباب التخطي في المزامنة
| السبب المعروض في سجل المزامنة | المعنى |
|---|---|
| Integration sync is turned off for this facility | المفتاح الرئيسي للمصدر متوقف |
| This integration is turned off in sync settings | استُبعد التكامل المحدد |
| No phone or email on the record (a phone or email is required to log in) | لا يستوفي السجل قاعدة Require identifier |
| Record is decoupled and managed manually | الخيار Track source updates متوقف لهذا المستخدم |
| No facility on the source record | سجل المصدر غير مرتبط بهذه المنشأة |
| No matching user record | أشار التغيير إلى شخص ليس له صف هنا |
الحدود التشغيلية
| الحد | القيمة |
|---|---|
| استيراد CSV | 200 مستخدم لكل عملية استيراد |
| الدعوات الجماعية | تُرسل على دفعات من 50 |
| عينة معاينة الحذف الجماعي | يُعرض أول 50 مستخدمًا |
| استعلام سجلات الوصول | حتى 500 من أحدث الأحداث لكل نافذة |
| الاحتفاظ بأحداث الوصول | ~13 شهرًا، ثم تُزال تلقائيًا |
| صلاحية أمر الفتح الإداري | 30 ثانية (تنتهي صلاحية الأمر إذا لم يُسلَّم) |
| نبضة اتصال وحدة التحكم في الباب | كل ~30 ثانية؛ غير متصلة بعد 5 دقائق من الصمت |
| طلبات رمز تسجيل الدخول | 5 في الساعة لكل هاتف أو بريد إلكتروني (حد أمني، لا يمكن رفعه) |
| انتشار تسجيل الخروج من التطبيق | يُلغى فورًا؛ وقد يستغرق إنهاء الجلسة النشطة بالكامل حتى 15 دقيقة |
| حفظ إعدادات الباب | يعيد تحميل وحدة التحكم، عادةً 10–15 ثانية |
| الاحتفاظ بـ No visit recorded | ~13 شهرًا |
| تعيينات Access Time Window | 50 لكل تكامل |
| Access Time Windows لكل حاوية | 50 |
| مدى نافذة One-time | 90 يومًا |
| الكتل الأسبوعية | 8 لكل يوم من أيام الأسبوع |
| معرّف النافذة أو المصدر، والتسمية، ومفتاح النطاق | 120 حرفًا |
| Access Policies لكل منشأة | 100 |
| إجمالي نوافذ السياسات | 500 |
| اسم Access Policy أو معرّفها | 120 حرفًا |
| وصف Access Policy | 500 حرف |
| تهيئة Access Policy | 300 KiB UTF-8 |