- Начало
- /
- Статия
Благодарим за обратната връзка.
Конфигурация на XML приложения за телефони 9800 и 8875 (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
-
ЦискоипфонТекст
-
CISCOIPPhoneВъведение
-
CiscoipPhoneДиректория
-
Цискоипфон Изображение
-
CiscoIPPhoneФайл с изображения
-
Меню на иконата на цискоипфон
-
CiscoipPhoneIconМене на файла
-
CISCOIPPhoneStatus (с изключение на 9811 и 9841)
-
CISCOIPPhonStatus File (с изключение на 9811 и 9841)
-
CiscoIPPhoneИзпълнение
Поддържани URI
-
Устройство
-
Наберете
-
Редактирай
-
Инит
-
Ключ
-
Възпроизвеждане (само мелодии)
-
Софтключ
За повече подробности относно конфигурацията на XSI услугата вижте Бележки за разработване на приложения за унифици рани IP телефонни услуги на Cisco.
Конфигуриране на телефон за свързване към XML услуга
| 1 |
Достъп до уеб страницата за администриране на телефона. |
| 2 |
Изберете Г . |
| 3 |
В секцията XML услуга конфигурирайте параметрите за име на услугата за приложение XML и URL адреса на XML услу гата за приложения, както са дефинирани в Параметри за XML услуги. |
| 4 |
(Незадължително) За да добавите удостоверяване за достъп до услугата за приложения, конфигурирайте тези полета: XML потребителско име, XML парола, CISCO XML EXE Enable и CISCO XML EXE Auth Mo de. |
| 5 |
Щракнете върху Запазване на всички промени. |
Параметри за XML услуги
Следващата таблица определя функцията и използването на параметрите на приложението XML в раздела XML Service в раздела фон в уеб интерфейса на телефона. Той също така определя синтаксиса на низа, който се добавя в конфигурационния файл на телефона (cfg.xml) с XML код за конфигуриране на параметър.
|
параметър |
По подразбиране и опции |
Описание |
|---|---|---|
|
Име на услугата XML приложение |
По подразбиране: Празно |
Име на XML приложението. Името се показва на телефона като избор на уеб приложение. Можете също да конфигурирате този параметър в XML файла за конфигурация на телефона (cfg.xml), като въведете низ в този формат: |
|
URL адрес на услугата за приложение XML |
По подразбиране: Празно |
URL адресът, където се намира приложението XML. Можете също да конфигурирате този параметър в XML файла за конфигурация на телефона (cfg.xml), като въведете низ в този формат: Макропроменливите се поддържат в XML URL адресите. За валидните макрос променливи вижте Макропроменливи, поддържани в URL адресите на XML. В 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 е правилно конфигурирана.
| 1 |
Достъп до уеб страницата за администриране на телефона. |
| 2 |
Изберете Г . |
| 3 |
В секцията Програ мируеми програмни клавиши задайте Активиране на програмируемия софтуерен клавиш на Да. Можете също да конфигурирате този параметър в конфигурационния файл (cfg.xml). Въведете низ в този формат: |
| 4 |
В секцията Програ мируеми програмни клави ши редактирайте наличните полета на PSK1 до PSK 16 в този формат: fnc=xml;url=<xml_app_path>;nme=<app_name>
където
Пример
Можете също да конфигурирате този параметър в конфигурационния файл (cfg.xml). Въведете низ в този формат:
където n е но мерът на софтуерния клавиш. |
| 5 |
Щракнете върху Запазване на всички промени. |
Добавяне на XML приложение към линиен ключ
Добавете често използваните приложения към линейни клавиши, за да могат потребителите лесно да имат достъп до услугите.
Преди да започнете
Услугата за приложения XML е правилно конфигурирана.
| 1 |
Достъп до уеб страницата за администриране на телефона. |
| 2 |
Изберете Г . |
| 3 |
Изберете линейен клавиш. |
| 4 |
Задайте параметъра Разширение на Деактиви рано, за да деактивирате разширението. Ако функцията Direct PLK Configuration е деактивирана, трябва да деактивирате разширението, за да добавите разширена функция към линейния клавиш. Ако функцията е активирана, можете да пропуснете тази стъпка. За подробности вижте А ктивиране на директна конфигурация на PLK. |
| 5 |
В параметъра Разши рена функция въведете низ в този формат: fnc=xml;url=<xml_app_path>;nme=<app_name>
където
Пример
Можете също да конфигурирате този параметър в конфигурационния файл (cfg.xml). Въведете низ в този формат:
където n е но мерът на разширението. |
| 6 |
Щракнете върху Запазване на всички промени. |
Макро променливи, поддържани в XML URL адреси
Можете да използвате макрос променливи в XML URL адреси. Поддържат се следните макропроменливи:
-
Идентификационен номер на потребителя — UID1, UID2 към UiDn
-
Име на показване—DisplayName1, DISPLAYNAME2 към DisplayNameName
-
Идентификационен номер — AUTHID1, AUTHID2 към AuthIDN
-
Прокси — прокси 1, PROXY2 към прокси
-
MAC адрес, използващ малки шестостенни цифри — MA
-
Име на продукта — PN
-
Номер на продуктовата серия — PSN
-
Серийен номер - Серийно_номер
| Име на макрос | Макро разширение |
|---|---|
| $ | Формата $$ се разширява до един символ $. |
| А до P | Заменен от параметри с общо предназначение GPP_A чрез GPP_P. |
| SA през SD | Заменен от параметри със специално предназначение GPP_SA чрез GPP_SD. Тези параметри съдържат
ключове или пароли, използвани при осигуряването. $SA до $SD се разпознават като аргументи към опционалния квалификатор за пресинхронизиране на URL адреса, --key. |
| MA | MAC адрес, използващ малки шестостенни цифри (000e08aabbcc). |
| MAU | MAC адрес, използващ главни шестостенни цифри (000E08AABBCC). |
| MAC | MAC адрес, използващ малки шестостенни цифри с двоеточие за разделяне на двойки шестостенни цифри (00:0 e: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 |
Секунди, откакто Line 2 загуби регистрация с SIP сървър. |
|
UPGCOND |
Наследно име на макрос. |
|
SCHEME |
Схема за достъп до файлове, една от TFTP, HTTP или HTTPS, получена след анализиране на URL адреса за повторно синхронизиране или надграждане. |
|
SERV |
Заявете име на хост на целевия сървър, получено след анализиране на URL адреса за повторно синхронизиране или надграждане. |
|
SERVIP |
Заявете IP адрес на целевия сървър, получен след анализиране на URL адреса за повторно синхронизиране или надграждане, вероятно след DNS търсене. |
|
PORT |
Заявете целевия UDP/TCP порт, получен след анализиране на URL адреса за повторно синхронизиране или надграждане. |
|
PATH |
Заявете пътя на целевия файл, получен след анализиране на URL адреса за повторно синхронизиране или надграждане. |
|
ERR |
Съобщение за резултат от опита за повторно синхронизиране или надграждане. Полезно само при генериране на съобщения за резултати syslog. Стойността се запазва в променливата UPGERR в случай на опити за надграждане. |
|
UIDn |
Съдържанието на конфигурационния параметър Line n userId. |
| ISCUST |
Ако единицата е персонализирана, стойност:1, в противен случай 0. Състоянието на персонализиране може да се види на страницата Информация за уеб потребителския интерфейс. |
| INCOMINGNAME | Име, свързано с първо свързано, звънене или входящо повикване. |
| REMOTENUMBER |
Телефонен номер на първо свързано, звънене или входящо повикване. Ако има няколко повиквания, се предоставят данните, свързани с първото намерено повикване. |
| Име на дисплея | Съдържанието на параметъра за конфигурация на името на дисплея на линия N. |
| AuthIDN | Съдържанието на конфигурационния параметър Line N auth ID. |
