نظرة عامة

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

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

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

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

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

  • قائمة هاتف CiscoIP

  • نص هاتف CiscoIP

  • إدخال هاتف CiscoIP

  • دليل Cisco IP

  • صورة هاتف CiscoIP

  • ملف صورة Cisco IP

  • قائمة أيقونات Cisco IP

  • قائمة ملفاتCisco IP

  • حالة Cisco IP (باستثناء 9841)

  • ملف CiscoIP honeStatusFile (باستثناء 9841)

  • CiscoIP PhoneExecute

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

  • الجهاز

  • اتصال

  • تحرير دايل

  • تهيئة

  • المفتاح

  • تشغيل (نغمات الرنين فقط)

  • المفتاح المرن

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

تكوين هاتف للاتصال بخدمة 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</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">اسم المستخدم</XML_User_Name>

كلمة مرور XML

الإعداد الافتراضي: فارغ

كلمة مرور خدمة XML لاسم مستخدم XML المحدد.

تظهر كلمة المرور التي أدخلتها في هذا الحقل في ملف التكوين (cfg.xml) على النحو التالي:

<!-- <XML_Password ua="na">lt;/XML_Password> -->

تمكين CISCO XML EXE

الإعداد الافتراضي: لا

الخيارات: نعم، لا

تحديد ما إذا كانت المصادقة مطلوبة للوصول إلى خادم تطبيق XML.

يمكنك أيضًا تكوين هذه المعلمة في ملف XML لتكوين الهاتف (cfg.xml) عن طريق إدخال سلسلة بهذا التنسيق:

<CISCO_XML_EXE_Enable ua="na">نعم</CISCO_XML_EXE_Enable>

وضع مصادقة CISCO XML EXE

الإعداد الافتراضي: بيانات الاعتماد المحلية

الخيارات: موثوق، بيانات الاعتماد المحلية، بيانات الاعتماد عن بُعد

تحديد وضع المصادقة لـ Cisco XML EXE.

  • موثوق به - لا يتم تنفيذ أي مصادقة بغض النظر عن بيانات الاعتماد المحلية.

  • الاعتماد المحلي - تعتمد المصادقة على المصادقة الكلية باستخدام بيانات الاعتماد المحلية، إذا تم تعيينها. إذا لم يتم تعيين بيانات الاعتماد المحلية، فلن يتم إجراء مصادقة.

  • الاعتماد عن بعد - تعتمد المصادقة على المصادقة الكلية باستخدام بيانات الاعتماد عن بُعد كما تم تعيينها في تطبيق XML على صفحة الويب (للوصول إلى خادم تطبيق XML).

يمكنك أيضًا تكوين هذه المعلمة في ملف XML لتكوين الهاتف (cfg.xml) عن طريق إدخال سلسلة بهذا التنسيق:

<CISCO_XML_EXE_Auth_Mode ua="na">الاعتماد المحلي</CISCO_XML_EXE_Auth_Mode>

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

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

قبل البدء

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

1

يمكنك الوصول إلى صفحة ويب إدارة الهاتف.

2

حدد الصوت > الهاتف.

3

في قسم المفاتيح الوظيفية القابلة للبرمجة، قم بتعيين تمكين المفتاح الوظيفي القابل للبرمجة على نعم.

يمكنك أيضًا تكوين هذه المعلمة في ملف التكوين (cfg.xml). أدخل سلسلة بهذا التنسيق:

<Programmable_Softkey_Enable ua="na">نعم</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=قائمة<رمز التكوين></PSK_n>

حيث يشير n إلى رقم المفتاح المرن.

5

انقر على حفظ كل التغييرات.

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

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

قبل البدء

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

1

يمكنك الوصول إلى صفحة ويب إدارة الهاتف.

2

حدد الصوت > الهاتف.

3

حدد مفتاح خط.

4

قم بتعيين معلمة الرقم الداخلي إلى معطل لتعطيل الرقم الداخلي.

إذا تم تعطيل ميزة تكوين PLK المباشر، فيجب عليك تعطيل الرقم الداخلي لإضافة وظيفة موسعة إلى مفتاح الخط. إذا تم تمكين الميزة، فيمكنك تخطي هذه الخطوة. لمعرفة التفاصيل، ارجع إلى تمكين تكوين PLK المباشر.
5

في معلمة الوظيفة الموسعة، أدخل سلسلة بهذا التنسيق:

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=قائمة<configuration code></Extended_Function_n_>

حيث يشير n إلى رقم الهاتف الداخلي.

6

انقر على حفظ كل التغييرات.

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

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

  • معرف المستخدم — UID1، UID2 إلى UIDn

  • اسم العرض — DISPLAYNAME1، DISPLAYNAME2 إلى DISPLAYNAMEn

  • معرف المصادقة — AUTHID1،‏ AUTHID2 إلى AUTHIDn

  • الوكيل — PROXY1، PROXY2 إلى PROXYn

  • عنوان MAC باستخدام أرقام سداسية عشرية صغيرة — MA

  • اسم المنتج — PN

  • رقم سلسلة المنتجات — PSN

  • الرقم التسلسلي — SERIAL_NUMBER

