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