تكوين تطبيقات XML للهواتف 9800 و8875 (برودووركس)

نظرة عامة

واجهة خدمات XML (XSI) هي بروتوكول يسمح بالاتصال بين التطبيقات ونظام الهاتف. يمكنك إضافة خدمات XSI الخاصة بك إلى هاتفك باستخدام كائنات XML وعناوين URI المدعومة.

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

الميزات المدعومة هي:

الرسائل (الصور والنصوص)
تصفح

كائنات XML المدعومة

قائمة هاتف Cisco
نص هاتف Cisco
إدخال هاتف Cisco عبر بروتوكول الإنترنت
دليل هواتف IP من Cisco
صورة هاتف سيسكو
ملف صورة هاتف Cisco IP
قائمة أيقونة هاتف Cisco
قائمة ملفات أيقونة هاتف Cisco
حالة هاتف Cisco IP (باستثناء 9811 و9841)
ملف حالة هاتف Cisco IP (باستثناء 9811 و9841)
تنفيذ هاتف Cisco

عناوين URL المدعومة

جهاز
الاتصال الهاتفي
تحرير البريد
البداية
مفتاح
التشغيل (نغمات الرنين فقط)
سوفت كي

لمزيد من التفاصيل حول تكوين خدمة XSI، راجع ملاحظات تطوير تطبيق خدمات هاتف IP الموحدة من Cisco.

تكوين هاتف للاتصال بخدمة XML

1	قم بالوصول إلى صفحة الويب الخاصة بإدارة الهاتف.
2	حدد الصوت > الهاتف.
3	في قسم خدمة XML، قم بتكوين اسم خدمة تطبيق XML ومعلمات URL لخدمة تطبيق XML كما هو محدد في المعلمات لخدمات XML.
4	(اختياري) لإضافة مصادقة للوصول إلى خدمة التطبيق، قم بتكوين هذه الحقول: اسم مستخدم XML وكلمة مرور XML وتمكين CISCO XML EXE ووضع مصادقة CISCO XML EXE.
5	انقر فوق حفظ جميع التغييرات.

المعلمات لخدمات XML

يحدد الجدول التالي وظيفة واستخدام معلمات تطبيق XML في قسم خدمة XML ضمن علامة تبويب الصوت > الهاتف في واجهة الويب الخاصة بالهاتف. كما تحدد أيضًا صيغة السلسلة التي تمت إضافتها في ملف تكوين الهاتف (cfg.xml) مع كود XML لتكوين المعلمة.

الجدول 1. المعلمات لخدمات XML
المعلمة	الإعداد الافتراضي والخيارات	وصف
اسم خدمة تطبيق XML	الإعداد الافتراضي: فارغ	اسم تطبيق XML. يتم عرض الاسم على الهاتف كخيار تطبيق ويب. يمكنك أيضًا تكوين هذه المعلمة في ملف XML لتكوين الهاتف (cfg.xml) عن طريق إدخال سلسلة بهذا التنسيق: `<XML_Application_Service_Name ua="na">XML APP Name</XML_Application_Service_Name>`
عنوان URL لخدمة تطبيق XML	الإعداد الافتراضي: فارغ	عنوان URL حيث يوجد تطبيق XML. يمكنك أيضًا تكوين هذه المعلمة في ملف XML لتكوين الهاتف (cfg.xml) عن طريق إدخال سلسلة بهذا التنسيق: `<XML_Application_Service_URL ua="na">https://server.com/path/app.xml</XML_Application_Service_URL>` يتم دعم متغيرات الماكرو في عناوين URL الخاصة بـ XML. بالنسبة لمتغيرات الماكرو الصالحة، راجع متغيرات الماكرو المدعومة في عناوين URL الخاصة بـ XML. يتم دعم بروتوكولات HTTP أو HTTPs فقط في عنوان URL.
اسم مستخدم XML	الإعداد الافتراضي: فارغ	اسم مستخدم خدمة XML لأغراض المصادقة. يمكنك أيضًا تكوين هذه المعلمة في ملف XML لتكوين الهاتف (cfg.xml) عن طريق إدخال سلسلة بهذا التنسيق: `<XML_User_Name ua="na">username</XML_User_Name>`
كلمة مرور XML	الإعداد الافتراضي: فارغ	كلمة مرور خدمة XML لاسم مستخدم XML المحدد. تظهر كلمة المرور التي أدخلتها في هذا الحقل في ملف التكوين (cfg.xml) كما يلي: `<!-- <XML_Password ua="na">*************</XML_Password> -->`
تمكين برنامج سيسكو إكس إم إل إكس	الإعداد الافتراضي: لا الخيارات: نعم، لا	يحدد ما إذا كانت المصادقة مطلوبة للوصول إلى خادم تطبيق XML. يمكنك أيضًا تكوين هذه المعلمة في ملف XML لتكوين الهاتف (cfg.xml) عن طريق إدخال سلسلة بهذا التنسيق: `<CISCO_XML_EXE_Enable ua="na">Yes</CISCO_XML_EXE_Enable>`
وضع مصادقة CISCO XML EXE	الإعداد الافتراضي: بيانات الاعتماد المحلية الخيارات: بيانات اعتماد موثوقة ومحلية وبيانات اعتماد عن بُعد	يحدد وضع المصادقة لـ Cisco XML EXE. موثوق به - لا يتم إجراء أي مصادقة بغض النظر عن بيانات الاعتماد المحلية. بيانات الاعتماد المحلية - تعتمد المصادقة على مصادقة الملخص باستخدام بيانات الاعتماد المحلية، إذا تم تعيينها. إذا لم يتم تعيين بيانات الاعتماد المحلية، فلن يتم إجراء أي مصادقة. بيانات الاعتماد البعيدة - تعتمد المصادقة على مصادقة الملخص باستخدام بيانات الاعتماد البعيدة كما تم تعيينها في تطبيق XML على صفحة الويب (للوصول إلى خادم تطبيق XML). يمكنك أيضًا تكوين هذه المعلمة في ملف XML لتكوين الهاتف (cfg.xml) عن طريق إدخال سلسلة بهذا التنسيق: `<CISCO_XML_EXE_Auth_Mode ua="na">Local Credential</CISCO_XML_EXE_Auth_Mode>`

