Общ преглед

Интерфейсът на XML Services Interface (XSI) е протокол, който позволява комуникация между приложенията и телефонната система. Можете да добавите собствени XSI услуги към телефона си с помощта на поддържаните XML обекти и URIs.

След като се абонират за телефона за услугите, потребителите могат да получат достъп до всички конфигурирани услуги на телефона, като се придвижат до Настройки > Мрежа и услуги > Cisco XML услуги. XML услугите на Cisco са името по подразбиране. Можете също да промените името. За да осигурите лесен достъп за потребителите, можете да добавите XML приложенията към софтуерни или бутони за линия.

Поддържаните функции са:

  • Съобщения (изображения и текст)
  • Пейджинг

Поддържани XML обекти

  • Меню на CiscoIPPhone

  • CiscoIPPhoneText

  • Вход за CiscoIPPhone

  • CiscoIPPhoneDirectory

  • Изображение на CiscoIPPhone

  • CiscoIPhoneImageFile

  • CiscoIPPhoneIconMenu

  • Меню на CiscoIPPhoneIconFileMenu

  • CiscoIPPhoneStatus (с изключение на 9841)

  • CiscoIPPhoneStatusFile (с изключение на 9841)

  • CiscoIPPhoneExecute

Поддържани URI адреси

  • Устройство

  • Набиране

  • EditDail

  • Инит

  • Ключ

  • Възпроизвеждане (само за мелодии)

  • Софтуерен бутон

За повече подробности относно конфигурацията на XSI услугата вижте Бележки за разработката на приложения на Cisco Unified IP Phone Services.

Конфигуриране на телефон за свързване към XML услуга

1

Отворете уеб страницата за администриране на телефона.

2

Изберете Глас > Телефон.

3

В раздела XML услуга конфигурирайте параметрите на XML Application Service Name и URL адреса на XML Application Service, както са дефинирани в Параметри за 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>

Променливите на макросите се поддържат в XML URL адресите. За валидните макро променливи вижте Макро променливи, поддържани в XML URL адреси.

В URL адреса се поддържат само HTTP или HTTPs протоколи.

Потребителско име в XML

По подразбиране: Празно

Потребителско име на XML услугата за целите на удостоверяване.

Можете също да конфигурирате този параметър в XML файла за конфигуриране на телефона (cfg.xml), като въведете низ в следния формат:

<XML_User_Name ua="na">потребителско име</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 приложение към софтуерен бутон

Добавете често използваните приложения към софтуерните бутони, за да могат потребителите лесно да получат достъп до услугата.

Преди да започнете

Услугата за 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=Меню

Можете също да конфигурирате този параметър в конфигурационния файл (cfg.xml). Въведете низ в следния формат:

<PSK_n ua="na">fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Меню<configuration code></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=Меню

Можете също да конфигурирате този параметър в конфигурационния файл (cfg.xml). Въведете низ в следния формат:

<Extended_Function_n_ ua="na">fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu<configuration code></Extended_Function_n_>

където n е вътрешният номер.

6

Щракнете върху Запиши всички промени.

Променливи на макросите, поддържани в XML URL адресите

Можете да използвате макро променливи в XML URL. Поддържат се следните макро променливи:

  • ИД на потребител – UID1, UID2 на UIDn

  • Показвано име—DISPLAYNAME1, DISPLAYNAME2 до DISPLAYNAMEn

  • ИД на удостоверяване – AUTHID1, AUTHID2 на AUTHIDn

  • Прокси сървър – ПРОКСИ1, ПРОКСИ2 към ПРОКСИn

  • 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).
MAUMAC адрес при използване на главни шестнадесетични цифри (000E08AABBCC).
macMAC адрес при използване на малки шестнадесетични цифри с двоеточие за разделяне на сдвоените шестнадесетични цифри (00:0e:08:aa:bb:cc).
pnИме на продукта; например Video Phone 8875, Desk Phone 9851.
psnНомер на серия продукти; например 8875, 9841, 9861
шшштНиз на серийния номер; например 88012BA01234.
CcertСъстояние на сертификата на SSL клиент, инсталиран или неинсталиран.
IPIP адрес на телефона в неговата локална подмрежа; например 192.168.1.100.
пояснениеВъншен IP на телефона, както се вижда в интернет; например 66.43.16.52.

swver

Низ на софтуерната версия. Например,

phoneos.3-2-1-0104-37

превъплъщение

Низ на хардуерната версия. Например 2.0.1

првст

Състояние на обезпечаване (цифров низ):

-1 = изрична заявка за повторно синхронизиране

0 = повторно синхронизиране при включване на захранването

1 = периодично повторно синхронизиране

2 = неуспешно повторно синхронизиране, повторен опит

upgst

Състояние на надграждане (цифров низ):

1 = първи опит за надграждане

2 = неуспешно надстройване, повторен опит

upgerr

Съобщение с резултат (ERR) от предишен опит за надграждане; например неуспешен http_get.

првтмр

Секунди след последния опит за повторно синхронизиране.

upgtmr

Секунди след последния опит за надграждане.

regtmr1

Секунди след загуба на регистрацията на SIP сървъра на линия 1.

regtmr2

Секунди след загуба на регистрацията на SIP сървъра на линия 2.

upgcond

Старо име на макрос.

схема

Схема за достъп до файлове, един от TFTP, HTTP или HTTPS, както е получен след повторно синхронизиране за синтактичен анализ или надграждане на URL.

серв

Изискайте името на хоста на целевия сървър, както е получен след повторното синхронизиране за синтактичен анализ или надграждането на URL.

сервиране

Изискайте IP адреса на целевия сървър, както е получен след повторното синхронизиране за синтактичен анализ или надграждането на URL, като следвате търсенето на DNS.

порт

Изискайте целевия UDP/TCP порт, както е получен след повторното синхронизиране за синтактичен анализ или надграждането на URL.

път

Изискайте пътя на целевия файл, както е получен след повторното синхронизиране за синтактичен анализ или надграждането на URL.

грешка

Съобщение за резултата от повторно синхронизиране или опит за надграждане. Полезно е само при генериране на съобщения с резултат от syslog. Стойността се запазва в променливата UPGERR в случай на опити за надграждане.

UID

Съдържанието на параметъра за конфигуриране на Line n UserID.

Iscust

Ако единицата е персонализирана, стойност=1, в противен случай 0.

Статусът на персонализиране се вижда на уеб страницата с информация за потребителския интерфейс.

входящиNameИме, свързано с първото свързано, позвъняване или входящо повикване.
отдалечен umber

Телефонен номер на първото свързано, позвъняване или входящо повикване. Ако има много повиквания, се предоставят данните, свързани с първото открито повикване.

DisplayNameСъдържанието на параметъра за конфигуриране на името на дисплея за линия N.
AUTHIDСъдържанието на параметъра за конфигуриране на ИД за удостоверяване на линия N.