- Головна
- /
- Стаття
XML конфігурація додатків для телефонів на BroadWorks
Ця стаття довідки стосується Cisco Desk Phone серії 9800 і 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
-
Пристрій
-
Циферблат
-
Редагувати Дейл
-
Ініціювати
-
Ключ
-
Відтворення (лише мелодії дзвінка)
-
Програмна клавіша
Для отримання більш детальної інформації про конфігурацію служби XSI дивітьсяПримітки щодо розробки додатків для уніфікованих IP-телефонів Cisco Unified IP Phone.
Налаштування телефону для підключення до служби 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 для налаштування параметра.
Параметр |
За замовчуванням і параметри |
Опис |
---|---|---|
Ім'я служби XML додатків |
За замовчуванням: пусто |
Ім'я програми XML. Назва відображається на телефоні як вибір веб-додатку. Ви також можете налаштувати цей параметр у файлі конфігурації телефону XML (cfg.xml), ввівши рядок у такому форматі:
|
URL-адреса служби додатків XML |
За замовчуванням: пусто |
URL-адреса, за якою розташовано програму XML. Ви також можете налаштувати цей параметр у файлі конфігурації телефону XML (cfg.xml), ввівши рядок у такому форматі:
Макрозмінні підтримуються в URL-адресах XML. Допустимі макрозмінні наведено в статті Макрозмінні, які підтримуються в URL-адресах XML. У URL-адресі підтримуються лише протоколи HTTP або HTTPs. |
Ім’я користувача 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 було правильно налаштовано.
1 |
Відкрийте веб-сторінку адміністрування телефона. |
2 |
Виберіть . |
3 |
У розділі «Програмовані програмні клавіші» встановіть для параметра «Увімкнути програмовану програмну клавішу » значення «Так ». Ви також можете налаштувати цей параметр у файлі конфігурації (cfg.xml). Введіть рядок у такому форматі:
|
4 |
У розділі «Програмовані програмні клавіші » відредагуйте доступні поля від PSK1 до PSK16 у такому форматі: fnc=xml;url=<xml_app_path>; nme=<app_name>
де
Приклад Ви також можете налаштувати цей параметр у файлі конфігурації (cfg.xml). Введіть рядок у такому форматі:
де n – номер програмної клавіші. |
5 |
Натисніть Зберегти всі зміни. |
Додавання програми XML до лінійного ключа
Додайте часто використовувані програми до лінійних ключів, щоб користувачі могли легко отримати доступ до служб.
Перш ніж почати
Службу додатків XML було правильно налаштовано.
1 |
Відкрийте веб-сторінку адміністрування телефона. |
2 |
Виберіть . |
3 |
Виберіть клавішу лінії. |
4 |
Встановіть для параметра Extension значення 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. Статус налаштування можна переглянути на сторінці Інформація про веб-інтерфейс. |
ВХІДНЕ ІМ'Я | Ім'я, пов'язане з першим підключенням, дзвінком або вхідним викликом. |
ДИСТАНЦІЙНИЙ НОМЕР |
Номер телефону першого підключення, дзвінка або вхідного дзвінка. Якщо дзвінків кілька, надаються дані, пов'язані з першим знайденим дзвінком. |
DISPLAYNAMEn | Вміст параметра конфігурації Line N Display Name. |
АУТХІДн | Вміст параметра конфігурації ідентифікатора аутентифікації Line N. |