- Главная
- /
- Статья
Благодарим вас за обратную связь.
Конфигурация приложений XML для телефонов 9800 и 8875 (BroadWorks)
В этой статье
Отправить обратную связь?Эта справочная статья относится к настольным телефонам Cisco серии 9800 и видеотелефону Cisco 8875, зарегистрированным в Cisco BroadWorks. Ознакомьтесь с поддерживаемыми объектами XML, URI и инструкциями по настройке служб XSI на веб-странице телефона.
Обзор
Интерфейс служб XML (XSI) — это протокол, обеспечивающий связь между приложениями и телефонной системой. Вы можете добавить свои собственные службы XSI на свой телефон, используя поддерживаемые объекты XML и URI.
После подписки телефона на услуги пользователи могут получить доступ ко всем настроенным службам телефона, выбрав . По умолчанию используется имя служб Cisco XML. Можно также изменить имя. Чтобы обеспечить пользователям легкий доступ, вы можете добавить приложения XML к функциональным или линейным клавишам.
Поддерживаются следующие функции:
- Сообщения (изображения и текст)
- Пейджинг
Поддерживаемые объекты XML
-
Меню телефона Cisco IP
-
Текст телефона Cisco IP
-
Вход для iPhone Cisco
-
Справочник телефонов Cisco IP
-
Изображение телефона Cisco IP
-
Файл образа телефона Cisco IP
-
Меню значков телефона Cisco
-
Меню файлов значков телефона Cisco
-
Состояние IP-телефонов Cisco (кроме 9811 и 9841)
-
Файл состояния телефонов Cisco IP (кроме 9811 и 9841)
-
Выполнить звонок на телефоне Cisco
Поддерживаемые URI
-
Устройство
-
Наберите
-
Редактируйте ежедневно
-
Инициализировать
-
Ключ
-
Играйте (только рингтоны)
-
Программная клавиша
Дополнительные сведения о конфигурации службы XSI см. в примечаниях по разработке приложений Cisco Unified IP Phone Services.
Настройте телефон для подключения к службе XML
| 1 |
Зайдите на веб-страницу администрирования телефона. |
| 2 |
Выберите «». |
| 3 |
В разделе «Служба XML» настройте параметры «Имя службы приложений XML» и «URL-адрес службы приложений XML», как определено в разделе Параметры XML-сервисов. |
| 4 |
(Необязательно) Чтобы добавить аутентификацию для доступа к службе приложений, настройте следующие поля: имя пользователя XML, пароль XML, разрешение CISCO XML EXE и режим аутентификации CISCO XML EXE. |
| 5 |
Нажмите кнопку «Сохранить все изменения». |
Параметры XML-сервисов
В следующей таблице описаны функции и использование параметров XML-приложения в разделе «Служба XML» на вкладке «» веб-интерфейса телефона. В ней также определен синтаксис строки, добавляемой в файл конфигурации телефона (cfg.xml) вместе с кодом XML для настройки параметра.
|
Параметр |
По умолчанию и опции |
Описание |
|---|---|---|
|
Имя службы приложений XML |
По умолчанию: пусто |
Имя XML-приложения. Имя отображается на телефоне в качестве выбранного веб-приложения. Этот параметр также можно настроить в XML-файле конфигурации телефона (cfg.xml), введя строку в следующем формате: |
|
URL-адрес службы приложений XML |
По умолчанию: пусто |
URL-адрес, на котором находится XML-приложение. Этот параметр также можно настроить в XML-файле конфигурации телефона (cfg.xml), введя строку в следующем формате: Макропеременные поддерживаются в URL-адресах XML. Допустимые макропеременные см. в разделе Макропеременные, поддерживаемые в URL-адресах XML. В URL-адресе поддерживаются только протоколы HTTP или HTTPS. |
|
Имя пользователя в формате XML |
По умолчанию: пусто |
Имя пользователя службы XML для аутентификации. Этот параметр также можно настроить в XML-файле конфигурации телефона (cfg.xml), введя строку в следующем формате: |
|
Пароль XML |
По умолчанию: пусто |
Пароль службы XML для указанного имени пользователя XML. Пароль, введенный в этом поле, отображается в файле конфигурации (cfg.xml) следующим образом: |
|
Включить EXE CISCO XML |
По умолчанию: нет Опции: да, нет |
Указывает, требуется ли аутентификация для доступа к серверу приложений XML. Этот параметр также можно настроить в XML-файле конфигурации телефона (cfg.xml), введя строку в следующем формате: |
|
Режим аутентификации CISCO XML EXE |
По умолчанию: локальные учетные данные Опции: доверенные, локальные учетные данные, удаленные учетные данные |
Указывает режим аутентификации для Cisco XML EXE.
Этот параметр также можно настроить в XML-файле конфигурации телефона (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 |
Установите для параметра Расширение значение Отключено, чтобы отключить расширение. Если функция Direct PLK Configuration отключена, необходимо отключить расширение, чтобы добавить расширенную функцию к линейной клавише. Если эта функция включена, этот шаг можно пропустить. Дополнительные сведения см. в разделе «Включить конфигурацию Direct PLK». |
| 5 |
В параметре Extended Function введите строку в следующем формате: fnc=xml;url=<xml_app_path>;nme=<app_name>
где
Пример
Этот параметр также можно настроить в файле конфигурации (cfg.xml). Введите строку в следующем формате:
где n — добавочный номер. |
| 6 |
Нажмите кнопку «Сохранить все изменения». |
Макропеременные, поддерживаемые в URL-адресах XML
В URL-адресах XML можно использовать макропеременные. Поддерживаются следующие макропеременные:
-
Идентификатор пользователя — от UID1, от UID2 до UIDn
-
Отображаемое имя — отображаемое имя 1, DISPLAYNAME2 для отображения имени
-
Идентификатор авторизации — AUTHID1, от AUTHID2 до AuthIDN
-
Прокси-сервер — прокси1, прокси-2 — прокси-сервер ProxyN
-
MAC-адрес с использованием шестнадцатеричных цифр в нижнем регистре — MA
-
Название продукта — PN
-
Номер серии продукта — PSN
-
Серийный номер — серийный номер
| Имя макроса | Расширение макроса |
|---|---|
| $ | Форма $$ расширяется до одного символа $. |
| От 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:08: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 не удался. |
|
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 |
Содержимое конфигурационного параметра Line n UserId. |
| ISCUST |
Если единица измерения настроена, значение = 1, в противном случае 0. Состояние настройки можно посмотреть на странице «Информация о веб-интерфейсе». |
| INCOMINGNAME | Имя, связанное с первым подключенным, звонящим или входящим звонком. |
| REMOTENUMBER |
Номер телефона первого подключенного, звонящего или входящего вызова. Если вызовов несколько, предоставляются данные, связанные с первым обнаруженным вызовом. |
| DisplayName | Содержимое параметра конфигурации «Отображаемое имя строки N». |
| AuthIDN | Содержимое конфигурационного параметра Line N auth ID. |
