سيتم إنشاء الهواتف المدعومة وتعيينها تلقائيًا للمستخدمين في Webex Calling بواسطة أداة التزويد. سيتم أيضًا نقل الهواتف التي تم وضع علامة "نعم" عليها في عمود "مدعوم في أداة نقل الجهاز" تلقائيًا من Cisco BroadWorks أو BroadCloud إلى Webex Calling عند تشغيل أداة نقل الجهاز. الهواتف التي تحمل علامة "لا" في ذلك العمود تحتاج إلى تدخل يدوي لتغيير عنوان URL الخاص بـ DMS في قالب جهاز Cisco BroadWorks أو في الهاتف نفسه.

يُقدّم العمود الأخير ربطًا بين طرازات الهواتف وعمود "نوع الجهاز" في الملف. transform-tool/input/newphones.csv. (انظر قسم أداة التحويل في هذه المقالة لمزيد من المعلومات حول newphones.csv).

يجب على مسؤولي الشركاء تشغيل أداة توليد الرموز المميزة هذه مرة واحدة على الأقل قبل البدء في تشغيل أدوات الترحيل. يُعد تشغيل هذه الأداة نشاطًا لمرة واحدة بعد انضمام حساب الشريك إلى حل إدارة حركة المرور بالجملة. تتيح هذه الأداة لمسؤولي الشركاء تسجيل الدخول عبر متصفح الويب للحصول على الرمز المميز الفريد اللازم لتحديث ملفات تكوين الشريك لأدوات الترحيل.

المتطلبات المسبقة

قم بتثبيت Java 8 أو 11 أو 17 أو 21 على الكمبيوتر. تتوفر لغة جافا من مصادر عديدة، بما في ذلك:

• https://learn.microsoft.com/en-us/java/openjdk/download
• https://aws.amazon.com/corretto/
• https://www.oracle.com/java/technologies/downloads/#java21

بعد التنزيل، قم باستخراج الملفات الثنائية لأداة الترحيل.

تعليمات التشغيل

قم بتشغيل الأمر التالي في الطرفية داخل دليل مولد الرموز المميزة:

نظام التشغيل Windows:

token_generator.bat

نظام التشغيل ماك أو إس:

./token_generator.sh

الناتج:

Tool Name: Token Generator Tool
Version: 1.13.0
Load the URL in your web browser: http://localhost:8080

افتح عنوان URL في متصفح الويب على الجهاز، وقم بتسجيل الدخول باستخدام بيانات اعتماد مسؤول الشريك للحصول على الرمز المميز وانسخه لاستخدامه لاحقًا.

تُعرض أدناه رسومات توضيحية لواجهة المستخدم كمرجع:

الشكل رقم 3: تسجيل الدخول باستخدام Cisco Webex

الشكل رقم 4: نافذة بيانات الاعتماد

الشكل رقم 5: توليد الرموز

قم بتكوين الخطوات التالية قبل تشغيل أدوات الاستخراج ونقل الأجهزة في خادم BroadWorks الثانوي.

تفعيل اتصال OCI-P

تتواصل أداة نقل الجهاز مع BroadWorks من خلال أوامر OCI-P، ولتمكين اتصال OCI-P، اتبع الخطوات التالية:

الخطوة 1: استخدم واجهة سطر الأوامر لضبط الإعدادات العامة.

قم بتشغيل الأمر التالي في واجهة سطر الأوامر للانتقال إلى دليل GeneralSettings:

AS_CLI> cd /Applications/OpenClientServer/GeneralSettings.

قم بتشغيل الأمر التالي في واجهة سطر الأوامر للحصول على الإعدادات العامة الحالية:

AS_CLI/Applications/OpenClientServer/GeneralSettings> get
clientPort = 2208
clientPortEnabled = true
secureClientPort = 2209
secureClientPortEnabled = true
systemDomain = <>

إذا لم تتطابق إعداداتك مع ما سبق، فاستخدم الأمر set لإعادة تكوين إعداداتك.

الخطوة 2: استخدم واجهة سطر الأوامر (CLI) لتكوين وكيل OCI.

قم بتغيير الدليل إلى OCI Proxy:

AS_CLI> cd /Applications/OpenClientServer/OCIProxy

قم بتشغيل واجهة سطر الأوامر التالية للحصول على الإعدادات الحالية. يجب أن ترى ما يلي:

AS_CLI/Applications/OpenClientServer/OCIProxy> get
enabled = true
enabledLoginLevelScreening = false
enableResponseCaching = false
responseCacheDurationHours = 24
responseCacheRenewPeriodMins = 30
messageQueueCapacity = 50
messageQueueTimeoutSeconds = 1800

إذا لم تتطابق إعداداتك مع ما سبق، فاستخدم الأمر set لإعادة تكوين إعداداتك.

الخطوة 3: استخدم واجهة سطر الأوامر (CLI) لتكوين خدمة OCI Provisioning.

انتقل إلى دليل التزويد:

AS_CLI> cd /System/NetworkAccessLists/OCI/Provisioning

قم بتشغيل الأمر التالي للحصول على إعدادات توفير OCI الحالية:

AS_CLI/System/NetworkAccessLists/OCI/Provisioning> get
Address Description
========================
127.0.0.1 local as

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

 AS_CLI/Maintenance/ManagedObjects> get broadworks and check
that your output looks OK.
See below for sample output:
AS_CLI/Maintenance/ManagedObjects> get broadworks
BroadWorks Managed Objects
==========================
* Server:
Identity..............: AS
Version...............: Rel_21.sp1_1.551
Administrative State..: Unlocked
* Applications:
Name Version Deployed Administrative State Effective State
=========================================================================================
ExecutionAndProvisioning 21.sp1_1.551 true Unlocked Unlocked
FlashPolicy 21.sp1_1.551 false Unlocked Stopped
OpenClientServer 21.sp1_1.551 true Unlocked Unlocked
WebContainer 21.sp1_1.551 true Unlocked Unlocked
4 entries found.
* Hosted Applications:
Name Version Context Path Deployed
==================================================================
CommPilot 21.sp1_1.551 / true
DeviceManagementFiles 21.sp1_1.551 /DeviceManagement true
JWSFiles 21.sp1_1.551 /FileRepos true
MediaFiles 21.sp1_1.551 /media true
OCIFiles 21.sp1_1.551 /ocifiles true
5 entries found.

تحقق من نشر خادم العميل المفتوح وتفعيله

استخدم الأوامر أدناه لنشر وبدء تشغيل خادم العميل المفتوح على خادم التطبيقات الثانوي إذا لم يتم نشره أو لم يتم تشغيله بالفعل.

الخطوة 1: قم بنشر الخادم باستخدام أمر سطر الأوامر التالي:

AS_CLI/Maintenance/ManagedObjects> deploy application OpenClientServer

الخطوة 2: ابدأ تشغيل الخادم باستخدام هذا الأمر:

AS_CLI/Maintenance/ManagedObjects> start application OpenClientServer

تفعيل تفعيل الأرقام

قم بتنفيذ الأوامر التالية في واجهة سطر الأوامر لتمكين تفعيل الأرقام:

الخطوة 1: قم بتشغيل أمر تفعيل الرقم:

AS_CLI> cd SubscriberMgmt/NumberActivation

الخطوة 2: قم بتشغيل أمر التفعيل المُفعّل:

AS_CLI> set dnMode groupAndUserActivationEnabled

الخطوة 3: عند ظهور نافذة التأكيد، أدخل Y.

لـ BroadCloud

أداة الاستخراج مدمجة في بوابة موفر خدمة BroadCloud. يمكن لمسؤول مزود الخدمة ما يلي:

1. يمكنك تقديم طلبات استخراج البيانات لما يصل إلى 50 عميلاً لكل طلب.
   لا يمكن تقديم طلب استخراج البيانات لنفس العميل أكثر من 10 مرات في اليوم.
2. قم بتنزيل ملف البيانات المستخرج، بتنسيق ZIP، لمدة تصل إلى 28 يومًا من تاريخ تقديم الطلب.

توضح الأشكال التالية بوابة مزود الخدمة.

الشكل 6: بوابة مزود الخدمة

الشكل 7: بوابة مزود الخدمة

طلب استخراج ملف CSV

بدء طلب استخراج ملف CSV

1. قم بتنزيل ملف CSV الخاص بالعميل

   انقر على رابط تنزيل ملف CSV الخاص بالعميل في الزاوية العلوية اليمنى من قسم بدء طلب استخراج ملف CSV.

2. تعديل قائمة العملاء

   يمكن للمسؤول تعديل ملف CSV هذا ليشمل فقط العملاء الذين يلزم استخراج بياناتهم.

