- الرئيسية
- /
- المقال
XML للهواتف على BroadWorks
تنطبق مقالة التعليمات هذه على Cisco Desk Phone 9800 Series وCisco Video Phone 8875 المسجلين في Cisco BroadWorks. اقرأ هذه المقالة للتعرف على كائنات XML المدعومة وعناوين URI وخطوات تكوين خدمات XSI على صفحة ويب الهاتف.
نظرة عامة
واجهة خدمات XML (XSI) هي بروتوكول يسمح بالاتصال بين التطبيقات ونظام الهاتف. يمكنك إضافة خدمات XSI الخاصة بك إلى هاتفك باستخدام كائنات XML المدعومة وعناوين URI.
بعد اشتراك الهاتف في الخدمات، يمكن للمستخدمين الوصول إلى جميع الخدمات التي تمت تهيئتها على الهاتف من خلال الانتقال إلى
. خدمات Cisco XML هي الاسم الافتراضي. يمكنك أيضا تغيير الاسم. لتوفير وصول سهل للمستخدمين، يمكنك إضافة تطبيقات XML إلى المفاتيح البرمجية أو مفاتيح الخط.الميزات المدعومة هي:
- الرسائل (الصور والنصوص)
- ترحيل الصفحات
الكائنات XML المدعومة
-
CiscoIPPhoneMenu
-
CiscoIPPhoneText
-
CiscoIPPhoneInput
-
CiscoIPPhoneDirectory
-
CiscoIPPhoneImage
-
CiscoIPPhoneImageFile
-
CiscoIPPhoneIconMenu
-
CiscoIPPhoneIconFileMenu
-
CiscoIPPhoneStatus (باستثناء 9841)
-
ملف CiscoIPPhoneStatusFile (باستثناء 9841)
-
CiscoIPPhoneExecute
عناوين URI المدعومة
-
الجهاز
-
الطلب الهاتفي
-
إديتديل
-
بداية
-
مفتاح
-
تشغيل (نغمات الرنين فقط)
-
المفتاح الوظيفي
لمزيد من التفاصيل حول تكوين خدمة XSI، راجع Cisco Unified IP Phone ملاحظات تطوير تطبيق الخدمات.
تهيئة هاتف للاتصال بخدمة XML
1 |
يمكنك الوصول إلى صفحة ويب إدارة الهاتف. |
2 |
حدد . |
3 |
في القسم XML الخدمة ، قم بتكوين معلمات XML اسم خدمة التطبيق و XML URL لخدمة التطبيق كما هو محدد في معلمات الخدمات XML. |
4 |
(اختياري) لإضافة مصادقة للوصول إلى خدمة التطبيق، قم بتكوين حقول الأطروحة: XML اسم المستخدم وكلمة المرور XML وتمكين CISCO XML EXE ووضع مصادقة CISCO XML EXE. |
5 |
انقر فوق حفظ كافة التغييرات. |
معلمات الخدمات XML
يحدد الجدول التالي وظيفة معلمات تطبيق XML واستخدامها في القسم XML الخدمة ضمن في واجهة ويب الهاتف. كما أنه يحدد بنية السلسلة التي تمت إضافتها في ملف تكوين الهاتف (cfg.xml) باستخدام رمز XML لتكوين معلمة.
المعلمة |
الافتراضي والخيارات |
الوصف |
---|---|---|
اسم خدمة تطبيق XML |
القيمة الافتراضية: فارغ |
اسم تطبيق XML. يتم عرض الاسم على الهاتف كخيار لتطبيق ويب. كما يمكنك تكوين هذه المعلمة في ملف XML لتكوين الهاتف (cfg.xml) عن طريق إدخال سلسلة بهذا التنسيق:
|
عنوان URL لخدمة تطبيق XML |
القيمة الافتراضية: فارغ |
عنوان URL الذي يوجد به تطبيق XML. كما يمكنك تكوين هذه المعلمة في ملف XML لتكوين الهاتف (cfg.xml) عن طريق إدخال سلسلة بهذا التنسيق:
يتم دعم متغيرات الماكرو في عناوين URL لـ XML. لمعرفة متغيرات الماكرو الصالحة، راجع متغيرات الماكرو المدعومة في عناوين URL XML. يتم دعم بروتوكولات HTTP أو HTTPs فقط في عنوان URL. |
اسم مستخدم XML |
القيمة الافتراضية: فارغ |
اسم مستخدم خدمة XML لأغراض المصادقة. كما يمكنك تكوين هذه المعلمة في ملف XML لتكوين الهاتف (cfg.xml) عن طريق إدخال سلسلة بهذا التنسيق:
|
كلمة مرور XML |
القيمة الافتراضية: فارغ |
كلمه مرور خدمة XML لاسم مستخدم XML المحدد. تظهر كلمة المرور التي أدخلتها في هذا الحقل في ملف التكوين (cfg.xml) كما يلي:
|
تمكين CISCO XML EXE |
القيمة الافتراضية: لا الخيارات: نعم، لا |
تحدد ما إذا كانت المصادقة مطلوبة للوصول إلى خادم تطبيق XML. كما يمكنك تكوين هذه المعلمة في ملف XML لتكوين الهاتف (cfg.xml) عن طريق إدخال سلسلة بهذا التنسيق:
|
وضع مصادقة CISCO XML EXE |
الإعداد الافتراضي: الاعتماد المحلي الخيارات: موثوق به ، بيانات اعتماد محلية ، بيانات اعتماد عن بعد |
تحديد وضع المصادقة لـ Cisco XML EXE.
كما يمكنك تكوين هذه المعلمة في ملف XML لتكوين الهاتف (cfg.xml) عن طريق إدخال سلسلة بهذا التنسيق:
|
إضافة تطبيق XML إلى مفتاح مرن
أضف التطبيقات المستخدمة بشكل متكرر إلى softkeys للمستخدمين للوصول إلى الخدمة بسهولة.
قبل البدء
تم تكوين "خدمة تطبيق XML" بشكل صحيح.
1 |
يمكنك الوصول إلى صفحة ويب إدارة الهاتف. |
2 |
حدد . |
3 |
في قسم المفاتيح الوظيفية القابلة للبرمجة، قم بتعيين تمكين المفاتيح الوظيفية القابلة للبرمجة إلى نعم. يمكنك أيضًا تكوين هذه المعلمة في ملف التكوين (cfg.xml). أدخل سلسلة بهذا التنسيق:
|
4 |
في قسم المفاتيح البرمجية القابلة للبرمجة، قم بتحرير الحقول المتوفرة من PSK1 إلى PSK16 بهذا التنسيق: fnc=xml;url=<xml_app_path>; نم = <app_name>
حيث
مثال يمكنك أيضًا تكوين هذه المعلمة في ملف التكوين (cfg.xml). أدخل سلسلة بهذا التنسيق:
حيث n هو رقم المفتاح المرن. |
5 |
انقر فوق حفظ كافة التغييرات. |
إضافة تطبيق XML إلى مفتاح خط
أضف التطبيقات المستخدمة بشكل متكرر إلى مفاتيح الخط للمستخدمين للوصول إلى الخدمات بسهولة.
قبل البدء
تم تكوين "خدمة تطبيق XML" بشكل صحيح.
1 |
يمكنك الوصول إلى صفحة ويب إدارة الهاتف. |
2 |
حدد . |
3 |
حدد مفتاح خط. |
4 |
قم بتعيين معلمة الامتداد على معطل لتعطيل الامتداد. في حالة تعطيل ميزة تكوين PLK المباشر، ينبغي عليك تعطيل الامتداد لإضافة وظيفة موسعة إلى مفتاح الخط. في حالة تمكين الميزة، يمكنك تخطي هذه الخطوة. لمعرفة التفاصيل، يرجى الاطلاع على تمكين تكوين Direct PLK. |
5 |
في معلمة الوظيفة الموسعة، أدخل سلسلة بهذا التنسيق: fnc=xml;url=<xml_app_path>; نم = <app_name>
حيث
مثال يمكنك أيضًا تكوين هذه المعلمة في ملف التكوين (cfg.xml). أدخل سلسلة بهذا التنسيق:
حيث يشير n إلى رقم الهاتف الداخلي. |
6 |
انقر فوق حفظ كافة التغييرات. |
متغيرات الماكرو المدعومة في عناوين URL XML
يمكنك استخدام متغيرات الماكرو في عناوين URL لـ XML. يتم دعم متغيرات الماكرو التالية:
-
معرف المستخدم — UID1، UID2 إلى UIDn
-
اسم العرض — DISPLAYNAME1، DISPLAYNAME2 إلى DISPLAYNAMEn
-
معرف المصادقة — AUTHID1، AUTHID2 إلى AUTHIDn
-
الوكيل — PROXY1، PROXY2 إلى PROXYn
-
عنوان MAC باستخدام أرقام سداسية عشرية صغيرة — MA
-
اسم المنتج — PN
-
رقم سلسلة المنتجات — PSN
-
الرقم المسلسل — SERIAL_NUMBER
اسم الماكرو | توسيع الماكرو |
---|---|
$ | يتم توسيع النموذج $$ إلى حرف $ واحد. |
A حتى P | تم استبدالها بمعلمات الأغراض العامة GPP_A من خلال GPP_P. |
SA حتى SD | تم استبدالها بمعلمات الأغراض الخاصة GPP_SA حتى GPP_SD. تحتوي هذه المعلمات على مفاتيح أو كلمات مرور مستخدمة في التوفير. يتم التعرف على $SA حتى $SD كوسيطات لمؤهل عنوان URL الاختياري لإعادة المزامنة، --key. |
MA | عنوان MAC باستخدام أرقام سداسية عشرية صغيرة (000e08aabbcc). |
MAU (وحدة الوصول إلى الوسائط) | عنوان MAC باستخدام أرقام سداسية عشرية كبيرة (000E08AABBCC). |
MAC | عنوان MAC يستخدم أرقامًا سداسية سداسية صغيرة مع نقطتين لفصل أزواج الأرقام السداسية (00:0e:08:aa:bb:cc). |
رقم المنتج | اسم المنتج؛ على سبيل المثال، هاتف فيديو 8875، هاتف مكتب 9851. |
PSN | رقم سلسلة المنتج ؛ على سبيل المثال، 8875 و9841 و9861 |
الرقم التسلسلي | سلسلة الرقم المسلسل؛ على سبيل المثال، 88012BA01234. |
CCERT | حاله شهادة عميل SSL، مثبتة أو غير مثبتة. |
عنوان IP | عنوان IP للهاتف داخل شبكته الفرعية المحلية؛ على سبيل المثال، 192.168.1.100. |
EXTIP | عنوان IP الخارجي للهاتف، كما يظهر على الإنترنت؛ على سبيل المثال، 66.43.16.52. |
SWVER |
سلسلة إصدار البرنامج. على سبيل المثال، فونيوس.3-2-1-0104-37 |
HWVER |
سلسلة إصدار الجهاز. على سبيل المثال، 2.0.1 |
PRVST |
حالة التوفير (سلسلة رقمية): -1 = طلب صريح لإعادة المزامنة 0 = إعادة مزامنة التشغيل 1 = إعادة المزامنة الدورية 2 = فشل إعادة المزامنة، أعد المحاولة |
UPGST |
حالة الترقية (سلسلة رقمية): 1 = أول محاولة ترقية 2 = فشلت الترقية، أعد المحاولة |
UPGERR |
رسالة النتيجة (ERR) لمحاولة الترقية السابقة؛ على سبيل المثال فشل http_get. |
PRVTMR |
عدد الثواني منذ آخر محاولة إعادة مزامنة. |
UPGTMR |
عدد الثواني منذ آخر محاولة ترقية. |
REGTMR1 |
عدد الثواني منذ فقد تسجيل الخط 1 في خادم SIP. |
REGTMR2 |
عدد الثواني منذ فقد تسجيل الخط 2 في خادم SIP. |
UPGCOND |
اسم الماكرو القديم. |
SCHEME |
مخطط الوصول إلى الملفات، أحد أنظمة TFTP أو HTTP أو HTTPS، كما تم الحصول عليه بعد تحليل عنوان URL لإعادة المزامنة أو الترقية. |
SERV |
اطلب اسم مضيف الخادم الهدف، كما تم الحصول عليه بعد تحليل عنوان URL لإعادة المزامنة أو الترقية. |
SERVIP |
طلب عنوان IP للخادم الهدف، كما تم الحصول عليه بعد تحليل عنوان URL لإعادة المزامنة أو الترقية، ربما بعد بحث DNS. |
المنفذ |
طلب منفذ UDP/TCP الهدف، كما تم الحصول عليه بعد تحليل عنوان URL لإعادة المزامنة أو الترقية. |
PATH |
طلب مسار الملف الهدف، كما تم الحصول عليه بعد تحليل عنوان URL لإعادة المزامنة أو الترقية. |
ERR |
رسالة نتيجة محاولة إعادة المزامنة أو الترقية. مفيد فقط في إنشاء رسائل سجل نظام النتائج. يتم الاحتفاظ بالقيمة في المتغير UPGERR في حالة محاولات الترقية. |
UIDn |
محتويات معلمة تكوين Line n UserID. |
ISCUST |
إذا تم تخصيص الوحدة، القيمة = 1، وإلا 0. يمكن عرض حالة التخصيص على صفحة معلومات واجهة مستخدم الويب. |
INCOMINGNAME | الاسم المرتبط بأول مكالمة متصلة أو رنين أو واردة. |
REMOTENUMBER |
رقم هاتف أول مكالمة متصلة أو رنين أو واردة. في حالة وجود مكالمات متعددة، يتم توفير البيانات المرتبطة بالمكالمة الأولى التي تم العثور عليها. |
DISPLAYNAMEn | محتويات معلمة تكوين اسم عرض الخط N. |
AUTHIDn | محتويات معلمة تكوين معرف مصادقة الخط N. |