إضافة تطبيق XML إلى مفتاح برمجي

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

قبل أن تبدأ

تم تكوين خدمة تطبيق XML بشكل صحيح.

1	قم بالوصول إلى صفحة الويب الخاصة بإدارة الهاتف.
2	حدد الصوت > الهاتف.
3	في قسم المفاتيح المرنة القابلة للبرمجة، قم بتعيين تمكين المفتاح المرن القابل للبرمجة إلى نعم. يمكنك أيضًا تكوين هذه المعلمة في ملف التكوين (cfg.xml). أدخل سلسلة بهذا التنسيق: `<Programmable_Softkey_Enable ua="na">Yes</Programmable_Softkey_Enable>`
4	في قسم المفاتيح المرنة القابلة للبرمجة، قم بتحرير الحقول المتاحة من PSK1 إلى PSK16 بهذا التنسيق: `fnc=xml;url=<xml_app_path>;nme=<app_name>` حيث `url` هو الرابط الذي يتم تخزين تطبيق XML `فيه؛ nme` هو اسم العرض للتطبيق على شاشة الهاتف. *مثال* `fnc=xml`؛ عنوان url= http://10.77.21.37/xmlapp/menu.xml;nme=Menu يمكنك أيضًا تكوين هذه المعلمة في ملف التكوين (cfg.xml). أدخل سلسلة بهذا التنسيق: `<PSK_n ua="na">fnc=xml؛ عنوان url= http://10.77.21.37/xmlapp/menu.xml;nme=Menu</PSK_n>` <configuration code> حيث n هو رقم المفتاح المرن.
5	انقر فوق حفظ جميع التغييرات.

إضافة تطبيق XML إلى مفتاح سطر

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

قبل أن تبدأ

تم تكوين خدمة تطبيق XML بشكل صحيح.

1	قم بالوصول إلى صفحة الويب الخاصة بإدارة الهاتف.
2	حدد الصوت > الهاتف.
3	حدد مفتاح الخط.
4	قم بتعيين معلمة الإضافة إلى معطل لتعطيل الإضافة. إذا تم تعطيل ميزة Direct PLK Configuration، يجب عليك تعطيل الإضافة لإضافة وظيفة موسعة إلى مفتاح الخط. في حالة تمكين الميزة، يمكنك تخطي هذه الخطوة. لمزيد من التفاصيل، راجع تمكين تكوين Direct PLK.
5	في المعلمة Extended Function، أدخل سلسلة بهذا التنسيق: `fnc=xml;url=<xml_app_path>;nme=<app_name>` حيث `url` هو الرابط الذي يتم تخزين تطبيق XML `فيه؛ nme` هو اسم العرض للتطبيق على شاشة الهاتف. *مثال* `fnc=xml`؛ عنوان url= http://10.77.21.37/xmlapp/menu.xml;nme=Menu يمكنك أيضًا تكوين هذه المعلمة في ملف التكوين (cfg.xml). أدخل سلسلة بهذا التنسيق: `<Extended_Function_n_ ua="na">fnc=xml؛ عنوان url= http://10.77.21.37/xmlapp/menu.xml;nme=Menu</Extended_Function_n_>` <configuration code> حيث n هو رقم الإضافة.
6	انقر فوق حفظ جميع التغييرات.

