Prezentare generală

XML Services Interface (XSI) este un protocol care permite comunicarea între aplicații și sistemul telefonic. Puteți adăuga propriile servicii XSI la telefon utilizând obiectele XML și URI-urile acceptate.

După abonarea telefonului la servicii, utilizatorii pot accesa toate serviciile configurate pe telefon navigând la Setări > Rețea și servicii >Servicii XML Cisco. Cisco XML services este numele implicit. De asemenea, puteți modifica numele. Pentru a oferi un acces facil utilizatorilor, puteți adăuga aplicațiile XML la tastele soft sau tastele de linie.

Caracteristicile acceptate sunt:

  • Mesaje (imagini și text)
  • Paginare

Obiecte XML acceptate

  • CiscoIPPhoneMenu

  • CiscoIPPhoneText

  • CiscoIPPhoneInput

  • CiscoIPPhoneDirectory

  • CiscoIPPhoneImage

  • CiscoIPPhoneImageFile

  • CiscoIPPhoneIconMenu

  • CiscoIPPhoneIconFileMenu

  • CiscoIPPhoneStatus (cu excepția 9841)

  • CiscoIPPhoneStatusFile (cu excepția 9841)

  • CiscoIPPhoneExecute

URI-uri acceptate

  • Dispozitiv

  • Cadran

  • EditDail

  • Init

  • Cheie

  • Redare (numai tonuri de apel)

  • Cheie soft

Pentru mai multe detalii despre configurația serviciului XSI, consultați Cisco Unified IP Phone Services Application Development Notes.

Configurarea unui telefon pentru conectarea la un serviciu XML

1

Accesați pagina web de administrare a telefonului.

2

Selectați Voce > Telefon.

3

În secțiunea XML Service , configurați XML Application Service Name și XML Application Service URL parameters, așa cum sunt definiți în Parametri pentru servicii XML.

4

(Opțional) Pentru a adăuga autentificarea pentru accesarea serviciului de aplicații, configurați aceste câmpuri: XML Nume utilizator, XML Parolă, CISCO XML EXE Enable și CISCO XML EXE Auth Mode.

5

Faceți clic pe Salvare toate modificările.

Parametrii pentru serviciile XML

Următorul tabel definește funcția și utilizarea parametrilor aplicației XML în secțiunea XML Service din fila Voce > telefon din interfața Web a telefonului. De asemenea, definește sintaxa șirului care este adăugat în fișierul de configurare a telefonului (cfg.xml) cu codul XML pentru configurarea unui parametru.

Tabelul 1. Parametrii pentru serviciile XML

Parametru

Valori implicite și opțiuni

Descriere

XML Nume serviciu aplicație

Valoarea prestabilită: necompletată

Numele cererii XML. Numele se afișează pe telefon ca opțiune de aplicație web.

De asemenea, puteți configura acest parametru în fișierul XML de configurare a telefonului (cfg.xml), introducând un șir în acest format:

<XML_Application_Service_Name ua="na">XML APP Nume</XML_Application_Service_Name>

XML URL serviciu aplicație

Valoarea prestabilită: necompletată

URL-ul unde se află aplicația XML.

De asemenea, puteți configura acest parametru în fișierul XML de configurare a telefonului (cfg.xml), introducând un șir în acest format:

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

Variabilele macrocomenzilor sunt acceptate în adresele URL XML. Pentru variabilele de macrocomenzi valide, consultați Variabilele macrocomenzilor acceptate în adresele URL XML.

Numai protocoalele HTTP sau HTTP sunt acceptate în URL.

XML nume utilizator

Valoarea prestabilită: necompletată

XML numele de utilizator al serviciului în scopuri de autentificare.

De asemenea, puteți configura acest parametru în fișierul XML de configurare a telefonului (cfg.xml), introducând un șir în acest format:

<XML_User_Name ua="na">nume utilizator</XML_User_Name>

Parolă XML

Valoarea prestabilită: necompletată

XML parola de serviciu pentru numele de utilizator XML specificat.

Parola introdusă în acest câmp apare în fișierul de configurare (cfg.xml) după cum urmează:

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

CISCO XML EXE Enable

Implicit: nu

Opțiuni: Da, Nu

Specifică dacă este necesară autentificarea pentru a accesa serverul de aplicații XML.

