- الرئيسية
- /
- المقال
مزامنة الدليل في Webex من أجل Cisco BroadWorks
توضح هذه المقالة كيفية نشر "مزامنة الدليل" في Webex ل Cisco BroadWorks. المقالة مخصصة لمسؤولي موفر الخدمة في المؤسسات الشريكة.
نظرة عامة على أداة مزامنة الدليل
تضمن مزامنة الدليل أن Webex لمستخدمي Cisco BroadWorks يمكنهم استخدام دليل Webex من تطبيق Webex للاتصال بأي كيان اتصال من خادم BroadWorks. تقوم هذه الميزة بمزامنة معلومات مكالمات BroadWorks التي لم تكن جزءا من إدارة حسابات المستخدمين مع دليل Webex.
يقوم Webex لإدارة حسابات مستخدمي Cisco BroadWorks بتحديث دليل Webex بتفاصيل الاتصال ل Webex لمستخدمي Cisco BroadWorks (رقم الهاتف الأساسي ورقم الهاتف المحمول والملحق)، ولكنه يحذف سجلات المكالمات الخارجية. ومع ذلك ، عند تفعيل مزامنة الدليل ، تقوم الميزة أيضا بمزامنة سجلات المكالمات التالية مع دليل Webex.
مستخدمو الاتصال ب BroadWorks فقط (الذين لم يتم إلحاقهم ب Webex)
كيانات الاتصال غير المستخدمة (على سبيل المثال ، هاتف غرفة الاجتماعات ، وجهاز الفاكس ، ورقم مجموعة البحث)
إدخالات قائمة هاتف BroadWorks
يلخص الجدول التالي سجلات مكالمات BroadWorks ويوضح كيفية إضافتها إلى دليل Webex.
سجلات استدعاء برود ووركس | الوصف | تمت الإضافة إلى دليل Webex عبر ... |
---|---|---|
Webex لمستخدمي Cisco BroadWorks | يتم تمكين المستخدمين ل Webex ل Cisco BroadWorks | إدارة حسابات المستخدمين (على سبيل المثال، إدارة الحسابات التدفقية) |
مستخدمو الاتصال ب BroadWorks فقط | الاتصال بالمستخدمين غير المنضمين إلى Webex | مزامنة الدليل |
الكيانات الداعية غير المستخدمة | على سبيل المثال ، هاتف غرفة الاجتماعات ، جهاز فاكس ، رقم مجموعة Hunt | مزامنة الدليل |
قوائم هواتف برود ووركس | إدخالات قائمة هاتف BroadWorks:
| مزامنة الدليل (مزامنة قائمة الهاتف) |
شروط مزامنة الدليل
يجب على مسؤولي الشركاء تمكين الميزة على مستوى الشريك. يمكن لمسؤولي الشركاء تشغيل الميزة أو إيقاف تشغيلها لمؤسسات عملاء متعددة في عملية واحدة.
بشكل افتراضي، تحدث المزامنة الأولية بعد أسبوع واحد من تمكين المزامنة (الوقت المختار لبدء المزامنة عشوائي). ومع ذلك، يمكن لمؤسسات العملاء استخدام خيار المزامنة الآن لتجاوز فترة الانتظار لمدة أسبوع واحد وتشغيل مزامنة فورية لمؤسسة عميل معينة.
بشكل افتراضي، يتم تشغيل أداة مزامنة الدليل أسبوعيا لكل عميل. تحدث كل مزامنة بعد أسبوع واحد من آخر مزامنة، بغض النظر عما إذا كانت آخر مزامنة قد تمت جدولتها أو تشغيلها يدويا باستخدام المزامنة الآن.
الحد الأقصى لعدد عمليات المزامنة المتزامنة لكل مجموعة BroadWorks هو اثنان: مزامنة مجدولة واحدة ومزامنة واحدة عند الطلب (عبر واجهة برمجة التطبيقات أو واجهة المستخدم الرسومية لمركز الشركاء). ومع ذلك، لا يمكن للمسؤولين تشغيل مزامنتين عند الطلب في نفس الوقت من نفس BroadWorks. يوجد هذا التقييد بغض النظر عما إذا كانت المزامنة قد بدأت عبر واجهة برمجة التطبيقات أو عبر خيار المزامنة الآن في Partner Hub. بالإضافة إلى ذلك ، لن يقوم Webex بجدولة مزامنتين مجدولتين للتشغيل في نفس الوقت من نفس BroadWorks.
في حالة حدوث فشل في المزامنة، يعيد Webex محاولة المزامنة تلقائيا كل 24 ساعة حتى المزامنة المجدولة التالية.
تتجاهل المزامنة المستخدمين الذين ليس لديهم رقم هاتف.
في Partner Hub، يمكنك عرض معلومات حالة المزامنة لعميل معين. بالإضافة إلى ذلك، يمكنك تصدير معلومات تفصيلية عن آخر مزامنة إلى سجل CSV. يوفر سجل CSV تفاصيل أكثر من شاشة Control Hub ويمكن أن يساعد في استكشاف الأخطاء وإصلاحها والتحليلات والتدقيق.
يخزن Webex جهات اتصال المستخدم بتنسيق مشفر. فقط المستخدم الذي يمتلك جهة الاتصال لديه حق الوصول إلى مفتاح فك التشفير.
بالنسبة لمستخدمي الاتصال ب BroadWorks فقط وكيانات الاتصال غير المستخدمة، تقوم هذه الميزة بمزامنة أنواع أرقام الهواتف التالية من BroadWorks:
رقم الهاتف الرئيسي
رقم الهاتف المحمول
الامتداد
ومع ذلك، تستبعد المزامنة مستخدمي الاتصال ب BroadWorks فقط وكيانات الاتصال غير الخاصة بالمستخدمين من المزامنة في حالة عدم وجود رقم هاتف أساسي أو ملحق.
إعداد خدمة الخصوصية على مستوى المستخدم في BroadWorks غير معتمد كجزء من مزامنة الدليل.
قائمة هواتف BroadWorks والحد الأقصى لجهات الاتصال
تقوم مزامنة الدليل أيضا بمزامنة إدخالات قائمة هاتف BroadWorks مع جهات اتصال Webex. تتم إضافة الإدخالات المتزامنة إلى أحد أنواع جهات الاتصال التالية:
جهات اتصال المؤسسة—يخزن Webex جهات الاتصال هذه مقابل مؤسسة. يمكن لكل مستخدم الوصول إلى جهات اتصال المؤسسة لمؤسسته. الحد الأقصى يصل إلى 30000 جهة اتصال.
جهات اتصال المستخدم—يخزن Webex جهات الاتصال هذه مقابل مستخدم. يمكن فقط للمستخدم الذي يملك جهة الاتصال الوصول إلى إدخال جهة الاتصال. الحد الأقصى يصل إلى 2000 جهة اتصال (1500 جهة اتصال متزامنة + 500 جهة اتصال إدخال يدوي).
يعين الجدول التالي أنواع جهات اتصال Webex مقابل مصدر جهة الاتصال (تتم مزامنتها من قائمة هواتف BroadWorks أو إضافتها يدويا):
نوع الاتصال Webex | مصدر الاتصال | الحد الأقصى | متزامنة من برود ووركس... | واجهة برمجة التطبيقات المستخدمة للمزامنة |
---|---|---|---|---|
جهات اتصال المؤسسة | مزامنة الدليل | 30000 جهة اتصال | قوائم الهواتف المشتركة للمؤسسة |
|
قوائم الهواتف المشتركة للمجموعة (لمجموعة مزودي الخدمة)** |
| |||
جهات اتصال المستخدم | مزامنة الدليل | 1500 جهة اتصال | قوائم الهواتف الشخصية | /directories/personal |
تمت الإضافة يدويا من قبل المستخدم | 500 جهة اتصال | غير متوفر | غير متوفر | |
جهات اتصال المجموعة | مزامنة الدليل | 30000 جهة اتصال لكل مجموعة | قوائم الهواتف المشتركة للمجموعة (لمجموعة مؤسسات)** | /directories/groupcommon |
**تتم مزامنة إدخالات قوائم الهاتف المشتركة للمجموعة بشكل مختلف اعتمادا على ما إذا كان BroadWorks في وضع Enterprise أو وضع موفر الخدمة. قيمة isBroadWorksEnterprise
تحدد المعلمة (صواب أو خطأ) كيفية مزامنة القائمة:
صواب: المزامنة كجهة اتصال جماعية
خطأ: المزامنة كجهة اتصال المؤسسة
تنطبق الشروط التالية حول كيفية معالجة أداة مزامنة الدليل للحد الأقصى لجهات الاتصال:
إذا تجاوزت المؤسسة الحد الأقصى المسموح به لجهات الاتصال للمزامنة (30000 جهة اتصال مؤسسة أو 30000 مجموعة جهات اتصال مشتركة لكل مجموعة)، تستبعد مزامنة الدليل الإدخالات التي تزيد عن الحد الأقصى. لا يوجد ترتيب معين مطبق على جهات الاتصال المتزامنة أو المحذوفة.
إذا تجاوز أحد عملائك الحد الأقصى المسموح به لعدد جهات الاتصال في أي من الفئتين، فإننا نوصي برفع حالة مع Cisco لاستبعاد هذه المؤسسة من مزامنة الدليل.
جهات الاتصال اليدوية هي جهات اتصال يضيفها المستخدم يدويا على تطبيق Webex. يمكن للمستخدم إضافة ما يصل إلى 500 جهة اتصال يدوية. تقع جهات الاتصال اليدوية ضمن فئة جهات اتصال المستخدم الأكبر على Webex، ولكنها غير مضمنة في المزامنة.
الحد الإجمالي المجمع لجهات اتصال المؤسسة (30000) وجهات اتصال المجموعة (30000 لكل مجموعة) هو 200000.
تحديثات
فيما يلي كيفية تعامل دليل Webex مع التحديثات:
إذا تغير اسم جهة الاتصال على BroadWorks ، حذف جهة الاتصال الموجودة من دليل Webex ويتم إنشاء جهة اتصال جديدة.
إذا تغير رقم جهة الاتصال على BroadWorks ، يقوم Webex بتحديث جهة الاتصال الموجودة في دليل Webex بالرقم الجديد.
بعد أن يقوم المسؤول بتحديث جهة اتصال على BroadWorks، توضح الشروط التالية وقت عرض التحديث في تطبيق Webex الخاص بالمستخدم:
إذا كان التحديث لمستخدم اتصال BroadWorks فقط أو كيان اتصال غير مستخدم، عرض التحديث في تطبيق Webex الخاص بالمستخدم مباشرة بعد مزامنة الدليل اللاحقة.
إذا كان التحديث إلى إدخال قائمة هاتف BroadWorks:
بالنسبة إلى جهات اتصال المستخدمين: يتم عرض التحديثات في تطبيق Webex الخاص بالمستخدم مباشرة بعد مزامنة الدليل اللاحقة.
لجهات اتصال المجموعة - يتم عرض التحديثات في تطبيق Webex للمستخدمين مباشرة بعد مزامنة الدليل اللاحقة.
بالنسبة إلى جهات اتصال المؤسسة: يتم تحديث دليل Webex عند مزامنة الدليل اللاحقة، ولكن لن يرى المستخدمون التغيير في تطبيق Webex حتى يعيدوا تشغيل تطبيق Webex أو حتى تنتهي صلاحية مؤقت ذاكرة التخزين المؤقت المحلي لمدة 72 ساعة.
المتطلبات الأساسية لمزامنة الدليل
نوصي باستخدام الإعدادات التالية:
قيم تحديد المعدل—قم بتعيين خصائص نظام التحكم في التحميل الزائد التالية (XSP_CLI/التطبيقات/إجراءات XSI/التحكم في التحميل الزائد):
userDirectoryTransactionLimit—اضبط على قيمة فارغة.
جلوبالدليلاكتيوبليتيليميت—تعيين إلى قيمة فارغة.
من المستحسن تعيين دليل المستخدم و globalDirectoryTransactionLimit إلى قيمة فارغة. ومع ذلك ، إذا قررت تعيين قيم ، فيجب تعيين كل منها على خمسة أضعاف قيمة المعاملة LimitPeriodSeconds على الأقل (والتي يجب أن تكون 1).حدود المعاملات—يمكنك تعيين القيم التالية (XSP_CLI/System/CommunicationUtility/DefaultSettings):
userTransactionLimit—اضبط على 100 على الأقل.
المعاملةLimitPeriodSecs—اضبط على 1.
قيم ترحيل الصفحات—تعيين خصائص نظام ترحيل الصفحات (XSP_CLI/التطبيقات/إجراءات XSI/ترحيل الصفحات):
حجم الصفحة الافتراضي—الضبط على 50
متاحUserMaxLimit—اضبط على 100
واجهة CTI—تأكد من تحميل شهادات Webex CA إلى مخزن ثقة واجهة CTI وتمكين مصادقة العميل على واجهة CTI.
بالإضافة إلى ذلك، بناء على إصدار BroadWorks الخاص بك، نوصي بتطبيق تصحيحات النظام التالية على نشر BroadWorks قبل تمكين هذه الميزة:
بالنسبة إلى R22:
AP.as.22.0.1123.ap368517
بالنسبة إلى R23:
AP.as.23.0.1075.ap368517
بالنسبة إلى R24: لا حاجة للتصحيح
تفعيل أداة مزامنة الدليل (نموذج جديد)
يمكن لمشرفي الشركاء تفعيل أداة مزامنة الدليل لنموذج عميل أثناء إنشاء النموذج الجديد. سيتم تمكين مزامنة الدليل لأي مؤسسات عملاء جديدة يتم تعيينها لهذا القالب. للحصول على التفاصيل، راجع "تكوين قوالب العملاء" في تكوين مؤسستك الشريكة في مركز الشركاء ضمن دليل الحلول ل Webex ل Cisco BroadWorks.
ماذا تفعل بعد ذلك
تأكد من أن المستخدمين يعرفون أنه يجب عليهم النقر فوق علامة التبويب جهات الاتصال في تطبيق Webex مرة واحدة على الأقل لتشغيل الميزة على تطبيق Webex. يجب إكمال هذا مرة واحدة فقط.
تفعيل أداة مزامنة الدليل (النموذج الحالي)
1 | سجل الدخول إلى مركز الشركاء واختر الإعدادات. |
2 | قم بالتمرير إلى استدعاء BroadWorks وانقر فوق عرض القوالب. |
3 | حدد قالب العميل المناسب وانتقل إلى أداة مزامنةدليل BroadWorks. |
4 | لتمكين مزامنة الدليل بشكل افتراضي لمؤسسات العملاء الجديدة التي تستخدم هذا القالب: |
5 | لتمكين مزامنة الدليل لمؤسسات العملاء الحالية التي تستخدم هذا القالب: إذا كنت تريد تعطيل مزامنة الدليل ، فاتبع الإجراء أعلاه و:
|
التصرف التالي
تأكد من أن المستخدمين يعرفون أنه يجب عليهم النقر فوق علامة التبويب جهات الاتصال في تطبيق Webex مرة واحدة على الأقل لتشغيل الميزة على تطبيق Webex. يجب إكمال هذا مرة واحدة فقط.
تشغيل المزامنة الفورية
1 | سجل الدخول إلى مركز الشركاء ( http://admin.webex.com) واختر الإعدادات. |
2 | قم بالتمرير إلى استدعاء BroadWorks وانقر فوق عرض القوالب. |
3 | حدد قالب العميل المناسب وانتقل إلى أداة مزامنةدليل BroadWorks. |
4 | انقر على عرض قائمة بحالةمزامنة العملاء. |
5 | بالنسبة إلى مؤسسة العميل التي تريد مزامنتها، انقر على النقاط الثلاث في أقصى اليسار وحدد مزامنة الآن. |
6 | انقر على تحديث للاطلاع على نتائج المزامنة. |
تصدير سجلات المزامنة إلى CSV
1 | سجل الدخول إلى مركز الشركاء ( http://admin.webex.com) واختر الإعدادات. |
2 | قم بالتمرير إلى استدعاء BroadWorks وانقر فوق عرض القوالب. |
3 | حدد قالب العميل المناسب وانتقل إلى أداة مزامنةدليل BroadWorks. |
4 | انقر على عرض قائمة بحالةمزامنة العملاء. |
5 | حدد خانات الاختيار المجاورة لكل مؤسسة تريد تضمينها في التصدير. |
6 | انقر على تصدير النتائج. |
واجهات برمجة التطبيقات العامة لأداة مزامنة الدليل
تتوفر واجهات برمجة التطبيقات العامة على developer.webex.com تسمح للمشرفين الشركاء بتعديل إعدادات أداة مزامنة الدليل للمؤسسات العميلة التي يديرونها أو لتشغيل مزامنة فورية أو الحصول على معلومات حالة المزامنة. يتم تجميع أساليب مزامنة الدليل ضمن BroadWorks Enterprises:
قائمة مؤسساتBroadWorks—استخدم طريقة واجهة برمجة التطبيقات هذه للحصول على قائمة بالمؤسسات الخاضعة لمزود خدمة معين ولكل مؤسسة
id
. يجب عليك إدخالspEnterpriseId
كما هو محدد في التوفير.تحديث أداة مزامنة الدليل لمؤسسةBroadWorks: أدخل المؤسسة
id
لتحديث حالة SYC للدليل لتلك المؤسسة، تمكين مزامنة الدليل أو تعطيلها.تشغيل أداة مزامنة الدليل لمؤسسة: استخدم طريقة واجهة برمجة التطبيقات هذه إذا كنت تريد تشغيل مزامنة فورية لمؤسسة معينة
id
. بالنسبة لsyncStatus
، أدخل الزرSYNC_NOW
أمر.الحصول على حالة مزامنة الدليل لمؤسسة: أدخل المؤسسة
id
وتشغيل من أجل الحصول على حالة وtrackingId
من أحدث مزامنة. يمكنك استخدامtrackingID
لتشغيل تحليلات إضافية عبر أدوات مثل Kibana و Grafana.
بالإضافة إلى ذلك، يمكن للمشرفين استخدام أداة مزامنة دليل التشغيل لواجهة برمجة تطبيقات مستخدم واحد لتشغيل مزامنة دليل عند الطلب لمستخدم واحد.
للحصول على وثائق API مفصلة، راجع https://developer.webex.com/docs/api/guides/webex-for-broadworks-developers-guide.
تحتاج إلى تسجيل الدخول لقراءة مواصفات واجهة برمجة التطبيقات على https://developer.webex.com/docs/api/v1/broadworks-subscribers.
مزامنة مؤسسات متعددة مع واجهة برمجة التطبيقات
تتيح لك مزامنة الدليل مزامنة مؤسسة واحدة فقط من مجموعة Broadworks في كل مرة عبر مزامنة عند الطلب. إذا حاولت مزامنة أكثر من مؤسسة واحدة، فستتلقى خطأ 429
يختلف الوقت المستغرق لتشغيل مزامنة لمؤسسة واحدة حسب حجم المؤسسة.
1 | قم بتشغيل واجهة برمجة تطبيقات قائمة BroadWorks Enterprises لإنشاء قائمة بالمؤسسات التي تريد مزامنتها. |
2 | قم بتشغيل أداة مزامنة دليل التشغيل لواجهة برمجة تطبيقات المؤسسة على المؤسسة الأولى في القائمة. |
3 | انتظر بضع ثوان ثم قم بتشغيل واجهة برمجة تطبيقات الحصول على حالة مزامنة الدليل للحصول على حالة المزامنة. |
4 | بعد انتهاء المزامنة، أكمل الخطوات من 2 إلى 4 على المؤسسة التالية في القائمة. كرر هذه الخطوات حتى تقوم بمزامنة القائمة بأكملها. |
رموز الخطأ لأداة مزامنة الدليل
تنطبق رموز الخطأ التالية على أداة مزامنة الدليل.
رمز الخطأ | رسالة الخطأ |
---|---|
600000 | حدث خطأ غير متوقع في مزامنة مستخدم دليل Broadworks الخارجي. |
600001 | فشل مزامنة مستخدم دليل Broadworks الخارجي. |
600002 | يجب إنهاء مزامنة مستخدم دليل Broadworks الخارجي قبل الاكتمال. |
600003 | نجحت مزامنة مستخدم دليل Broadworks الخارجي بصورة جزئية فقط. فشل مزامنة بعض مؤسسات العملاء. |
600004 | لم يتم تمكين مزامنة مستخدم دليل Broadworks الخارجي من أجل ConfigSet. |
600005 | مزامنة مستخدم دليل Broadworks الخارجي قيد التقدم من أجل ConfigSet. |
600006 | سلاسل مزامنة مستخدم دليل Broadworks الخارجي مشغولة أو قيد الإغلاق، لذا لن تقبل المزيد من طلبات المزامنة، أعد المحاولة في وقت لاحق. |
600007 | لم يتم العثور على "مؤسسة الهوية" الخاصة بـ CustomerConfig. |
600008 | لم يتم العثور على CustomerConfig في مؤسسة الشريك |
600009 | لا يمكن تشغيل مزامنة مستخدم الدليل الخارجي Broadworks لأن مجموعة Broadworks المقترنة ب CustomerConfig مشغولة |
600010 | لا يمكن تشغيل مزامنة مستخدم دليل Broadworks الخارجي لعدم وجود مجموعة Broadworks مرتبطة بـ CustomerConfig. |
600011 | لم يتم تمكين مزامنة مستخدم دليل Broadworks الخارجي من أجل CustomerConfig. |
600012 | لا يمكن تشغيل مزامنة مستخدم دليل Broadworks الخارجي لأنه تم تمكين "الدليل الهجين" بالفعل لـ CustomerConfig. |
600013 | فشل مزامنة مستخدم دليل Broadworks الخارجي في إضافة المستخدمين وحسابات الماكينة إلى مخزن الهوية. |
600014 | فشل مزامنة مستخدم دليل Broadworks الخارجي أثناء محاولة الاتصال بمجموعة Broadworks. خطأ من Broadworks - ٪s. |
600015 | لم تعثر مزامنة مستخدم دليل Broadworks الخارجي على أي مستخدم مطابق في متجر الهوية. |
600017 | فشلت مزامنة قائمة الهاتف BroadWorks في مزامنة كافة جهات اتصال المستخدم والمؤسسة/المؤسسة. |
600018 | فشلت مزامنة قائمة هاتف BroadWorks للمستخدمين في المؤسسة/المؤسسة. |
600019 | فشلت مزامنة قائمة الهاتف BroadWorks في مزامنة جهات اتصال المؤسسة/المؤسسة. |
600020 | لا يمكن تعطيل مزامنة مستخدم الدليل الخارجي BroadWorks لأن مزامنة CustomerConfig قيد التقدم. |
600022 | لا يمكن مزامنة مستخدم واحد في دليل BroadWorks الخارجي نظرا لعدم وجود مستخدم متوفر لدى المؤسسة. |
600023 | الدليل الخارجي BroadWorks مزامنة مستخدم واحد غير ممكن لأن المستخدم موجود بالفعل في هذه المؤسسة. |
600024 | الدليل الخارجي BroadWorks مزامنة مستخدم واحد غير ممكن لأنه لم يتم العثور على مستخدم مطابق في BroadWorks. |
600025 | فشل مزامنة مستخدم الدليل الخارجي BroadWorks في تحديث حساب المستخدم في CI. |
600026 | فشلت مزامنة مستخدم الدليل الخارجي ل BroadWorks في تحديث حساب الجهاز في CI. |
600027 | الدليل الخارجي BroadWorks مزامنة مستخدم واحد غير ممكن لأنه تم العثور على عدة مستخدمين في BroadWorks. |
600028 | مزامنة مستخدم واحد الدليل الخارجي BroadWorks غير ممكن لأنه يجب إكمال مزامنة دليل مؤسسة واحد على الأقل. |
600029 | فشلت مزامنة مستخدم دليل BroadWorks الخارجي لأن المؤسسة لا يوجد بها مستخدم تم توفيره. |
سجل التغييرات
يلخص الجدول التالي تحديثات هذه المقالة.
التاريخ | المراجعة |
---|---|
14 فبراير، 2023 | تم تحديث الحد الأقصى لمزامنة الدليل وقسم المصدر . |
ديسمبر 10, 2022 | تم تحديث المصطلح مزامنة فورية كاملة لتشغيل مزامنة الدليل |
يوليو 19, 2022 | توضيحات وتصحيحات لمعلومات النظرة العامة:
|
مايو 09, 2022 |
|
أبريل 07, 2022 |
|
28 مارس 2022 |
|
24 مارس 2022 | تمت إضافة قائمة بأنواع أرقام الهواتف التي تمت مزامنتها إلى شروطمزامنة الدليل. تتضمن المزامنة الآن أرقام الهواتف المحمولة. |
16 مارس، 2022 |
|
ديسمبر 17, 2021 |
|
ديسمبر 16, 2021 |
|
ديسمبر 08, 2021 |
|