3. قم بتحميل الملف وإرساله

   بعد التعديل، قم بتحميل ملف CSV المعدل.

   انقر على إرسال لبدء طلب استخراج بيانات العملاء المدرجين ومواقعهم المرتبطة.

بدء طلب استخراج بيانات عميل باستخدام ملف CSV للمواقع

1. حدد موقع العميل ومواقع التنزيل

   اختر عميلاً من القائمة المنسدلة.

   قم بتنزيل ملف locations.csv المقابل من عرض العملاء→ علامة تبويب المواقع → تصدير المواقع كملف CSV.

2. قم بتحرير ملف المواقع

   يمكن للمسؤول تعديل ملف CSV ليشمل فقط المواقع التي يرغب في استخراجها.

3. قم بتحميل الملف وإرساله

   قم بتحميل ملف locations.csv المُعدّل وانقر على إرسال.

   سيتم تضمين المواقع المحددة للعميل المختار فقط في طلب الاستخراج.

بدء طلب استخراج البيانات لجميع العملاء

1. انقر فوق إرسال لبدء طلب استخراج لـ جميع العملاءوجميع مواقعهم تحت مزود الخدمة الحالي.

لـ Cisco BroadWorks و Webex for BroadWorks

1. تعمل أداة الاستخراج على خادم تطبيقات Cisco BroadWorks الثانوي داخل شبكة الشريك وتتصل عبر OCI-P.
2. تقوم الأداة بسحب البيانات الأولية للمؤسسات والمجموعات والأرقام والمستخدمين والخدمات والأجهزة وبيانات العميل البرمجي من منصة Cisco BroadWorks أو BroadCloud وإخراج هذه البيانات إلى ملفات XML التي توفر المدخلات لأداة التحويل.

تشرح الأقسام التالية كيفية تثبيت أداة الاستخراج وتكوينها.

المتطلبات المسبقة

1. قم بنقل الملفات الثنائية لأداة الاستخراج إلى خادم تطبيقات Cisco BroadWorks الثانوي باستخدام بروتوكول SCP.
2. قم بالاتصال عبر SSH بخادم تطبيقات Cisco BroadWorks الثانوي لتكوين المتطلبات الأساسية وتشغيل أداة الاستخراج.
3. قم بتكوين موفر الخدمة ومعرف المجموعة لاستخراجهما من Cisco BroadWorks في conf/exportTool.yml. راجع مقتطف YAML النموذجي التالي:

   ServiceProviderID-A:
        - GroupID-A1
        - GroupID-A2
        - GroupID-A3
   ServiceProviderID-B:
                          - ALL
   

4. تأكد من صحة اسم المستخدم وكلمة المرور واسم المضيف لخادم تطبيقات Cisco BroadWorks الثانوي في conf/partner.cfg ملف:

   BROADWORKS_USER_ID = admin
   BROADWORKS_PASSWORD = admin
   BROADWORKS_HOST_NAME = localhost
   REFRESH_TOKEN = Partner administrator’s refresh token copied from the Token Generator tool.
   

   خاصية REFRESH_TOKEN إلزامية لعملية ترحيل Webex إلى BroadWorks.

5. قم بتعديل JDK/JRE مسار البيئة في ملف export.sh إذا كان خادم تطبيقات Cisco BroadWorks الثانوي JDK/JRE مسار البيئة يختلف عن مسار الملف:

   JAVA_HOME=/usr/local/java/java_base

تعليمات التشغيل

قم بتشغيل الأمر التالي في خادم تطبيقات Cisco BroadWorks الثانوي من دليل أداة الاستخراج:

./export.sh

سجلات الطرفية

تتوفر السجلات التالية في الجهاز الطرفي عند نجاح عملية التصدير: تشغيل أداة تصدير البيانات من BroadSoft:

 Running BroadSoft Data Export Tool
************************************************
Starting Export Tool v: 1.15.0
Export started for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Exporting users for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Export users completed for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Export completed for SP=collabmigrationtestSP_engg, Group=collabmigrationtestGRP_engg
Export completed
Export Dump Zip Directory : output/20221017223452_ExportTool
Export Dump Zip File name :extracted_data_1666060500618.zip
Zip file with the name extracted_data_1666060500618.zip has been created
ZIP file creation process completed 
Exported files converted as ZIP file
**************************************************

