- Головна
- /
- Стаття
Дякуємо за відгук.
Конфігурація XML-додатків для телефонів 9800 і 8875 (BroadWorks)
У цій статті
Надіслати відгук?Ця довідкова стаття стосується настільних телефонів Cisco серії 9800 та відеотелефону Cisco 8875, зареєстрованих у Cisco BroadWorks. Прочитайте цю статтю, щоб дізнатися про підтримувані об'єкти XML, URI та кроки щодо налаштування служб XSI на веб-сторінці телефону.
Огляд
Інтерфейс служб XML (XSI) - це протокол, який дозволяє спілкуватися між додат ками та телефонною системою. Ви можете додавати власні служби XSI на телефон, використовуючи підтримувані X ML-об'єкти та URI.
Після підписки телефону на послуги користувачі можуть отримати доступ до всіх налаштованих служб на телефоні, перейшовши до Налаштування> Мере . Служби Cisco XML - це ім'я за замовчуванням. Також можна змінити назву. Щоб забезпечити зручний доступ для користувачів, ви можете додати програми XML до програмних клавіш або рядкових клавіш.
Підтримувані функції:
- Повідомлення (зображення та текст)
- Пейджінг
Підтримувані XML-об'єкти
-
CiscoIpPhoneMenu
-
CiscoIPPhoneТекст
-
CiscoIPPhoneВхід
-
CiscoIPТелефонний каталог
-
CiscoiPphoneЗображення
-
CiscoIPPhoneImageФайл
-
CiscoIPМеню піктограми телефону
-
CiscoIPPhoneIconФайлМеню
-
Статус цискоіпфона (крім 9811 та 9841)
-
Файл статусу CiscoIPPhoneStatus (крім 9811 та 9841)
-
CiscoIPPhoneВиконати
Підтримувані URI
-
Пристрій
-
Циферблат
-
РедактДайл
-
Ініт
-
Ключ
-
Відтворення (лише мелодії дзвінка)
-
Програмна клавіша
Докладніші відомості про конфігурацію служби XSI див. у розділі Примі тки щодо розробки програм Cisco Unified IP Phone Services.
Налаштування телефону для підключення до служби XML
| 1 |
Перейдіть на веб-сторінку адміністрування телефону. |
| 2 |
Виберіть «». |
| 3 |
У розділі Служба XML налаштуйте параметри Ім 'я служби програми XML та URL-адреси служби додатків XML, як визначено в Параметри для служб 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), ввівши рядок в такому форматі: У URL-адресах XML підтримуються макрозмінні. Допустимі макрозмінні див. у розділі Змінні макросів, які підтримуються в URL-адресах XML. У 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 до PSK 16 у такому форматі: fnc=xml;url=<xml_app_path>;nme=<app_name>
де
Приклад
Ви також можете налаштувати цей параметр у файлі конфігурації (cfg.xml). Введіть рядок у такому форматі:
де n - число програмної клавіші. |
| 5 |
Натисніть «Зберегти всі зміни». |
Додавання програми XML до ключа рядка
Додайте часто використовувані програми до рядкових ключів, щоб користувачі могли легко отримати доступ до служб.
Перш ніж почати
Служба додатків XML була належним чином налаштована.
| 1 |
Перейдіть на веб-сторінку адміністрування телефону. |
| 2 |
Виберіть «». |
| 3 |
Виберіть клавішу рядка. |
| 4 |
Встановіть параметр Extension в значення Disabled, щоб відключити розширення. Якщо функція Direct PLK Configuration вимкнена, необхідно вимкнути розширення, щоб додати розширену функцію до клавіші рядка. Якщо функція включена, ви можете пропустити цей крок. Докладніші відомості див. у статті Уві мкнути пряму конфігурацію PLK. |
| 5 |
У параме трі Extended Func tion введіть рядок в такому форматі: fnc=xml;url=<xml_app_path>;nme=<app_name>
де
Приклад
Ви також можете налаштувати цей параметр у файлі конфігурації (cfg.xml). Введіть рядок у такому форматі:
де n - додаткове число. |
| 6 |
Натисніть «Зберегти всі зміни». |
Макрозмінні, що підтримуються в URL-адресах XML
Ви можете використовувати макрозмінні в URL-адресах XML. Підтримуються наступні макрозмінні:
-
Ідентифікатор користувача—UID1, UID2 до UIDn
-
Відображуване ім'я—Відображувана ім'я1, DISPLAYNAME2 до DisplayNamen
-
Ідентифікатор авторизації — AUTHID1, AUTHID2 до AuthIDN
-
Прокси—прокси1, ПРОКСИ2 до проксіН
-
MAC-адреса з використанням шістнадцяткових цифр з малими літерами — MA
-
Назва товару—PN
-
Номер серії продукту — PSN
-
Серійний номер — серійний номер
| Ім'я макросу | Макророзширення |
|---|---|
| $ | Форма $$ розширюється до одного символу $. |
| Від А до Р | Замінено параметрами загального призначення GPP_A через GPP_P. |
| SA через SD | Замінено параметрами спеціального призначення GPP_SA через GPP_SD. Ці параметри містять
ключі або паролі, які використовуються при забезпеченні. Від $SA до $SD розпізнаються як аргументи необов'язкового кваліфікатора URL-адре си resync, --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 |
Секунди з моменту втрати реєстрації на SIP-сервері Line 2. |
|
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 |
Номер телефону першого підключеного, дзвінка або вхідного дзвінка. Якщо є кілька дзвінків, надаються дані, пов'язані з першим знайденим дзвінком. |
| Назва дисплея | Вміст параметра конфігурації Line N Display Name. |
| Авторизація IDN | Вміст параметра конфігурації ідентифікатора авторизації рядка N. |
