- Начало
- /
- Статия
XML за телефони на BroadWorks
Тази помощна статия се отнася за Cisco Desk Phone 9800 Series и Cisco Video Phone 8875, които са регистрирани в Cisco BroadWorks. Прочетете тази статия за поддържаните XML обекти, URI адреси и стъпките за конфигуриране на XSI услугите на уеб страницата на телефона.
Общ преглед
XML Services Interface (XSI) е протокол, който позволява комуникация между приложенията и телефонната система. Можете да добавите свои собствени XSI услуги към телефона си, като използвате поддържаните XML обекти и URI.
След като се абонират за услугите на телефона, потребителите могат да получат достъп до всички конфигурирани услуги на телефона, като навигират до
. 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 код за конфигуриране на параметър.
Parameter |
По подразбиране и опции |
Описание |
---|---|---|
Име на XML приложна услуга |
По подразбиране: празно |
Име на XML приложението. Името се показва на телефона като избор на уеб приложение. Можете също да конфигурирате този параметър във XML файла за конфигурация на телефона (cfg.xml), като въведете низ в този формат:
|
URL адрес на услугата за XML приложения |
По подразбиране: празно |
URL адресът, където се намира XML приложението. Можете също да конфигурирате този параметър във XML файла за конфигурация на телефона (cfg.xml), като въведете низ в този формат:
Макро променливите се поддържат в XML URL адреси. За валидните макро променливи вижте Макро променливи, поддържани в XML URL адреси. В URL адреса се поддържат само HTTP или HTTP протоколи. |
Потребителско име за XML |
По подразбиране: празно |
Потребителско име на XML услугата за целите на удостоверяването. Можете също да конфигурирате този параметър във XML файла за конфигурация на телефона (cfg.xml), като въведете низ в този формат:
|
Парола в XML |
По подразбиране: празно |
Парола за XML услуга за посоченото XML потребителско име. Паролата, която сте въвели в това поле, се показва в конфигурационния файл (cfg.xml) както следва:
|
Активиране на CISCO XML EXE |
По подразбиране: Не Опции: Да, Не |
Указва дали удостоверяването е необходимо за достъп до сървъра на XML приложенията. Можете също да конфигурирате този параметър във XML файла за конфигурация на телефона (cfg.xml), като въведете низ в този формат:
|
CISCO XML EXE режим на удостоверяване |
По подразбиране: Локални идентификационни данни Опции: Доверени, Локални идентификационни данни, Отдалечени идентификационни данни |
Указва режима на удостоверяване за Cisco XML EXE.
Можете също да конфигурирате този параметър във XML файла за конфигурация на телефона (cfg.xml), като въведете низ в този формат:
|
Добавяне на XML приложение към функционален бутон
Добавете често използваните приложения към функционалните клавиши, за да могат потребителите да имат лесен достъп до услугата.
Преди да започнете
XML Application Service е правилно конфигуриран.
1 |
Преминете към уеб страницата за администриране на телефона. |
2 |
Изберете . |
3 |
В секцията Програмируеми функционални клавиши задайте Активиране на програмируем функционален бутон на Да. Можете също да конфигурирате този параметър в конфигурационния файл (cfg.xml). Въведете низ в този формат:
|
4 |
В секцията Програмируеми функционални клавиши редактирайте наличните полета от PSK1 до PSK16 в този формат: fnc=xml;url=<xml_app_path>; nme=<app_name>
където
Пример Можете също да конфигурирате този параметър в конфигурационния файл (cfg.xml). Въведете низ в този формат:
където n е числото на софтуерния клавиш. |
5 |
Щракнете върху Запазване на всички промени. |
Добавяне на XML приложение към клавиш на ред
Добавете често използваните приложения към клавишите за редове, за да могат потребителите да имат лесен достъп до услугите.
Преди да започнете
XML Application Service е правилно конфигуриран.
1 |
Преминете към уеб страницата за администриране на телефона. |
2 |
Изберете . |
3 |
Изберете бутон за линия. |
4 |
Задайте параметъра Разширение на Деактивирано , за да деактивирате разширението. Ако функцията за директна конфигурация на PLK е деактивирана, трябва да деактивирате разширението, за да добавите разширена функция към клавиша на линията. Ако функцията е активирана, можете да пропуснете тази стъпка. За подробности вижте Активиране на директна конфигурация на PLK. |
5 |
В параметъра Разширена функция въведете низ в този формат: fnc=xml;url=<xml_app_path>; nme=<app_name>
където
Пример Можете също да конфигурирате този параметър в конфигурационния файл (cfg.xml). Въведете низ в този формат:
където n е числото на вътрешния номер. |
6 |
Щракнете върху Запазване на всички промени. |
Макро променливи, поддържани в XML URL адреси
Можете да използвате макро променливи в XML URL адреси. Поддържат се следните макро променливи:
-
Потребителски идентификатор – UID1, UID2 към UIDn
-
Показвано име – DISPLAYNAME1, DISPLAYNAME2 в DISPLAYNAMEn
-
Удостоверяване на ИД – AUTHID1, AUTHID2 към AUTHIDn
-
Прокси – ПРОКСИ1, ПРОКСИ2 към ПРОКСИ
-
MAC адрес с малки шестнадесетични цифри – MA
-
Име на продукта—PN
-
Номер на серията на продукта – PSN
-
Сериен номер – SERIAL_NUMBER
Име на макрос | Макро разширяване |
---|---|
$ | Формулярът $$ се разширява до един знак $. |
A до P | Заменени с параметри с общо предназначение GPP_A през GPP_P. |
SA до SD | Заменя се от параметрите за специална цел GPP_SA до GPP_SD. Тези параметри носят ключове или пароли, използвани в обезпечаването. $SA до $SD се разпознават като аргументи на предлагания като опция URL квалификатор за повторно синхронизиране, --ключ. |
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. |
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. |