نظرة عامة

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

بعد اشتراك الهاتف في الخدمات، يمكن للمستخدمين الوصول إلى جميع الخدمات التي تمت تهيئتها على الهاتف من خلال الانتقال إلى الإعدادات > الشبكة والخدمة > خدمات Cisco XML. خدمات 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 لتكوين معلمة.

الجدول 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">username</XML_User_Name>

كلمة مرور XML

القيمة الافتراضية: فارغ

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

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

<!-- <XML_Password ua="na">*************</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 إلى مفتاح مرن

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

‏‫قبل البدء‬

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

1

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

2

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

3

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

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

<Programmable_Softkey_Enable ua="na">نعم</Programmable_Softkey_Enable>
4

في قسم المفاتيح البرمجية القابلة للبرمجة، قم بتحرير الحقول المتوفرة من PSK1 إلى PSK16 بهذا التنسيق:

fnc=xml;url=<xml_app_path>; نم = <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>

حيث n هو رقم المفتاح المرن.

5

انقر فوق حفظ كافة التغييرات.

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

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

‏‫قبل البدء‬

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

1

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

2

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

3

حدد مفتاح خط.

4

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

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

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

fnc=xml;url=<xml_app_path>; نم = <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_>

حيث يشير 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.
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.