Огляд

XML Services Interface (XSI) — це протокол, який забезпечує зв'язок між програмами та телефонною системою. Ви можете додавати власні служби XSI на свій телефон за допомогою підтримуваних об'єктів XML та URI.

Після підписки телефону на послуги користувачі можуть отримати доступ до всіх налаштованих послуг на телефоні, перейшовши в розділ Налаштування > Мережа та сервіс> Cisco XML служби. Служби 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 для налаштування параметра.

Таблиця 1. Параметри для служб XML

Параметр

За замовчуванням і параметри

Опис

Ім'я служби XML додатків

За замовчуванням: пусто

Ім'я програми XML. Назва відображається на телефоні як вибір веб-додатку.

Ви також можете налаштувати цей параметр у файлі конфігурації телефону XML (cfg.xml), ввівши рядок у такому форматі:

<XML_Application_Service_Name ua="na">XML Назва додатка</XML_Application_Service_Name>

URL-адреса служби додатків XML

За замовчуванням: пусто

URL-адреса, за якою розташовано програму XML.

Ви також можете налаштувати цей параметр у файлі конфігурації телефону XML (cfg.xml), ввівши рядок у такому форматі:

<XML_Application_Service_URL ua="na">https://server.com/path/app.xml</XML_Application_Service_URL>

Макрозмінні підтримуються в URL-адресах XML. Допустимі макрозмінні наведено в статті Макрозмінні, які підтримуються в URL-адресах XML.

У URL-адресі підтримуються лише протоколи HTTP або HTTPs.

Ім’я користувача XML

За замовчуванням: пусто

Ім'я користувача служби XML для цілей автентифікації.

Ви також можете налаштувати цей параметр у файлі конфігурації телефону XML (cfg.xml), ввівши рядок у такому форматі:

<XML_User_Name ua="na">ім'я користувача</XML_User_Name>

Пароль XML

За замовчуванням: пусто

Службовий пароль XML для вказаного імені користувача XML.

Пароль, який ви ввели в це поле, відображається у файлі конфігурації (cfg.xml) наступним чином:

<!-- <XML_Password ua="na">*************</XML_Password> -->

Включення CISCO XML EXE

За замовчуванням: No (Ні)

Варіанти: "Так, "Ні"

Визначає, чи потрібна автентифікація для доступу до сервера додатків XML.

Ви також можете налаштувати цей параметр у файлі конфігурації телефону XML (cfg.xml), ввівши рядок у такому форматі:

<CISCO_XML_EXE_Enable ua="na">Так</CISCO_XML_EXE_Enable>

Режим автентифікації CISCO XML EXE

Типове значення: локальні облікові дані

Параметри: Довірений, Локальні облікові дані, Віддалені облікові дані

Визначає режим автентифікації для Cisco XML EXE.

  • Надійний: автентифікація не виконується, незалежно від локальних облікових даних.

  • Локальні облікові дані — автентифікація базується на автентифікації дайджесту з використанням локальних облікових даних, якщо вони встановлені. Якщо локальні облікові дані не встановлено, автентифікація не виконується.

  • Віддалені облікові дані — автентифікація базується на автентифікації дайджесту з використанням віддалених облікових даних, установлених у програмі XML на веб-сторінці (для доступу до сервера програм XML).

Ви також можете налаштувати цей параметр у файлі конфігурації телефону XML (cfg.xml), ввівши рядок у такому форматі:

<CISCO_XML_EXE_Auth_Mode ua="na">Локальні облікові дані</CISCO_XML_EXE_Auth_Mode>

Додавання програми XML до програмної клавіші

Додавайте часто використовувані програми до програмних клавіш, щоб користувачі могли легко отримати доступ до сервісу.

Перш ніж почати

Службу додатків XML було правильно налаштовано.

1

Відкрийте веб-сторінку адміністрування телефона.

2

Виберіть "Голосовий зв’язок" > "Телефон".

3

У розділі «Програмовані програмні клавіші» встановіть для параметра «Увімкнути програмовану програмну клавішу » значення «Так ».

Ви також можете налаштувати цей параметр у файлі конфігурації (cfg.xml). Введіть рядок у такому форматі:

<Programmable_Softkey_Enable ua="na">Так</Programmable_Softkey_Enable>
4

У розділі «Програмовані програмні клавіші » відредагуйте доступні поля від PSK1 до PSK16 у такому форматі:

fnc=xml;url=<xml_app_path>; nme=<app_name>

де url – посилання, де зберігається додаток XML;NME – це відображуване ім'я програми на екрані телефону.

Приклад fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu

Ви також можете налаштувати цей параметр у файлі конфігурації (cfg.xml). Введіть рядок у такому форматі:

<PSK_n ua="na">fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu<код конфігурації></PSK_n>

де 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>

де url – посилання, де зберігається додаток XML;NME – це відображуване ім'я програми на екрані телефону.

Приклад: fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu

Ви також можете налаштувати цей параметр у файлі конфігурації (cfg.xml). Введіть рядок у такому форматі:

<Extended_Function_n_ ua="na">fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu<код конфігурації></Extended_Function_n_>

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

Таблиця 2. Підтримувані макроси
Ім'я макросуРозширення макросу
$Форма $$ розгортається до одного символу $.
Від А до PЗамінюються параметрами загального призначення GPP_A по GPP_P.
Від SA до SDЗамінено на параметри спеціального призначення від GPP_SA до GPP_SD. Ці параметри містять ключі або паролі, які використовуються під час підготовки.
Вирази від $SA до $SD розпізнаються як аргументи додаткового кваліфікатора URL-адреси повторної синхронізації, --key.
MAMAC-адреса з використанням шістнадцяткових цифр нижнього регістру (000e08aabbcc).
MAUMAC з використанням шістнадцяткових цифр верхнього регістру (000E08AABBCC).
MACMAC з використанням шістнадцяткових цифр нижнього регістру з двокрапкою для розділення шістнадцяткових пар цифр (00:0e:08:aa:bb:cc).
PNнайменування товару; наприклад, Відеотелефон 8875, Настільний телефон 9851.
PSNномер серії виробу; Наприклад, 8875, 9841, 9861
SNрядок із серійним номером; наприклад, 88012BA01234.
CCERTСтатус сертифіката клієнта SSL, встановлено чи не встановлено.
IPIP адресу телефону в його локальній підмережі, наприклад 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.