الجدول رقم 2. وحدات الماكرو المدعومة
اسم الماكروتوسيع الماكرو
$يتم توسيع النموذج $$ إلى حرف $ واحد.
A إلى Pتم استبدالها بمعلمات الأغراض العامة GPP_A من خلال GPP_P.
SA إلى SDتم استبدالها بمعلمات الأغراض الخاصة GPP_SA من خلال GPP_SD. تحتوي هذه المعلمات على مفاتيح أو كلمات مرور مستخدمة في التوفير.
يتم التعرف على $SA حتى $SD كوسيطات لمؤهل عنوان URL الاختياري لإعادة المزامنة، --key.
لكنعنوان MAC باستخدام أرقام سداسية عشرية صغيرة (000e08aabbcc).
MAUعنوان MAC باستخدام أرقام سداسية عشرية كبيرة (000E08AABBCC).
ماكعنوان MAC يستخدم أرقامًا سداسية سداسية صغيرة مع نقطتين لفصل أزواج الأرقام السداسية (00:0e:08:aa:bb:cc).
ين (توضيح)اسم المنتج؛ على سبيل المثال، هاتف الفيديو 8875، هاتف المكتب 9851.
شبكة الهاتف العامةرقم سلسلة المنتجات؛ على سبيل المثال، 8875 و9841 و9861
رقم الهاتفسلسلة الرقم التسلسلي؛ على سبيل المثال، 88012BA01234.
شهادةحالة شهادة عميل SSL، مثبتة أو غير مثبتة.
IPعنوان IP للهاتف داخل شبكته الفرعية المحلية؛ على سبيل المثال، 192.168.1.100.
تلميح خارجيعنوان IP الخارجي للهاتف، كما يظهر على الإنترنت؛ على سبيل المثال، 66.43.16.52.

تبديل

سلسلة إصدار البرنامج. على سبيل المثال،

هاتف ‎3-2-1-0104-37

تردد

سلسلة إصدار الجهاز. على سبيل المثال، 2.0.1

برست

حالة التوفير (سلسلة رقمية):

-1 = طلب صريح لإعادة المزامنة

0 = إعادة مزامنة التشغيل

1 = إعادة المزامنة الدورية

2 = فشل إعادة المزامنة، أعد المحاولة

ترقية

حالة الترقية (سلسلة رقمية):

1 = أول محاولة ترقية

2 = فشلت الترقية، أعد المحاولة

نشوة

رسالة النتيجة (ERR) لمحاولة الترقية السابقة؛ على سبيل المثال فشل http_get.

prvtmr

عدد الثواني منذ آخر محاولة لإعادة المزامنة.

upgtmr

عدد الثواني منذ آخر محاولة ترقية.

regtmr1

عدد الثواني منذ فقد تسجيل الخط 1 في خادم SIP.

regtmr2

عدد الثواني منذ فقد تسجيل الخط 2 في خادم SIP.

أوبغكوند

اسم الماكرو القديم.

مخطط

مخطط الوصول إلى الملفات، أحد أنظمة TFTP أو HTTP أو HTTPS، كما تم الحصول عليه بعد تحليل عنوان URL لإعادة المزامنة أو الترقية.

خدمة

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

خادمة

طلب عنوان IP للخادم الهدف، كما تم الحصول عليه بعد تحليل عنوان URL لإعادة المزامنة أو الترقية، ربما بعد بحث DNS.

المنفذ

طلب منفذ UDP/TCP الهدف، كما تم الحصول عليه بعد تحليل عنوان URL لإعادة المزامنة أو الترقية.

المسار

طلب مسار الملف الهدف، كما تم الحصول عليه بعد تحليل عنوان URL لإعادة المزامنة أو الترقية.

خطأ

رسالة نتيجة محاولة إعادة المزامنة أو الترقية. مفيد فقط في إنشاء رسائل سجل نظام النتائج. يتم الاحتفاظ بالقيمة في متغير UPGERR في حالة محاولات الترقية.

معرف المستخدم

محتويات معلمة تكوين Line n UserID.

إسكوست

إذا تم تخصيص الوحدة، القيمة=1، وإلا 0.

يمكن عرض حالة التخصيص على صفحة معلومات واجهة مستخدم الويب.

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

رقم هاتف أول مكالمة متصلة أو رنين أو واردة. في حالة وجود مكالمات متعددة، يتم توفير البيانات المرتبطة بالمكالمة الأولى التي تم العثور عليها.

اسم العرضمحتويات معلمة تكوين اسم عرض الخط N.
هوية المصادقةمحتويات معلمة تكوين معرف مصادقة الخط N.