- Головна
- /
- Стаття
Дякуємо за відгук.
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
-
Пристрій
-
Циферблат
-
РедагуванняДейл
-
Init
-
Ключ
-
Відтворити (тільки рінгтони)
-
Програмна клавіша
Для детальнішої інформації про конфігурацію сервісу XSI див. Cisco Unified IP Phone Services Application Development Notes.
Налаштуйте телефон для підключення до сервісу XML
| 1 |
Відкрийте веб-сторінку адміністрування телефона. |
| 2 |
Виберіть . |
| 3 |
У розділі сервісуXML налаштуйте ім'я сервісуXML Application Service та параметри URL сервісу застосунківXML як визначені в Параметрах для сервісів XML. |
| 4 |
(За бажанням) Щоб додати автентифікацію для доступу до сервісу додатку, налаштуйте ці поля: XML Ім'я користувача, XML Пароль, Cisco XML EXE Enable та Cisco XML EXE Auth Mode. |
| 5 |
Натисніть «Зберегти всі зміни». |
Параметри для сервісів XML
Наступна таблиця визначає функцію та використання параметрів застосунка XML у розділі сервісу XML у розділі Tab у веб-інтерфейсі телефону. Тут також визначено синтаксис рядка, який додається до файлу конфігурації телефона (cfg.xml) з кодом XML для налаштування параметра.
|
Параметр |
За замовчуванням і опції |
Опис |
|---|---|---|
|
XML Назва сервісу додатку |
За замовчуванням: пусто |
Назва заявки XML. Назва відображається на телефоні як вибір веб-додатку. Ви також можете налаштувати цей параметр у файлі конфігурації телефону XML (cfg.XML), ввівши рядок у такому форматі: |
|
XML URL сервісу додатку |
За замовчуванням: пусто |
URL, де розташований додаток XML. Ви також можете налаштувати цей параметр у файлі конфігурації телефону XML (cfg.XML), ввівши рядок у такому форматі: Макрозмінні підтримуються у URL XML. Для допустимих макрозмінних див. Макрозмінні, що підтримуються в URL XML. У URL підтримуються лише протоколи HTTP або HTTP. |
|
Ім’я користувача XML |
За замовчуванням: пусто |
XML ім'я користувача сервісу для цілей автентифікації. Ви також можете налаштувати цей параметр у файлі конфігурації телефону XML (cfg.XML), ввівши рядок у такому форматі: |
|
Пароль XML |
За замовчуванням: пусто |
XML пароль для вказаного імені користувача XML. Пароль, який ви ввели у цьому полі, відображається у конфігураційному файлі (cfg.XML) так: |
|
Cisco XML Увімкнути EXE |
За замовчуванням: No (Ні) Варіанти: "Так, "Ні" |
Визначає, чи потрібна автентифікація для доступу до сервера застосунків 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 |
Встановіть параметр розширення на Disabled , щоб вимкнути розширення. Якщо функція Direct PLK Configuration вимкнена, потрібно вимкнути розширення, щоб додати розширену функцію до клавіші рядка. Якщо функція увімкнена, можна пропустити цей крок. Детальніше дивіться у розділі Увімкнути конфігурацію Direct PLK. |
| 5 |
У параметрі "Розширена функція" введіть рядок у вказаному нижче форматі. fnc=XML; url=<xml_app_path>; nme=<app_name>
де
Приклад Цей параметр також можна налаштувати у файлі конфігурації (cfg.XML). Введіть рядок у такому форматі:
n – це внутрішній номер. |
| 6 |
Натисніть «Зберегти всі зміни». |
Макрозмінні, що підтримуються у URL XML
Ви можете використовувати макрозмінні в URL XML. Підтримуються такі макрозмінні:
-
Ідентифікатор користувача — UID1, UID2 до UIDn
-
Відображення імені — DISPLAYNAME1, DISPLAYNAME2 до DISPLAYNAMEn
-
Auth ID—AUTHID1, AUTHID2 до AUTHIDn
-
Проксі — PROXY1, PROXY2 до PROXYn
-
MAC Адреса з малими шістнадцятками — MA
-
Назва продукту — PN
-
Серійний номер продукту — PSN
-
Серійний номер — SERIAL_NUMBER
| Макро-назва | Макроекспансія |
|---|---|
| $ | Форма $$ розширюється до одного символу $. |
| Від А до P | Замінено на параметри загального призначення GPP_A до GPP_P. |
| Від SA до SD | Замінено на параметри спеціального призначення від GPP_SA до GPP_SD. Ці параметри містять ключі або паролі, які використовуються під час підготовки. Вирази від $SA до $SD розпізнаються як аргументи додаткового кваліфікатора URL-адреси повторної синхронізації, --key. |
| 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 failed. |
|
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 | Ім'я, пов'язане з першим підключеним, дзвінком або вхідним дзвінком. |
| ВІДДАЛЕНИЙ НОМЕР |
Номер телефону першого підключеного, дзвінка або вхідного дзвінка. Якщо є кілька дзвінків, надаються дані, пов'язані з першим знайденим дзвінком. |
| DISPLAYNAMEn | Вміст параметра конфігурації імені відображення рядка N. |
| AUTHIDn | Вміст параметра конфігурації ідентифікатора автентифікації Line N. |