متغيرات الماكرو المدعومة في عناوين URL الخاصة بـ XML

يمكنك استخدام متغيرات الماكرو في عناوين URL الخاصة بـ XML. يتم دعم متغيرات الماكرو التالية:

معرف المستخدم - UID1، UID2 إلى UIDN
اسم العرض - اسم العرض 1، اسم العرض 2 إلى اسم العرض الرجال
معرف المصادقة - AUTHID1، AUTHID2 إلى AuthID2
بروكسي - بروكسي 1، بروكسي 2 إلى بروكسين
عنوان MAC باستخدام الأرقام السداسية الصغيرة — MA
اسم المنتج — PN
رقم سلسلة المنتج - PSN
الرقم التسلسلي - الرقم التسلسلي

الجدول 2. وحدات الماكرو المدعومة
اسم الماكرو	التوسع الكلي
$	يتم توسيع النموذج $$ إلى حرف $ واحد.
من A إلى P	تم استبدالها بمعلمات الأغراض العامة GPP_A من خلال GPP_P.
من الولايات المتحدة إلى SD	تم استبدالها بمعلمات الأغراض الخاصة GPP_SA من خلال GPP_SD. تحتوي هذه المعلمات على المفاتيح أو كلمات المرور المستخدمة في التزويد. يتم التعرف على $SA إلى $SD كوسيطات لمؤهل عنوان URL الاختياري لإعادة المزامنة، --key.
MA	عنوان MAC باستخدام أرقام سداسية صغيرة (000e08aabbcc).
MAU	عنوان MAC باستخدام الأرقام السداسية العشرية الكبيرة (000E08AABBCC).
MAC	عنوان MAC يستخدم الأرقام السداسية الصغيرة مع النقطتين لفصل أزواج الأرقام السداسية العشرية (00:0:08:a:bb:cc).
PN	اسم المنتج؛ على سبيل المثال، هاتف الفيديو 8875، هاتف المكتب 9851.
PSN	رقم سلسلة المنتج؛ على سبيل المثال، 8875، 9841، 9861
SN	سلسلة الرقم التسلسلي؛ على سبيل المثال، 88012BA01234.
CCERT	حالة شهادة عميل SSL، مثبتة أو غير مثبتة.
IP	عنوان IP الخاص بالهاتف داخل شبكته الفرعية المحلية؛ على سبيل المثال، 192.168.1.100.
EXTIP	عنوان IP الخارجي للهاتف، كما يظهر على الإنترنت؛ على سبيل المثال، 66.43.16.52.
SWVER	سلسلة إصدار البرنامج. على سبيل المثال، PHONEOS.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.
PORT	اطلب منفذ UDP/TCP المستهدف، كما تم الحصول عليه بعد تحليل عنوان URL لإعادة المزامنة أو ترقيته.
PATH	اطلب مسار الملف الهدف، كما تم الحصول عليه بعد تحليل عنوان URL لإعادة المزامنة أو ترقيته.
ERR	رسالة نتيجة إعادة المزامنة أو محاولة الترقية. مفيد فقط في إنشاء رسائل سجل النظام الناتجة. يتم الاحتفاظ بالقيمة في متغير UPGERR في حالة محاولات الترقية.
UIDN	محتويات معلمة تكوين السطر n userID.
ISCUST	إذا تم تخصيص الوحدة، القيمة = 1، وإلا 0. يمكن عرض حالة التخصيص على صفحة معلومات واجهة مستخدم الويب.
INCOMINGNAME	الاسم المقترن بأول مكالمة متصلة أو رنانة أو واردة.
REMOTENUMBER	رقم هاتف أول مكالمة متصلة أو رنانة أو واردة. في حالة وجود مكالمات متعددة، يتم توفير البيانات المرتبطة بالمكالمة الأولى التي تم العثور عليها.
اسم العرض: رجال	محتويات معلمة تكوين اسم عرض الخط N.
معرف المؤلف	محتويات معلمة تكوين معرف مصادقة السطر N.

Cisco AI Assistant

شكرًا على ملاحظاتك.

تكوين تطبيقات XML للهواتف 9800 و8875 (برودووركس)

نظرة عامة

كائنات XML المدعومة

عناوين URL المدعومة

تكوين هاتف للاتصال بخدمة XML

المعلمات لخدمات XML

إضافة تطبيق XML إلى مفتاح برمجي

إضافة تطبيق XML إلى مفتاح سطر

متغيرات الماكرو المدعومة في عناوين URL الخاصة بـ XML

الشركات صغيرة الحجم

المؤسسة

الأجهزة

حلول لـ

الموارد

الشركة