الناتج

يتوفر ملف ZIP الناتج (extracted_data_<timestamp>.zip) في نفس دليل أداة الاستخراج. استخدم الأمر التالي لعرض واستخدام ملف ZIP كمدخل لأداة التحويل:

ls –ltr
drwxr-xr-x 2 bwadmin bwadmin   4096 Oct  4 11:53 lib/
-rwxr-xr-x 1 bwadmin bwadmin 956719 Oct  4 11:53 exportTool.jar
-rwxr-xr-x 1 bwadmin bwadmin   2635 Oct  4 11:53 export.sh
drwxr-xr-x 2 bwadmin bwadmin   4096 Oct  5 05:04 conf/
drwxrwxr-x 3 bwadmin bwadmin   4096 Oct 17 22:34 output/
drwxrwxr-x 2 bwadmin bwadmin   4096 Oct 17 22:34 logs/
-rw-rw-r-- 1 bwadmin bwadmin  46341 Oct 17 22:35 extracted_data_1666060500618.zip

يتم تشغيل أداة التحويل هذه لجميع عمليات الترحيل. تعمل أداة التحويل على أي جهاز كمبيوتر، بما في ذلك جهاز الكمبيوتر المحمول الخاص بمسؤول الشريك، وتستخدم واجهات برمجة تطبيقات Webex العامة. يقرأ ملف ZIP الناتج عن أداة الاستخراج (extracted_data_<timestamp>.zip) كمدخل ويحول XML الخام إلى تنسيق JSON الذي تستخدمه أداة التزويد.

المتطلبات المسبقة

بعد تنزيل واستخراج الملفات الثنائية لأدوات الترحيل، قم بتكوين المتطلبات الأساسية التالية:

1. _قم بتعيين رمز_التحديث (رمز تم نسخه من أداة إنشاء الرموز)_واسم الموقع_الرئيسي في conf/partner.cfg ملف:

   REFRESH_TOKEN=MzUwYjljODEtYmQ4MS00NGVhLTgwNGUtZjQ1NTEyZTViNzJkOTdj
   NAME_OF_MAIN_LOCATION=Main
   

2. يمكنك اختيارياً تعيين معرّف PROVISIONING_(المنسوخ من القالب في مركز الشركاء) في conf/partner.cfg ملف:

   PROVISIONING_ID=YmE4MjFkZGYtYTlkNy00NDdlLWIwODctYmNkOTM2NjUyYWQ1

   للحصول على تحقق أكثر اكتمالاً من عنوان البريد الإلكتروني للعميل، يمكنك اختيارياً تعيين معرف التزويد_.
3. قم بتهيئة المعلومات المفقودة في input/customers.csv الملف (انظر القسم التالي) في حالة عدم وجوده.
4. أضف عنوان البريد الإلكتروني للمستخدم النهائي في input/users.csv ملف.
5. في حال إضافة هواتف جديدة، أضف عنوان MAC وعنوان البريد الإلكتروني الخاصين بالهاتف الجديد للمستخدم إلى input/newphones.csv ملف. هذا مطلوب فقط إذا أراد مسؤولو الشركاء توفير هواتف جديدة في خدمة الاتصال بالجملة.
6. قم بتحويل مراكز اتصال BroadWorks إلى CxEssentials باستخدام input/cxessentials.csv ملف.
7. اختيارياً، قم بتمكين خاصية UPGRADE_ALL_CALL_CENTERS_TO_CX_ESSENTIALS لتحويل جميع مراكز الاتصال إلى CxEssentials.
8. استخدم input/locations.csv ملف لدعم عملية نقل بيانات المؤسسات الكبيرة التي تسمح للمسؤولين بنقل مواقع عملائهم موقعًا تلو الآخر
9. يمكنك اختيارياً تمكين استخدام عناوين MAC من رأس User-Agent لرسالة SIP REGISTER عندما لا يكون عنوان MAC متاحًا في ملف تعريف جهاز Cisco BroadWorks. قم بإلغاء التعليق على السطر USE_MAC_ADDRESS_FROM_SIP_REGISTER=yes في الملف conf/partner.cfg
10. يمكنك اختيارياً تمكين الخصائص ANALOG_USER_TYPE_ENABLE_CALL_WAITING و ANALOG__USER [ ] TYPE_ENABLE_MUSIC_ON_HOLD و ANALOG_USER_TYPE_DISABLE_T38 لتكوين انتظار المكالمات والموسيقى أثناء الانتظار وتعطيل إعدادات T38 لجميع مستخدمي النوع التناظري.