De asemenea, puteți configura acest parametru în fișierul XML de configurare a telefonului (cfg.xml), introducând un șir în acest format:

<CISCO_XML_EXE_Enable ua="na">Da</CISCO_XML_EXE_Enable>

Modul de autentificare Cisco XML EXE

Implicit: Local Credential

Opțiuni: Acreditarea locală, de încredere, Acreditarea la distanță

Specifică modul de autentificare pentru Cisco XML EXE.

  • De încredere — Nu se efectuează autentificarea, indiferent de acreditările locale.

  • Acreditarea locală — autentificarea se bazează pe autentificarea rezumat utilizând acreditarea locală, dacă este setată. Dacă acreditarea locală nu este setată, atunci nu se efectuează autentificarea.

  • Acreditarea la distanță— Autentificarea se bazează pe autentificarea rezumat utilizând acreditarea la distanță, așa cum este setată în aplicația XML de pe pagina web (pentru a accesa un server de aplicații XML).

De asemenea, puteți configura acest parametru în fișierul XML de configurare a telefonului (cfg.xml), introducând un șir în acest format:

<CISCO_XML_EXE_Auth_Mode ua="na">Local Credential</CISCO_XML_EXE_Auth_Mode>

Adăugarea unei aplicații XML la o cheie soft

Adăugați aplicațiile utilizate frecvent la tastele soft pentru ca utilizatorii să poată accesa cu ușurință serviciul.

nainte de a începe

Serviciul de aplicații XML a fost configurat corect.

1

Accesați pagina web de administrare a telefonului.

2

Selectați Voce > Telefon.

3

În secțiunea Taste soft programabile, setați tasta soft programabilă Enable la Da.

De asemenea, puteți configura acest parametru în fișierul de configurare (cfg.xml). Introduceți un șir în acest format:

<Programmable_Softkey_Enable ua="na">Da</Programmable_Softkey_Enable>
4

În secțiunea Taste soft programabile, editați câmpurile disponibile de la PSK1 la PSK16 în acest format:

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

unde url este linkul unde este stocată aplicația XML; NME este numele afișat al aplicației pe ecranul telefonului.

Exemplu fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu

De asemenea, puteți configura acest parametru în fișierul de configurare (cfg.xml). Introduceți un șir în acest format:

<PSK_n ua="na">fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu<cod de configurare></PSK_n>

unde n este numărul cheii soft.

5

Faceți clic pe Salvare toate modificările.

Adăugarea unei aplicații XML la o tastă de linie

Adăugați aplicațiile utilizate frecvent la tastele de linie pentru ca utilizatorii să poată accesa cu ușurință serviciile.

nainte de a începe

Serviciul de aplicații XML a fost configurat corect.

1

Accesați pagina web de administrare a telefonului.

2

Selectați Voce > Telefon.

3

Selectați o cheie de linie.

4

Setați parametrul extensiei la Dezactivat pentru a dezactiva extensia.

În cazul în care caracteristica Direct PLK Configuration este dezactivată, trebuie să dezactivați extensia pentru a adăuga o funcție extinsă la tasta de linie. În cazul în care caracteristica este activată, puteți omite peste acest pas. Pentru detalii, consultați Activarea configurării PLK directe.
5

În parametrul Funcție extinsă, introduceți un șir în acest format:

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

unde url este linkul unde este stocată aplicația XML; NME este numele afișat al aplicației pe ecranul telefonului.

Exemplu fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu

De asemenea, puteți configura acest parametru în fișierul de configurare (cfg.xml). Introduceți un șir în acest format:

<Extended_Function_n_ ua="na">fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu<configuration code></Extended_Function_n_>

unde n este numărul extensiei.

6

Faceți clic pe Salvare toate modificările.

Variabilele macrocomenzilor acceptate în adresele URL XML

Puteți utiliza variabile macro în adresele URL XML. Sunt acceptate următoarele variabile de macrocomenzi:

  • ID utilizator - UID1, UID2 până la UIDn

  • Nume afișat—DISPLAYNAME1, DISPLAYNAME2 la DISPLAYNAMEn

  • ID autentificare—AUTHID1, AUTHID2 la AUTHIDn

  • Proxy - PROXY1, PROXY2 până la PROXYn

  • MAC Adresă utilizând cifre hexazecimale minuscule – MA

  • Nume produs—PN

  • Număr serie produs — PSN

  • Număr de serie—SERIAL_NUMBER

