Обзор

XML Services Interface (XSI) — это протокол, который позволяет обмениваться данными между приложениями и телефонной системой. Вы можете добавить собственные службы XSI на телефон, используя поддерживаемые объекты XML и URI.

После подписки телефона на службы пользователи могут получить доступ ко всем настроенным службам на телефоне, перейдя в раздел Настройки > Сеть и служба > Службы XML Cisco. XML-службы Cisco являются именем по умолчанию. Имя также можно изменить. Для обеспечения простого доступа пользователей можно добавить приложения XML к программным клавишам или клавишам линий.

Поддерживаемые функции:

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

Поддерживаемые объекты XML

  • Меню Cisco IP

  • Телефон Cisco IPPhoneText

  • Ввод телефона CiscoIP

  • Каталог CiscoIPhoneDirectory

  • Изображение телефона Cisco IP

  • CiscoIPPhoneImageFile

  • CiscoIPPhoneIconMenu

  • CiscoIPPhoneIconFileMenu

  • Состояние телефона Cisco IP (кроме 9841)

  • CiscoIPPhoneStatusFile (кроме 9841)

  • Телефон Cisco IPPhoneExecute

Поддерживаемые URI

  • Устройство

  • Набор

  • Редактировать номер

  • Инит

  • Ключ

  • Воспроизвести (только сигналы звонка)

  • Экранная клавиша

Дополнительные сведения о конфигурации службы XSI см. в статье Примечания к разработке приложения для служб телефонии Cisco Unified IP.

Настройка телефона для подключения к XML-службе

1.

Откройте веб-страницу администрирования телефона.

2.

Выберите Голос > Телефон.

3.

В разделе Служба XML настройте параметры Имя службы приложений XML и URL службы приложений XML, как определено в разделе Параметры для XML-служб.

4.

(Необязательно) Чтобы добавить аутентификацию для доступа к службе приложений, настройте эти поля: Имя пользователя XML, Пароль XML, CISCO XML EXE Enable и Режим аутентификации 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.

В url-адресе поддерживаются только протоколы HTTP или HTTPs.

Имя пользователя XML

Значение по умолчанию: Пусто

Имя пользователя службы XML для целей аутентификации.

Этот параметр также можно настроить в XML-файле конфигурации телефона (cfg.xml), введя строку в следующем формате:

<XML_User_Name ua="na">имя пользователя</XML_имя_пользователя>

Пароль 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=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 настроена надлежащим образом.

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

Щелкните Сохранить все изменения.

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

пловец

Строка версии программного обеспечения. Например:

phoneos.3-2-1-0104-37

горбатый

Строка версии аппаратного обеспечения. Например 2.0.1

КНР

Состояние настройки (числовая строка):

-1 = явный запрос повторной синхронизации

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

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

2 = повторная синхронизация не удалась, повторите попытку

всплеск

Состояние обновления (числовая строка):

1 = первая попытка модернизации

2 = сбой модернизации; повторите попытку

модернизация

Сообщение о результате (ERR) предыдущей попытки модернизации, например http_get failed.

prvtmr

в секундах с момента последней попытки повторной синхронизации.

upgtmr

в секундах с момента последней попытки модернизации.

регтмр1

Количество секунд с момента потери линии 1 регистрации на сервере SIP.

regtmr2

Количество секунд с момента потери регистрации линии 2 на сервере SIP.

upgcond

Устаревшее имя макроса.

схема

схема доступа к файлу, один из TFTP, HTTP или HTTPS, полученный после повторной синхронизации синтаксиса или обновления URL-адреса.

серв

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

сервировка

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

порт

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

путь

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

ошибка

Сообщение о результате попытки повторной синхронизации или модернизации. Полезно только при создании итоговых сообщений системного журнала. Значение сохраняется в переменной UPGERR при попытке обновления.

Идентификатор пользователя

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

островок

Если модуль настроен, значение = 1, в противном случае — 0.

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

должностьИмя, связанное с первым подключенным, звонящим или входящим вызовом.
удаленный номер

Номер телефона первого подключенного, звонящего или входящего вызова. При наличии нескольких вызовов предоставляются данные, связанные с первым найденным вызовом.

Отображаемое ИМЯСодержимое параметра конфигурации отображаемого имени линии N.
AUTHIDnСодержимое параметра конфигурации идентификатора аутентификации линии N.