11. إذا كنت ترغب في إعداد أجهزة بوابة عامة، فأضف عنوان MAC الخاص بالجهاز ومعرف المستخدم إلى input/genericgateways.csv ملف. كذلك، اذكر ما إذا كان المستخدم هو المالك الأساسي أو مستخدم مشترك (للمشاركة في المكالمات). هذا مطلوب فقط إذا كان مسؤولو الشركاء يخططون لاستخدام أجهزة بوابة عامة في خدمة الاتصال بالجملة.

    هذه الميزة غير متاحة لعمليات نقل البيانات من BroadCloud إلى Wholesale.

12. بالنسبة لعمليات نقل BroadCloud، لتحويل جميع المستخدمين الذين لديهم نوع محطة المراسلة إلى voice_mail_group، قم بتحديث ملف conf/rialto_station_type_to_wholesale_package.csv عن طريق استبدال قيمة Wholesale Package بـ voice_mail_group للصف الذي يكون فيه نوع محطة Rialto هو المراسلة.

    اختياريًا، قم بتمكين الخاصية COMMON_VOICE_MAIL_GROUP_PASSCODE في ملف partner.cfg لتكوين رقم التعريف الشخصي الافتراضي لمجموعات البريد الصوتي.

    إذا لم يتم تحديد هذه الخاصية في partner.cfg، فيجب توفيرها لكل عميل في ملف customers.csv تحت عمود commonVoicemailGroupPassCode.

13. لنقل جهات الاتصال المشتركة إلى Webex Calling

    إنها إضافة لتحسين إدارة جهات الاتصال المشتركة على مستوى المؤسسة والموقع. يمكن الآن نقل جهات الاتصال هذه إما كجهات اتصال خاصة بالمنظمة (جهات اتصال المنظمة) أو كامتدادات افتراضية، بناءً على إعدادات التكوين. فيما يلي التفاصيل التي ستساعدك في عملية النقل هذه.

    إعدادات المفاتيح:

    • مشترك_هاتف_قائمة_إلى_افتراضي_امتداد_بداية_نطاق

      تم إدخال خاصية جديدة، COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE، في ملف partner.cfg. تحدد هذه الخاصية كيفية نقل جهات الاتصال الشائعة من Rialto إلى Webex Calling.

    • بدون تكوين COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE

      سيتم نقل جهات الاتصال المشتركة كجهات اتصال خاصة بالمنظمة (جهات اتصال المنظمة).

      لا يلزم أي تكوين إضافي.

      تظل جهات الاتصال متاحة على مستوى المنظمة.

    • مع تكوين COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE

      سيتم نقل جهات الاتصال المشتركة كامتدادات افتراضية.

      سيتم إلحاق كل جهة اتصال برقم داخلي، ويتم تحديد نطاق بداية الرقم الداخلي في الخاصية COMMON_PHONE_LIST_TO_VIRTUAL_EXTENSION_START_RANGE في partner.cfg.

      يتم دعم الامتدادات الافتراضية على مستوى المؤسسة ومستوى الموقع، وذلك حسب نطاق الاتصال.

14. تفعيل خدمة تسجيل المكالمات الافتراضية لـ Webex.

    هذه الخطوة مطلوبة فقط عند ترحيل إعدادات تسجيل المكالمات للمستخدمين الذين تم تكوينهم باستخدام Dubber إلى Cisco Native Call Recording في Webex.

    لتفعيل هذا الخيار:

    • في ملف partner.cfg، قم بتعيين الخاصية التالية، DEFAULT_CALL_RECORDING_VENDOR=Webex.
    • بالإضافة إلى ذلك، استخدم الخاصية WEBEX_CALL_RECORDING_STORAGE_REGION لتكوين منطقة التخزين.

      خيار التسجيل عند الطلب من BroadCloud غير مدعوم في Webex Calling. لن يتم نقل إعدادات تسجيل المكالمات هذه وستظهر في تقرير الاستثناءات.

