Общ преглед

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

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

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

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

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

  • CiscoIPPhoneMenu

  • CiscoIPPhoneText

  • CiscoIPPhoneInput

  • CiscoIPPhoneDirectory

  • CiscoIPPhoneImage

  • CiscoIPPhoneImageFile

  • CiscoIPPhoneIconMenu

  • CiscoIPPhoneIconFileMenu

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

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

  • CiscoIPPhoneExecute

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

  • Устройство

  • Набиране

  • EditDail

  • Първоначален

  • Ключ

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

  • Функционален бутон

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

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

1

Преминете към уеб страницата за администриране на телефона.

2

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

3

В секцията XML услуга конфигурирайте името на XML приложната услуга и URL адресите на XML приложната услуга, както е дефинирано в Параметри за XML услуги.

4

(По избор) За да добавите удостоверяване за достъп до приложната услуга, конфигурирайте тези полета: XML потребителско име, XML парола, CISCO XML EXE Enable и CISCO XML EXE Auth Mode.

5

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

Параметри за XML услуги

Таблицата по-долу определя функцията и използването на параметрите на приложението XML в раздела XML Услуга в раздела Глас > телефон в уеб интерфейса на телефона. Освен това дефинира синтаксиса на низа, който се добавя в конфигурационния файл на телефона (cfg.xml) с XML код за конфигуриране на параметър.

Таблица 1. Параметри за XML услуги

Parameter

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

Описание

Име на 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 или HTTP протоколи.

Потребителско име за 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">Local Credential</CISCO_XML_EXE_Auth_Mode>

Добавяне на XML приложение към функционален бутон

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

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

XML Application Service е правилно конфигуриран.

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=Menu<configuration code></PSK_n>

където n е числото на софтуерния клавиш.

5

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

Добавяне на XML приложение към клавиш на ред

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

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

XML Application Service е правилно конфигуриран.

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=Menu<configuration code></Extended_Function_n_>

където n е числото на вътрешния номер.

6

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

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

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

  • Потребителски идентификатор – UID1, UID2 към UIDn

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

  • Удостоверяване на ИД – AUTHID1, AUTHID2 към AUTHIDn

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

  • MAC адрес с малки шестнадесетични цифри – MA

  • Име на продукта—PN

  • Номер на серията на продукта – PSN

  • Сериен номер – SERIAL_NUMBER

Таблица 2. Поддържани макроси
Име на макросМакро разширяване
$Формулярът $$ се разширява до един знак $.
A до PЗаменени с параметри с общо предназначение GPP_A през GPP_P.
SA до SDЗаменя се от параметрите за специална цел GPP_SA до GPP_SD. Тези параметри носят ключове или пароли, използвани в обезпечаването.
$SA до $SD се разпознават като аргументи на предлагания като опция URL квалификатор за повторно синхронизиране, --ключ.
MAMAC адрес, като използвате малки шестнадесетични цифри (000e08aabbcc).
MAUMAC адрес с помощта на главни шестнадесетични цифри (000E08AABBCC).
MACMAC адрес, като използвате малки шестнадесетични цифри с двоеточие за разделяне на двойки шестнадесетични цифри (00:0e:08:aa:bb:cc).
PNИме на продукта; например видеотелефон 8875, настолен телефон 9851.
PSNномер на серията на продукта; например 8875, 9841, 9861
SNНиз на сериен номер; например 88012BA01234.
CCERTСъстояние на SSL клиентски сертификат, инсталиран или неинсталиран.
IPIP адреса на телефона в неговата локална подмрежа; например 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

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

REGTMR2

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

UPGCOND

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

SCHEME

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

SERV

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

SERVIP

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

PORT

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

PATH

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

ERR

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

UIDn

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

ISCUST

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

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

ВХОДЯЩО ИМЕИме, свързано с първо свързано, звънещо или входящо повикване.
ОТДАЛЕЧЕН НОМЕР

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

ПОКАЗВАНО ИМЕnСъдържанието на конфигурационния параметър Line N Display Name.
AUTHIDnСъдържанието на конфигурационния параметър Line N auth ID.