Огляд

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

Після передплати телефону на послуги користувачі можуть отримати доступ до всіх налаштованих служб на телефоні, перейшовши до меню Налаштування > Мережа і служби > Служби Cisco XML. Служби Cisco XML є ім’ям за замовчуванням. Також можна змінити ім’я. Щоб забезпечити легкий доступ для користувачів, ви можете додати програми XML до програмних клавіш або клавіш лінії.

Підтримувані функції:

  • Повідомлення (зображення й текст)
  • Пейджинг

Підтримувані об’єкти XML

  • МенюIPPhoneCisco

  • ТекстIPPhoneCisco

  • CiscoIPPhoneInput

  • CiscoIPPhoneDirectory

  • CiscoIPPhoneImage

  • ФайлIPPhoneImageFile

  • МенюIPPhoneIconCisco

  • МенюФайлуIPPhoneIconCiscoIPP

  • СтанIPPhoneCisco (винятком 9841)

  • CiscoIPPhoneStatusFile (винятком 9841)

  • CiscoIPPhoneExecute

Підтримувані URI

  • Пристрій

  • Виклик

  • EditDail

  • Ініт

  • Ключ

  • Відтворити (тільки сигнали дзвінка)

  • Програмна клавіша

Додаткову інформацію про конфігурацію служби XSI див. в примітках до розробки програми для служб IP-телефонії Cisco Unified.

Налаштуйте телефон для підключення до служби 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-кодом для налаштування параметра.

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

Параметр

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

Опис

Ім’я служби застосунків XML

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

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

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

<XML_Application_Service_Name ua="na">Ім’я програми XML</XML_Application_Service_Name>

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

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

URL, де розташовано програму 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 або HTTP.

Ім’я користувача 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

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

Параметри: Так, ні

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

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

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

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

За замовчуванням: Локальні облікові дані

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

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

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

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

  • Віддалені облікові дані—автентифікація заснована на автентифікації дайджест-автентифікації з використанням віддалених облікових даних, установлених у застосунку 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=Меню<код конфігурації></PSK_n>

де n — номер програмної клавіші.

5.

Клацніть Зберегти всі зміни.

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

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

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

Службу застосунків XML налаштовано належним чином.

1.

Перейдіть на вебсторінку адміністрування телефонів.

2.

Виберіть Голос > Телефон.

3.

Виберіть клавішу лінії.

4.

Установіть параметр Додатковий номер на значення Вимкнуто, щоб вимкнути додатковий номер.

Якщо функцію безпосередньої конфігурації PLK вимкнено, потрібно вимкнути розширення, щоб додати розширену функцію до клавіші лінії. Якщо функцію ввімкнено, ви можете пропустити цей крок. Подробиці див. в розділі Увімкнути конфігурацію прямого 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=Меню<код конфігурації></Extended_Function_n_>

де n є додатковим номером.

6.

Клацніть Зберегти всі зміни.

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

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

  • Ідентифікатор користувача – UID1, UID2 до UIDn

  • Відображуване ім’я—DISPLAYNAME1, DISPLAYNAME2 до DISPLAYNAMEn

  • Ідентифікатор автентифікації – AUTHID1, AUTHID2 до AUTHIDn

  • Проксі-ПРОКСІ1, ПРОКСІ2 до ПРОКСІn

  • MAC-адреса з використанням шістнадцяткових цифр нижчого регістру — MA

  • Назва продукту — PN

  • Номер серії продуктів — PSN

  • Серійний номер — СЕРІЙНИЙ_НОМЕР

Таблиця 2. Підтримувані макроси
Ім’я макросуРозширення макросів
$Форма $$ розширюється до одного символу $.
Від A до PЗамінено параметрами загального призначення GPP_A через GPP_P.
SA через SDЗамінено параметрами спеціального призначення GPP_SA через GPP_SD. Ці параметри утримують ключі або паролі, що використовуються під час підготовки.
$SA через $SD визнаються як аргументи додаткового кваліфікатора повторної синхронізації URL, --key.
маMAC-адреса з використанням шістнадцяткових цифр із малим регістром (000e08aabbcc).
Число унікальних користувачів на місяцьMAC-адреса з шістнадцятковими цифрами (000E08AABBCC).
macMAC-адреса, яка використовує шістнадцяткові цифри з двокрапкою для розділення пар шістнадцяткових цифр (00:0e:08:aa:bb:cc).
pnНазва продукту; наприклад, відеотелефон 8875, настільний телефон 9851.
пснНомер серії продукту; наприклад, 8875, 9841, 9861
снРядок Серійного номера; наприклад, 88012BA01234.
ccertСтан сертифіката клієнта SSL, встановлено чи не встановлено.
IPIP-адреса телефону в його локальній підмережі; наприклад, 192.168.1.100.
extipЗовнішня IP-адреса телефону, як видно в інтернеті; наприклад, 66.43.16.52.

світер

Рядок версії програмного забезпечення. Наприклад:

фонеос.3-2-1-0104-37

HWVER

Рядок версії апаратного забезпечення. Наприклад, 2.0.1

првст

Стан підготовки (числовий рядок):

-1 = явний запит на повторну синхронізацію

0 = повторна синхронізація живлення

1 = періодична повторна синхронізація

2 = помилка повторної синхронізації, повторіть спробу

upgst

Стан оновлення версії (числовий рядок):

1 = перша спроба оновлення версії

2 = не вдалось оновити версію, повторити спробу

upgerr

Повідомлення результату (ERR) попередньої спроби оновлення версії, наприклад, не вдалося виконати http_get.

prvtmr

Секунди з моменту останньої повторної синхронізації.

upgtmr

Секунди з моменту останньої спроби оновлення версії.

regtmr1

Секунди після втрати реєстрації на сервері SIP.

regtmr2

Секунди після втрати реєстрації на сервері SIP.

upgcond

Застаріле ім’я макроса.

схема

Схема доступу до файлів, одна з TFTP, HTTP або HTTPS, як отримана після повторної синхронізації аналізу або оновлення URL.

серв

Запитайте ім’я хоста цільового сервера, як отримано після повторної синхронізації аналізу або оновлення URL.

servip

Запитуйте IP-адресу цільового сервера, отриману після повторної синхронізації аналізу або оновлення URL-адреси, можливо, після пошуку DNS.

порт

Запитайте цільовий порт UDP/TCP, як отримано після повторної синхронізації аналізу або оновлення URL-адреси.

шлях

Запитайте шлях до цільового файлу, як його отримано після повторної синхронізації аналізу або оновлення URL.

помилка

Повідомлення про повторну синхронізацію або спробу оновлення версії. Корисно лише для створення повідомлень системного журналу результатів. Значення зберігається в змінній UPGERR у разі спроб оновлення версії.

UID

Зміст параметра конфігурації ідентифікатора користувача лінії n.

іскюст

Якщо одиницю налаштовано, значення=1, в іншому випадку – 0.

Стан налаштування можна переглянути на сторінці інформації про вебінтерфейс.

вхідне ім’яІм’я, пов’язане з першим підключеним, дзвінком або вхідним викликом.
номер віддаленого

Номер телефону для першого з’єднання, дзвінка або вхідного виклику. Якщо є кілька викликів, надаються дані, пов’язані з першим знайденим викликом.

ВІДОБРАЖУВАНЕ ІМ’ЯЗміст параметра конфігурації відображуваного імені лінії N.
Ідентифікатор автентифікаціїЗміст параметра конфігурації ідентифікатора автентифікації лінії N.