15. استبعاد أرقام هواتف محددة من عملية النقل:

    لاستبعاد أرقام هواتف محددة من عملية النقل، يجب اتباع الإجراء المكون من خطوتين التاليين باستخدام أداة التحويل:

    • قم بتشغيل أداة التحويل لأول مرة. عند الانتهاء، ستُنشئ الأداة ملفًا باسم telephone_numbers_inventory.csv، موجودًا داخل output/timestamp/ دليل. يُطلب من العميل مراجعة هذا الملف وتحديد "نعم" في عمود "حذف أرقام الهواتف" لكل رقم هاتف يجب استبعاده من عملية النقل القادمة.
    • بعد تحديث ملف telephone_numbers_inventory.csv بعلامات الاستبعاد المناسبة، يتم تنفيذ أداة التحويل مرة ثانية. يجب تمرير الملف المحدث كوسيط بالصيغة التالية.

      ./transform.sh -extract=input/extracted_data_1747640608219.zip -decommissionnumbers={filepath/telephone_numbers_inventory.csv}

16. اختياريًا، قم بتعيين خاصية ALLOW_RESTRICT_BY_PARTNER_MODE إلى OFF للسماح لمسؤولي العملاء بتعديل الإعدادات المحددة من قبل الشريك في مركز التحكم.
17. لنقل أرقام الهواتف المحمولة (BroadWorks Mobility) من BroadCloud إلى Webex Calling

    يوضح هذا القسم عملية نقل ميزة BroadWorks Mobility(أرقام هواتف العملاء المحمولة) من BroadCloud (تكامل شبكة الهاتف المحمول) إلى Wholesale Webex Calling (Webex Go Mobile Network Operator).

    المتطلبات الأساسية- قبل بدء عملية الترحيل، يجب على مسؤولي الشركاء التواصل مع فريق حساب Cisco لإجراء تكوين بائع PSTN المتصل بالسحابة (CCP) وقائمة شركات الاتصالات المخصصة (CCL).

    تمت إضافة خاصية جديدة، ASSIGN_MOBILE_NUMBERS_TO_USERS، إلى ملف partner.cfg. قم بتمكين هذه الخاصية للسماح بتعيين أرقام الهواتف المحمولة ونقلها إلى المستخدمين.

    • هذه الميزة مدعومة فقط لعمليات الترحيل من BroadCloud إلى Wholesale .
    • في خدمة Webex بالجملة، يمكن للمستخدمين النهائيين الحصول إما على رقم جوال أو رقم PSTN (وليس كليهما)، على عكس خدمة BroadCloud.
    • عندما يتم تخصيص رقم جوال لمستخدم، يصبح رقم PSTN الأساسي الخاص به هو رقمه الثانوي (البديل).
    • لا يمكن نقل أرقام الهواتف المحمولة للمستخدمين الذين يتم تحويلهم إلى مساحات عمل أو خطوط افتراضية.
    • بعد تعيين رقم جوال في برنامج Webex بالجملة، سيظهر كـ "نشط" في مركز التحكم. لا يعني هذا الوضع أن الرقم جاهز لاستقبال المكالمات فوراً. لن تتوفر إمكانية الاتصال إلا بعد اكتمال عملية الترحيل بالكامل.
    • لا يتم ترحيل إعدادات تكامل الهاتف المحمول التي قام المستخدمون النهائيون بتكوينها في بوابة المستخدم المتصل (CUP). بعد عملية النقل، عند الاتصال برقم هاتف أو رقم جوال أو رقم داخلي، سترن جميع أجهزة المستخدم.

تعبئة input/customers.csv

الملف input/customers.csv يوفر بيانات قد تكون مفقودة في Cisco BroadWorks أو BroadCloud. يمكن ترك هذا الملف فارغاً إذا كانت جميع المعلومات الإلزامية متوفرة بالفعل. ليس عليك ملء جميع الأعمدة، المعلومات المفقودة فقط هي الإلزامية.

يوضح الجدول أدناه أهم الأعمدة في input/customers.csv.

تعبئة input/users.csv

الملف input/users.csv يوفر بيانات قد تكون مفقودة في Cisco BroadWorks أو BroadCloud. يمكن ترك هذا الملف فارغاً إذا كانت جميع المعلومات الإلزامية متوفرة بالفعل. ليس عليك ملء جميع الأعمدة، المعلومات المفقودة فقط هي الإلزامية.

تعليمات التشغيل

