- Начало
- /
- Статия
Благодарим за обратната връзка.
XML конфигурация на приложения за телефони 9800 и 8875 (BroadWorks)
В тази статия
Обратна връзка?Тази помощна статия се отнася за Cisco Desk Phone Series 9800 и Cisco Video Phone 8875, регистрирани на Cisco BroadWorks. Прочетете тази статия за поддържаните XML обекти, URI и стъпките за конфигуриране на XSI услугите на телефонната уебстраница.
Общ преглед
XML Services Interface (XSI) е протокол, който позволява комуникация между приложения и телефонната система. Можете да добавите свои XSI услуги към телефона си, използвайки поддържаните XML обекти и URI.
След като се абонират за услугите, потребителите могат да достъпят всички конфигурирани услуги на телефона, като навигират до . Cisco XML services е стандартното име. Можеш също да смениш името. За да осигурите лесен достъп за потребителите, можете да добавите приложенията XML към софтуерни клавиши или линейни клавиши.
Поддържаните функции са:
- Съобщения (изображения и текст)
- Пейджинг
Поддържани XML обекти
-
CiscoIPPhoneMenu
-
CiscoIPPhoneText
-
CiscoIPPhoneInput
-
CiscoIPPhoneDirectory
-
CiscoIPPhoneImage
-
CiscoIPPhoneImageFile
-
CiscoIPPhoneIconMenu
-
CiscoIPPhoneIconFileMenu
-
CiscoIPPhoneStatus (с изключение на 9811 и 9841)
-
CiscoIPPhoneStatusFile (с изключение на 9811 и 9841)
-
CiscoIPPhoneExecute
Поддържани URI
-
Устройство
-
Набиране
-
РедакцияДейл
-
Първоначален
-
Ключ
-
Възпроизвеждане (само мелодии)
-
Функционален бутон
За повече подробности относно конфигурацията на услугата XSI, вижте Cisco Unified IP Phone Бележки за разработка на приложения за услуги.
Конфигурирайте телефон да се свързва с XML услуга
| 1 |
Преминете към уеб страницата за администриране на телефона. |
| 2 |
Изберете . |
| 3 |
В секцията за услугаXML конфигурирайте параметрите на URL адресите на Application Service Name и XML Application Service Name и XML Application Service URL параметри, както са дефинирани в Parameters for XML services. |
| 4 |
(По желание) За да добавите автентикация за достъп до приложната услуга, конфигурирайте тези полета: XML User Name, XML Password (парола), Cisco XML EXE Enable и Cisco XML EXE Auth Mode. |
| 5 |
Кликнете на "Запази всички промени". |
Параметри за XML услуги
Следната таблица дефинира функцията и използването на параметрите на приложението XML в секцията XML Service под Tab в уеб интерфейса на телефона. Освен това дефинира синтаксиса на низа, който се добавя в конфигурационния файл на телефона (cfg.xml) с XML код за конфигуриране на параметър.
|
Parameter |
По подразбиране и опции |
Описание |
|---|---|---|
|
XML Име на услуга на приложението |
По подразбиране: празно |
Името на приложението XML. Името се показва на телефона като избор на уеб приложение. Можете също да конфигурирате този параметър във файла XML на телефона (cfg.XML), като въведете низ във формата: |
|
XML URL на Application Service |
По подразбиране: празно |
URL адресът, където се намира приложението XML. Можете също да конфигурирате този параметър във файла XML на телефона (cfg.XML), като въведете низ във формата: Макро променливите се поддържат в XML URL адреси. За валидните макро променливи вижте Макро променливи, поддържани в XML URLs. В URL адреса се поддържат само HTTP или HTTP протоколи. |
|
Потребителско име за XML |
По подразбиране: празно |
XML потребителско име на услугата за целите на удостоверяване. Можете също да конфигурирате този параметър във файла XML на телефона (cfg.XML), като въведете низ във формата: |
|
Парола в XML |
По подразбиране: празно |
XML парола за услугата за посоченото потребителско име XML. Паролата, която сте въвели в това поле, се показва в конфигурационния файл (cfg.XML) по следния начин: |
|
Cisco XML EXE Активиране |
По подразбиране: Не Опции: Да, Не |
Уточнява дали е необходима автентикация за достъп до сървъра за приложения XML. Можете също да конфигурирате този параметър във файла XML на телефона (cfg.XML), като въведете низ във формата: |
|
Cisco XML EXE Auth режим |
По подразбиране: Локална идентификация Опции: Доверен, Местен сертификат, Отдалечен удостоверение |
Определя режима на автентикация за 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>
където
Пример fnc Можете също да конфигурирате този параметър във файла за конфигурация (cfg.XML). Въведете низ в този формат:
където n е числото на softkey. |
| 5 |
Кликнете на "Запази всички промени". |
Добавете приложение XML към линейния клавиш
Добавете често използваните приложения към линейни ключове, за да могат потребителите лесно да имат достъп до услугите.
Преди да започнете
XML Application Service е правилно конфигуриран.
| 1 |
Преминете към уеб страницата за администриране на телефона. |
| 2 |
Изберете . |
| 3 |
Изберете бутон за линия. |
| 4 |
Задайте параметъра Extension на Disabled , за да изключите разширението. Ако функцията Direct PLK Configuration е изключена, трябва да изключите разширението, за да добавите разширена функция към клавиша за линия. Ако функцията е активирана, можете да пропуснете тази стъпка. За подробности вижте Enable Direct PLK конфигурация. |
| 5 |
В параметъра Разширена функция въведете низ в този формат: fnc=XML; url=<xml_app_path>; nme=<app_name>
където
Пример Можете също да конфигурирате този параметър във файла за конфигурация (cfg.XML). Въведете низ в този формат:
където n е числото на вътрешния номер. |
| 6 |
Кликнете на "Запази всички промени". |
Макро променливи, поддържани в XML URL адреси
Можете да използвате макро променливи в XML URL адреси. Поддържат се следните макро променливи:
-
User ID—UID1, UID2 към UIDn
-
Показващо име — DISPLAYNAME1, DISPLAYNAME2 към DISPLAYNAMEn
-
Auth ID—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 квалификатор за повторно синхронизиране, --ключ. |
| 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. Статусът на персонализацията може да се види на страницата с информация за уеб интерфейса. |
| ВХОДЯЩО ИМЕ | Име, свързано с първо свързано, звънене или входящо обаждане. |
| ДИСТАНЦИОНЕН НОМЕР |
Телефонен номер на първо свързано, звънещо или входящо обаждане. Ако има няколко обаждания, се предоставят данните, свързани с първото намерено обаждане. |
| DISPLAYNAMEn | Съдържанието на параметъра за конфигурация на Display Name Line N. |
| AUTHIDn | Съдържанието на параметъра за идентификация на авторизацията на линия N. |
