Обзор

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

Подписав телефон на службы, пользователи могут получить доступ ко всем настроенным сервисам на телефоне, перейдя к настройкам > Network и сервисам > Cisco XML сервисы . Имя службы Cisco XML — это имя по умолчанию. Вы также можете изменить имя. Чтобы облегчить доступ пользователей, можно добавить XML приложения к экранным клавишам или клавишам линий.

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

  • Сообщения (изображения и текст)
  • Замещение страниц

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

  • CiscoIPPhoneMenu

  • CiscoIPPhoneText

  • CiscoIPPhoneInput

  • CiscoIPPhoneDirectory

  • CiscoIPPhoneImage

  • CiscoIPPhoneImageFile

  • CiscoIPPhoneIconMenu

  • CiscoIPPhoneIconФильмэню

  • CiscoIPPhoneStatus (кроме 9841)

  • CiscoIPPhoneStatusХ (кроме 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» на вкладке «Голос > Phone » веб-интерфейса телефона. Здесь также определяется синтаксис строки, добавляемой в файл конфигурации телефона с XML-кодом (cfg.xml), для настройки параметра.

Таблица 1. Параметры для XML сервисов

Параметр

Значение по умолчанию и параметры

Описание

Имя службы приложений XML

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

Имя приложения XML. Имя отображается на телефоне как вариант веб-приложения.

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

<XML_Application_Service_Name ua="na">XML имя APP</XML_Application_Service_Name>

URL службы приложений XML

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

URL-адрес, по которому находится приложение XML.

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

<XML_Application_Service_URL ua="na">https://server.com/path/app.xml</XML_Application_Service_URL>

URL-адресах XML поддерживаются переменные макросов. Допустимые макро переменные см. в разделе Макро переменных, поддерживаемых в XML URL-адресах.

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

Имя пользователя 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.

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

<CISCO_XML_EXE_Enable ua="na">Yes</CISCO_XML_EXE_Enable>

Режим аутентификации CISCO XML EXE

Значение по умолчанию: Локальные учетные данные

Параметры: доверенные, локальные учетные данные, удаленные учетные данные

Указывает режим аутентификации для Cisco XML EXE.

  • Доверенный — аутентификация не выполняется вне зависимости от локальных учетных данных.

  • Локальные учетные данные — аутентификация выполняется на основе дайджест-проверки подлинности с использованием локальных учетных данных, если они заданы. Если локальные учетные данные не заданы, аутентификация не выполняется.

  • Удаленные учетные данные — аутентификация выполняется на основе дайджест-проверки подлинности с использованием удаленных учетных данных, заданных в приложении 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">Yes</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<код конфигурации></PSK_n>

где n — номер программной клавиши.

5

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

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

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

Перед началом настройки

Служба приложений XML настроена надлежащим образом.

1

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

2

Выберите Голосовая связь > Телефон.

3

Выберите клавишу линии.

4

Задайте для параметра Добавочный номер значение Отключено для деактивации добавочного номера.

Если функция прямой конфигурации PLK отключена, необходимо отключить добавочный номер, чтобы добавить расширенную функцию к клавише линии. Если эта функция включена, можно пропустить данный шаг. Подробнее см. раздел «Включение конфигурации direct 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<код конфигурации></Extended_Function_n_>

Где n — это добавочный номер.

6

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

Макро переменные, поддерживаемые в XML URL-адресах

Вы можете использовать переменные макроса в 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).
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 failed.

PRVTMR

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

UPGTMR

Количество секунд с момента последней попытки обновления.

REGTMR1

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

REGTMR2

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

UPGCOND

Имя устаревшего макроса.

SCHEME

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

SERV

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

SERVIP

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

PORT

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

PATH

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

ERR

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

UIDn

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

ISCUST

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

Статус настройки можно увидеть на странице «Информация о веб-интерфейсе».

INCOMINGNAMEИмя, связанное с первым подключенным, звонящим или входящим вызовом.
REMOTENUMBER

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

DISPLAYNAMEnСодержание параметра конфигурации строки N в отображаемом имени.
AUTHIDnСодержание параметра конфигурации строки N в идентификаторе аутентификации.