Tabelul 2. Macrocomenzi acceptate
Nume macrocomandăExtinderea macrocomenzilor
$Formularul $$ se extinde la un singur caracter $.
A - PÎnlocuit cu parametri de uz general GPP_A prin GPP_P.
SA - SDÎnlocuit cu parametrii de uz special GPP_SA - GPP_SD. Acești parametri stochează cheile sau parolele utilizate la asigurarea accesului.
$SA - $SD sunt recunoscute ca argumente pentru calificatorul URL opțional de sincronizare,--key.
MAMAC adresă utilizând cifre hexazecimale minuscule (000e08aabbcc).
MAUMAC adresă utilizând cifre hexazecimale majuscule (000E08AABBCC).
MACMAC adresă utilizând cifre hexazecimale minuscule cu două puncte pentru a separa perechile de cifre hexazecimale (00:0e:08:aa:bb:cc).
PNNumele produsului; de exemplu, telefon video 8875, telefon de birou 9851.
PSNNumărul seriei produsului; De exemplu, 8875, 9841, 9861
SNNumăr de serie șir; de exemplu, 88012BA01234.
CCERTSSL starea certificatului client, instalat sau neinstalat.
IPIP adresa telefonului în subrețeaua locală; de exemplu, 192.168.1.100.
EXTIPIP externă a telefonului, așa cum se vede pe internet; de exemplu, 66.43.16.52.

SWVER

Șirul versiunii software-ului. De exemplu,

PHONEOS.3-2-1-0104-37

HWVER

Șirul versiunii hardware-ului. De exemplu, 2.0.1

PRVST

Starea asigurării accesului (un șir numeric):

-1 = solicitare de resincronizare explicită

0 = resincronizare la pornire

1 = resincronizare periodică

2 = resincronizare eșuată; reîncercare

UPGST

Starea upgrade-ului (un șir numeric):

1 = prima încercare de upgrade

2 = upgrade eșuat; reîncercare

UPGERR

Mesajul rezultat (ERR) al încercării de upgrade anterioare; de exemplu, http_get a eșuat.

PRVTMR

Numărul de secunde de la ultima încercare de resincronizare.

UPGTMR

Numărul de secunde de la ultima încercare de upgrade.

REGTMR1

Numărul de secunde de când linia 1 a pierdut înregistrarea la serverul SIP.

REGTMR2

Numărul de secunde de când linia 2 a pierdut înregistrarea la serverul SIP.

UPGCOND

Numele macrocomenzii moștenite.

SCHEME

Schema de acces la fișiere, TFTP, HTTP sau HTTPS, după cum s-a obținut după analiza URL-ului de resincronizare sau de upgrade.

SERV

Numele gazdei serverului destinație al solicitării, obținut după analiza URL-ului de resincronizare sau de upgrade.

SERVIP

Adresa IP a serverului destinație al solicitării, obținută după analiza URL-ului de resincronizare sau de upgrade, eventual după căutarea DNS.

PORT

Portul UDP/TCP destinație al solicitării, obținut după analiza URL-ului de resincronizare sau de upgrade.

PATH

Calea fișierului destinație al solicitării, obținută după analiza URL-ului de resincronizare sau de upgrade.

ERR

Mesajul rezultat al încercării de resincronizare sau de upgrade. Util numai la generarea mesajelor syslog rezultate. Valoarea este păstrată în variabila UPGERR în cazul încercărilor de upgrade.

UIDn

Conținutul parametrului de configurare ID utilizator pentru linia n.

ISCUST

Dacă unitatea este personalizată, valoare = 1, altfel 0.

Starea particularizării poate fi vizualizată pe pagina Informații interfață utilizator web.

INCOMINGNAMENume asociat cu primul apel conectat, care sună sau de intrare.
NUMĂR LA DISTANȚĂ

Numărul de telefon al primului apel conectat, care sună sau de intrare. Dacă există mai multe apeluri, sunt furnizate datele asociate cu primul apel găsit.

DISPLAYNAMEnConținutul parametrului de configurare Nume afișat linie N.
AUTHIDnConținutul parametrului de configurare ID autentificare linie N.