قم بتشغيل أداة التحويل في أي نظام تشغيل. اتبع الخطوات التالية لتشغيل الأداة في نظامي التشغيل ويندوز وماك أو إس:

Windows

نفّذ الأمر التالي لتشغيل أداة التحويل في نظام التشغيل ويندوز:

transform.bat -extract= -customers= -users= -newphones=

نظام التشغيل macOS

اتبع الخطوات التالية لتشغيل أداة التحويل على نظام macOS:

1. قم بإنشاء بيئة افتراضية وتثبيت التبعيات لتشغيل أداة التحويل باستخدام لغة بايثون:

   python3 -m venv venv
   source venv/bin/activate
   python3 -m pip install requests
   python3 -m pip install requests-oauthlib
   python3 -m pip install phonenumbers
   

2. قم بتشغيل أداة التحويل:

   ./transform.sh -extract= -customers= -users= -newphones=

Customer/user الفحص المسبق

تقوم أداة التحويل بإجراء استدعاءات API إلى Webex لاكتشاف مشكلات التزويد المحتملة. بشكل افتراضي، سيتم التحقق من صحة عنوان العميل وبريده الإلكتروني الأساسي. إذا تم تحديد قيمة معرف PROVISIONING_في conf/partner.cfg سيقوم الملف أيضًا بالتحقق من صحة معلومات الموقع. يتم تضمين نتائج الفحص المسبق في تقرير الاستثناءات.

بالإضافة إلى ذلك، يمكن إضافة المعلمات الاختيارية التالية عند تشغيل أداة التحويل:

الفحص المسبق

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

معلومات الفحص المسبق

بشكل افتراضي، يتم تضمين أخطاء الفحص المسبق فقط (أي المشكلات التي ستمنع التزويد) في تقرير الاستثناء. إضافة هذا العلم ستتضمن نتائج الفحص المسبق الناجحة أيضًا (على سبيل المثال، إذا كانت مؤسسة Webex موجودة بالفعل ويمكن إرفاقها تلقائيًا).

سجلات الطرفية

تظهر السجلات التالية في الطرفية عند نجاح عملية التحويل:

Summary Report
BroadWorks enterprises that can be successfully migrated: 1
BroadWorks enterprises that cannot be migrated: 0
BroadWorks users that can be successfully migrated: 4
BroadWorks users that cannot be migrated: 0
Phones that can be successfully migrated: 3
Phones that are not compatible with Webex Calling: 0

تقرير الاستثناءات

تقوم أداة التحويل بإنشاء تقرير الاستثناءات داخل output/<timestamp>/exception_report.txt directory. يمكنك استخدام هذا التقرير لتحديد المشكلات التي ستؤثر على عملية الترحيل وإصلاحها في نظام Cisco BroadWorks.

بعد تعديل بيانات المستخدم لحل الاستثناء، أعد تشغيل أدوات الاستخراج والتحويل باستخدام البيانات الجديدة. ملف تقرير الاستثناءات النموذجي كما يلي:

Exception Report
Tue Oct 18 08:12:09 2022

Enterprises with Communication Barring Feature
Recommendation: manually configure the Outgoing Calling Plan in Control Hub
________________________________________________________________________________
collabmigrationtestGRP_engg

الناتج

سيكون ملف JSON الناتج (customer.json) متاحًا في output/<timestamp>/<groupid> دليل. ملف customer.json النموذجي هو كما يلي:

