- Главная
- /
- Статья
Благодарим вас за обратную связь.
XML для телефонов 9800 и 8875 (BroadWorks)
В этой статье
Отправить обратную связь?Данная статья справки относится к настольным телефонам Cisco серий 9800 и Cisco Video Phone 8875, которые зарегистрированы в Cisco BroadWorks. Прочитайте в этой статье поддерживаемые объекты XML, идентификаторы URI и шаги настройки сервисов XSI на веб-странице телефона.
Обзор
Интерфейс сервисов XML (XSI) — это протокол, обеспечивающий связь между приложениями и телефонной системой. Вы можете добавить к телефону свои собственные сервисы XSI, используя поддерживаемые объекты XML и URI.
Подписав телефон на службы, пользователи могут получить доступ ко всем настроенным сервисам на телефоне, перейдя к . По умолчанию используется имя сервисов Cisco XML. Вы также можете изменить имя. Чтобы облегчить доступ пользователей, вы можете добавить приложения XML к программным клавишам или клавишам линий.
Поддерживаемые функции:
- Сообщения (изображения и текст)
- Подкачки
Поддерживаемые объекты XML
-
CiscoIPPhoneMenu
-
CiscoIPPhoneText
-
CiscoIPPhoneInput
-
CiscoIPPhoneDirectory
-
CiscoIPPhoneImage
-
CiscoIPPhoneImageFile
-
CiscoIPPhoneIconMenu
-
CiscoIPPhoneIconФильмэню
-
CiscoIPPhoneStatus (кроме 9811 и 9841)
-
CiscoIPPhoneStatus Подполье (кроме 9811 и 9841)
-
CiscoIPPhoneExecute
Поддерживаемые URI
-
Устройства
-
Циферблат
-
Редакт. Дэйл
-
Иниц.
-
Ключ
-
Воспроизведение (только сигналы звонка)
-
Экранная клавиша
Дополнительные сведения о конфигурации службы XSI см . в примечаниях по разработке приложений служб Cisco Unified IP Phone.
Настройте телефон для подключения к службе XML
| 1 |
Доступ к веб-странице администрирования телефона. |
| 2 |
Выберите . |
| 3 |
В разделе "СлужбаXML" настройте значения XML имя службы приложений и URL-адрес XML службы приложений, как указано в разделе "Параметры XML сервисов". |
| 4 |
(Необязательно) Для добавления аутентификации для доступа к службе приложений настройте следующие поля: XML имя пользователя, XML пароль, Cisco XML EXE Включить и Cisco XML режим аутентификации EXE. |
| 5 |
Щелкните Сохранить все изменения. |
Параметры для сервисов XML
В следующей таблице описаны функции и использование параметров приложения XML в разделе «Служба XML» в разделе Tab в веб-интерфейсе телефона. Здесь также определяется синтаксис строки, добавляемой в файл конфигурации телефона с XML-кодом (cfg.xml), для настройки параметра.
|
Параметр |
Значение по умолчанию и параметры |
Описание |
|---|---|---|
|
Имя службы приложений XML |
Значение по умолчанию: пустое |
Имя приложения XML. Имя отображается на телефоне как вариант веб-приложения. Этот параметр также можно настроить в файле конфигурации телефона (cfg.xml), введя строку в следующем формате: |
|
URL службы приложений XML |
Значение по умолчанию: пустое |
URL-адрес, по которому находится приложение XML. Этот параметр также можно настроить в файле конфигурации телефона (cfg.xml), введя строку в следующем формате: URL-адресах XML поддерживаются переменные макросов. Сведения о допустимых макро переменных см. в разделе «Макро переменные, поддерживаемые в URL-адресах XML. В URL-адресе поддерживаются только протоколы HTTP или HTTP. |
|
Имя пользователя XML |
Значение по умолчанию: пустое |
Имя пользователя службы XML для целей аутентификации. Этот параметр также можно настроить в файле конфигурации телефона (cfg.xml), введя строку в следующем формате: |
|
Пароль XML |
Значение по умолчанию: пустое |
Пароль службы XML для указанного имени пользователя XML. Пароль, введенный в это поле, показан в файле конфигурации (cfg.XML) следующим образом: |
|
Включение CISCO XML EXE |
Значение по умолчанию: Нет Варианты: «Да», «Нет» |
Указывает, требуется ли аутентификация для доступа к серверу приложений XML. Этот параметр также можно настроить в файле конфигурации телефона (cfg.xml), введя строку в следующем формате: |
|
Режим аутентификации CISCO XML EXE |
Значение по умолчанию: Локальные учетные данные Параметры: доверенные, локальные учетные данные, удаленные учетные данные |
Указывает режим аутентификации для Cisco XML EXE.
Этот параметр также можно настроить в файле конфигурации телефона (cfg.xml), введя строку в следующем формате: |
Добавьте приложение XML к программной клавише
Добавьте часто используемые приложения в программные клавиши, чтобы пользователям было легче получить доступ к службе.
Перед началом настройки
Служба приложений XML настроена надлежащим образом.
| 1 |
Доступ к веб-странице администрирования телефона. |
| 2 |
Выберите . |
| 3 |
В разделе Программные клавиши задайте для поля Включить программную клавишу значение Да. Этот параметр также можно настроить в файле конфигурации (cfg.xml). Введите строку в следующем формате: |
| 4 |
В разделе «Программные клавиши » измените доступные поля с PSK1 по PSK16 в таком формате: fnc =XML; url=<xml_app_path>; nme = <app_name>
где
Пример Этот параметр также можно настроить в файле конфигурации (cfg.xml). Введите строку в следующем формате:
где n — номер программной клавиши. |
| 5 |
Щелкните Сохранить все изменения. |
Добавьте приложение XML к клавише линии
Добавьте часто используемые приложения для клавиш линий, чтобы пользователям было легче получить доступ к службам.
Перед началом настройки
Служба приложений XML настроена надлежащим образом.
| 1 |
Доступ к веб-странице администрирования телефона. |
| 2 |
Выберите . |
| 3 |
Выберите клавишу линии. |
| 4 |
Задайте для параметра Добавочный номер значение Отключено для деактивации добавочного номера. Если функция прямой конфигурации PLK отключена, необходимо отключить добавочный номер, чтобы добавить расширенную функцию к клавише линии. Если эта функция включена, можно пропустить данный шаг. Подробнее см. раздел «Включение конфигурации direct PLK». |
| 5 |
В параметре Расширенная функция введите строку в следующем формате: fnc =XML; url=<xml_app_path>; nme = <app_name>
где
Пример Этот параметр также можно настроить в файле конфигурации (cfg.xml). Введите строку в следующем формате:
Где n — это добавочный номер. |
| 6 |
Щелкните Сохранить все изменения. |
Макро переменные, поддерживаемые в URL-адресах XML
Вы можете использовать переменные макроса в URL-адресах XML. Поддерживаются следующие переменные макроса:
-
Идентификатор пользователя: UID1, UID2, ..., UIDn
-
Отображаемое имя: DISPLAYNAME1, DISPLAYNAME2, ..., DISPLAYNAMEn
-
Идентификатор аутентификации: AUTHID1, AUTHID2, ..., AUTHIDn
-
Прокси: PROXY1, PROXY2, ..., PROXYn
-
MAC-адрес с использованием шестнадцатеричных цифр в нижнем регистре: MA
-
Наименование продукта: PN
-
Номер серии продукта — PSN
-
Серийный номер: SERIAL_NUMBER
| Имя макроса | Раскрытие макросов |
|---|---|
| $ | Форма $$ раскрывается в одиночный символ $. |
| От 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). |
| PN | Название продукта; например, видеосвязь 8875, настольный телефон 9851. |
| PSN | Номер серии продукта; например, 8875, 9841, 9861 |
| SN | Строка серийного номера, например 88012BA01234. |
| CCERT | Состояние сертификата SSL клиента, установлен или не установлен. |
| IP | IP-адрес телефона в локальной подсети, например 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 в идентификаторе аутентификации. |
