- Начало
- /
- Статия
Конфигурация на XML приложения за телефони в BroadWorks
Тази помощна статия се отнася за Cisco Desk Phone 9800 и Cisco Video Phone 8875, които са регистрирани в Cisco BroadWorks. Прочетете тази статия за поддържаните XML обекти, URIs и стъпките за конфигуриране на XSI услугите на уеб страницата на телефона.
Общ преглед
Интерфейсът на XML Services Interface (XSI) е протокол, който позволява комуникация между приложенията и телефонната система. Можете да добавите собствени XSI услуги към телефона си с помощта на поддържаните XML обекти и URIs.
След като се абонират за телефона за услугите, потребителите могат да получат достъп до всички конфигурирани услуги на телефона, като се придвижат до
. XML услугите на Cisco са името по подразбиране. Можете също да промените името. За да осигурите лесен достъп за потребителите, можете да добавите XML приложенията към софтуерни или бутони за линия.Поддържаните функции са:
- Съобщения (изображения и текст)
- Пейджинг
Поддържани XML обекти
-
Меню на CiscoIPPhone
-
CiscoIPPhoneText
-
Вход за CiscoIPPhone
-
CiscoIPPhoneDirectory
-
Изображение на CiscoIPPhone
-
CiscoIPhoneImageFile
-
CiscoIPPhoneIconMenu
-
Меню на CiscoIPPhoneIconFileMenu
-
CiscoIPPhoneStatus (с изключение на 9841)
-
CiscoIPPhoneStatusFile (с изключение на 9841)
-
CiscoIPPhoneExecute
Поддържани URI адреси
-
Устройство
-
Набиране
-
EditDail
-
Инит
-
Ключ
-
Възпроизвеждане (само за мелодии)
-
Софтуерен бутон
За повече подробности относно конфигурацията на XSI услугата вижте Бележки за разработката на приложения на Cisco Unified IP Phone Services.
Конфигуриране на телефон за свързване към XML услуга
1 |
Отворете уеб страницата за администриране на телефона. |
2 |
Изберете . |
3 |
В раздела XML услуга конфигурирайте параметрите на XML Application Service Name и URL адреса на XML Application Service, както са дефинирани в Параметри за 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), като въведете низ в следния формат:
Променливите на макросите се поддържат в XML URL адресите. За валидните макро променливи вижте Макро променливи, поддържани в XML URL адреси. В URL адреса се поддържат само HTTP или HTTPs протоколи. |
Потребителско име в 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 приложения е конфигурирана правилно.
1 |
Отворете уеб страницата за администриране на телефона. |
2 |
Изберете . |
3 |
В раздела Програмируеми софтуерни бутони задайте Активиране на програмируем софтуерен бутон на Да. Можете също да конфигурирате този параметър в конфигурационния файл (cfg.xml). Въведете низ в следния формат:
|
4 |
В раздела Програмируеми софтуерни бутони редактирайте наличните полета от PSK1 до PSK16 в следния формат: fnc=xml;url=<xml_app_path>;nme=<app_name>
където URL е връзката, където се съхранява XML приложението; nme е показваното име на приложението на екрана на телефона.
Пример
Можете също да конфигурирате този параметър в конфигурационния файл (cfg.xml). Въведете низ в следния формат:
където n е номерът на софтуерния бутон. |
5 |
Щракнете върху Запиши всички промени. |
Добавяне на XML приложение към бутон за линия
Добавете често използваните приложения към бутоните с функции, за да могат потребителите лесно да получат достъп до услугите.
Преди да започнете
Услугата за XML приложения е конфигурирана правилно.
1 |
Отворете уеб страницата за администриране на телефона. |
2 |
Изберете . |
3 |
Изберете бутон за линия. |
4 |
Задайте параметъра Вътрешен номер на Деактивиран, за да забраните вътрешния номер. Ако функцията за директно конфигуриране на PLK е деактивирана, трябва да деактивирате разширението, за да добавите разширена функция към бутона за линия. Ако функцията е активирана, можете да пропуснете тази стъпка. За подробности вижте Активиране на директна конфигурация на PLK. |
5 |
В параметъра Разширена функция въведете низ в следния формат: fnc=xml;url=<xml_app_path>;nme=<app_name>
където URL е връзката, където се съхранява XML приложението; nme е показваното име на приложението на екрана на телефона.
Пример
Можете също да конфигурирате този параметър в конфигурационния файл (cfg.xml). Въведете низ в следния формат:
където n е вътрешният номер. |
6 |
Щракнете върху Запиши всички промени. |
Променливи на макросите, поддържани в XML URL адресите
Можете да използвате макро променливи в XML URL. Поддържат се следните макро променливи:
-
ИД на потребител – UID1, UID2 на UIDn
-
Показвано име—DISPLAYNAME1, DISPLAYNAME2 до DISPLAYNAMEn
-
ИД на удостоверяване – AUTHID1, AUTHID2 на AUTHIDn
-
Прокси сървър – ПРОКСИ1, ПРОКСИ2 към ПРОКСИn
-
MAC адрес при използване на малки шестнадесетични цифри – MA
-
Име на продукт – PN
-
Номер на серията продукти – PSN
-
Сериен номер—SERIAL_NUMBER
Име на макрос | Макро разширение |
---|---|
$ | Формулярът $$ се разширява до един знак $. |
A до P | Заменя се от параметрите с общо предназначение GPP_A до GPP_P. |
SA до SD | Заменя се от параметрите за специална цел GPP_SA до GPP_SD. Тези параметри държат ключове или пароли, използвани в осигуряването. $SA до $SD се разпознават като аргументи на незадължителния квалификатор на URL за повторно синхронизиране, --key. |
Ма | MAC адрес при използване на малки шестнадесетични цифри (000e08aabbcc). |
MAU | MAC адрес при използване на главни шестнадесетични цифри (000E08AABBCC). |
mac | MAC адрес при използване на малки шестнадесетични цифри с двоеточие за разделяне на сдвоените шестнадесетични цифри (00:0e:08:aa:bb:cc). |
pn | Име на продукта; например Video Phone 8875, Desk Phone 9851. |
psn | Номер на серия продукти; например 8875, 9841, 9861 |
шшшт | Низ на серийния номер; например 88012BA01234. |
Ccert | Състояние на сертификата на SSL клиент, инсталиран или неинсталиран. |
IP | IP адрес на телефона в неговата локална подмрежа; например 192.168.1.100. |
пояснение | Външен IP на телефона, както се вижда в интернет; например 66.43.16.52. |
swver |
Низ на софтуерната версия. Например, phoneos.3-2-1-0104-37 |
превъплъщение |
Низ на хардуерната версия. Например 2.0.1 |
првст |
Състояние на обезпечаване (цифров низ): -1 = изрична заявка за повторно синхронизиране 0 = повторно синхронизиране при включване на захранването 1 = периодично повторно синхронизиране 2 = неуспешно повторно синхронизиране, повторен опит |
upgst |
Състояние на надграждане (цифров низ): 1 = първи опит за надграждане 2 = неуспешно надстройване, повторен опит |
upgerr |
Съобщение с резултат (ERR) от предишен опит за надграждане; например неуспешен http_get. |
првтмр |
Секунди след последния опит за повторно синхронизиране. |
upgtmr |
Секунди след последния опит за надграждане. |
regtmr1 |
Секунди след загуба на регистрацията на SIP сървъра на линия 1. |
regtmr2 |
Секунди след загуба на регистрацията на SIP сървъра на линия 2. |
upgcond |
Старо име на макрос. |
схема |
Схема за достъп до файлове, един от TFTP, HTTP или HTTPS, както е получен след повторно синхронизиране за синтактичен анализ или надграждане на URL. |
серв |
Изискайте името на хоста на целевия сървър, както е получен след повторното синхронизиране за синтактичен анализ или надграждането на URL. |
сервиране |
Изискайте IP адреса на целевия сървър, както е получен след повторното синхронизиране за синтактичен анализ или надграждането на URL, като следвате търсенето на DNS. |
порт |
Изискайте целевия UDP/TCP порт, както е получен след повторното синхронизиране за синтактичен анализ или надграждането на URL. |
път |
Изискайте пътя на целевия файл, както е получен след повторното синхронизиране за синтактичен анализ или надграждането на URL. |
грешка |
Съобщение за резултата от повторно синхронизиране или опит за надграждане. Полезно е само при генериране на съобщения с резултат от syslog. Стойността се запазва в променливата UPGERR в случай на опити за надграждане. |
UID |
Съдържанието на параметъра за конфигуриране на Line n UserID. |
Iscust |
Ако единицата е персонализирана, стойност=1, в противен случай 0. Статусът на персонализиране се вижда на уеб страницата с информация за потребителския интерфейс. |
входящиName | Име, свързано с първото свързано, позвъняване или входящо повикване. |
отдалечен umber |
Телефонен номер на първото свързано, позвъняване или входящо повикване. Ако има много повиквания, се предоставят данните, свързани с първото открито повикване. |
DisplayName | Съдържанието на параметъра за конфигуриране на името на дисплея за линия N. |
AUTHID | Съдържанието на параметъра за конфигуриране на ИД за удостоверяване на линия N. |