{
    "customer": {
        "provisioningId": "!!!!!!!!!!REPLACE_WITH_PROVISIONINGID!!!!!!!!!!",
        "packages": [
            "webex_calling",
            "common_area_calling"
        ],
        "externalId": "external_id_engg_grp1",
        "address": {
            "addressLine1": "100 Main Street",
            "addressLine2": "",
            "city": "Gaithersburg",
            "stateOrProvince": "MD",
            "zipOrPostalCode": "20877",
            "country": "US"
        },
        "customerInfo": {
            "name": "Engineering Group - 1",
            "primaryEmail": "amareswaranvel+engineeringgroup1@gmail.com"
        },
        "provisioningParameters": {
            "calling": {
                "location": {
                    "name": "Main",
                    "address": {
                        "addressLine1": "100 Main Street",
                        "addressLine2": "",
                        "city": "Gaithersburg",
                        "stateOrProvince": "MD",
                        "zipOrPostalCode": "20877",
                        "country": "US"
                    },
                    "timezone": "America/New_York",
                    "language": "en_us",
                    "numbers": [
                        "+15205551101",
                        "+15205551102",
                        "+15205551103",
                        "+15205551104",
                        "+15205551105",
                        "+15205551106",
                        "+15205551107",
                        "+15205551108",
                        "+15205551109",
                        "+15205551110"
                    ],
                    "mainNumber": "+15205551101"
                }
            }
        }
    },
    "broadworks_info": {
        "service_provider_id": "collabmigrationtestSP_engg",
        "group_id": "collabmigrationtestGRP_engg"
    },
    "subscribers": [
        {
            "amareswaranvel+benjaminjack@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+benjaminjack@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Benjamin",
                        "lastName": "Jack",
                        "primaryPhoneNumber": "+15205551102",
                        "extension": "1102"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineering17861@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": [
                    {
                        "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
                        "product": "DMS Cisco 7861",
                        "mac": "CC98914EAAD7"
                    }
                ]
            }
        },
        {
            "amareswaranvel+lucasoliver@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+lucasoliver@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Lucas",
                        "lastName": "Oliver",
                        "primaryPhoneNumber": "+15205551103",
                        "extension": "1103"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineering16821@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": [
                    {
                        "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
                        "product": "DMS Cisco 6821",
                        "mac": "5486BCAE7E45"
                    }
                ]
            }
        },
        {
            "amareswaranvel+leojackson@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+leojackson@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Leo",
                        "lastName": "Jackson",
                        "primaryPhoneNumber": "+15205551104",
                        "extension": "1104"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineeringmacpc@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": []
            }
        },
        {
            "amareswaranvel+owenalex@gmail.com": {
                "subscriber": {
                    "customerId": "!!!!!!!!!!REPLACE_WITH_CUSTOMERID!!!!!!!!!!",
                    "email": "amareswaranvel+owenalex@gmail.com",
                    "package": "webex_calling",
                    "provisioningParameters": {
                        "firstName": "Owen",
                        "lastName": "Alexander",
                        "primaryPhoneNumber": "+15205551101",
                        "extension": "1101"
                    }
                },
                "features": [
                    {
                        "/v1/people/{personId}/features/voicemail": {
                            "enabled": true,
                            "sendBusyCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT"
                            },
                            "sendUnansweredCalls": {
                                "enabled": true,
                                "greeting": "DEFAULT",
                                "numberOfRings": 3
                            },
                            "messageStorage": {
                                "mwiEnabled": true,
                                "storageType": "EXTERNAL",
                                "externalEmail": "engineering8811@mailnator.com"
                            }
                        }
                    }
                ],
                "devices": [
                    {
                        "cisUuid": "!!!!!!!!!!REPLACE_WITH_PERSONID!!!!!!!!!!",
                        "product": "DMS Cisco 8811",
                        "mac": "F87B204E4066"
                    }
                ]
            }
        }
    ],
    "auto_attendants": [],
    "call_queues": [],
    "hunt_groups": [],
    "schedules": [],
    "call_parks": [],
    "call_pickups": [],
    "paging_groups": [],
    "voice_portals": [
        {
            "name": "Automated Voice Portal",
            "firstName": "Automated",
            "lastName": "Voice Portal",
            "languageCode": "en_us",
            "phoneNumber": "+15205551105",
            "extension": "1105"
        }
    ],
    "shared_call_appearances": [],
    "business_communicator_desktop_to_upgrade_to_webex_app": [
        "PC Comm - Engg Device Profile"
    ],
    "connect_client_to_upgrade_to_webex_app": [],
    "locations": [],
"webex_for_broadworks_info": {
        "users": [
            {
                "id": "Y2lzY29zcGFyazovL3VzL1NVQlNDUklCRVIvY2QzNGViNWYtYTVmMi00OWQ1LTlkNWMtZTg1MDJiMDE4YTQ5"
            }
        ],
        "hydra_orgId": "Y2lzY29zcGFyazovL3VzL09SR0FOSVpBVElPTi9jMjJiYTMwNC1mODQ4LTRlOTktYWFmYy0zYWRlMjBmYTgzZTg",
        "hydra_customer_config_id": "Y2lzY29zcGFyazovL3VzL0VOVEVSUFJJU0UvYmIyMzA1MDEtMTUzMS00MzNiLTllM2QtODExY2FlYTExYmVk"
    }
}