Prezentare generală

XML Services Interface (XSI) este un protocol care permite comunicarea între aplicații și sistemul telefonic. Puteți să adăugați 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 Cisco XML. Serviciile Cisco XML sunt numele implicit. De asemenea, puteți schimba numele. Pentru a oferi un acces facil utilizatorilor, puteți adăuga aplicațiile XML la tastele soft sau la tastele de linie.

Caracteristicile acceptate sunt:

  • Mesaje (imagini și text)
  • Difuzare

Obiecte XML acceptate

  • Meniu CiscoIPPhone

  • Text CiscoIPPhoneText

  • CiscoIPPhoneInput

  • Directorul CiscoIPPhone

  • Imagine CiscoIPPhone

  • Fișier imagine CiscoIPPhone

  • Meniul CiscoIPPhoneIcon

  • CiscoIPPhoneIconFileMenu

  • Stare CiscoIPPhone (cu excepția 9841)

  • Fișier de stare CiscoIPPhone (cu excepția 9841)

  • Execută CiscoIPPhone

URI-uri acceptate

  • Dispozitiv

  • Apelare

  • EditeazăDail

  • Inițializare

  • Cheie

  • Redați (numai tonuri de apel)

  • Tastă soft

Pentru mai multe detalii despre configurarea serviciului XSI, consultați Note de dezvoltare a aplicației pentru serviciile de telefonie Cisco Unified IP.

Configurați un telefon pentru conectarea la un serviciu XML

1

Accesați pagina web pentru administrarea telefonului.

2

Selectați Voce > Telefon.

3

În secțiunea Serviciu XML, configurați parametrii Nume serviciu aplicație XML și URL-ul serviciului aplicație XML așa cum sunt definiți în Parametri pentru serviciile XML.

4

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

5

Faceți clic pe Salvați toate modificările.

Parametri pentru serviciile XML

Următorul tabel definește funcția și utilizarea parametrilor aplicației XML în secțiunea Serviciu XML 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 a configura un parametru.

Tabelul 1. Parametri pentru serviciile XML

Parametru

Setări implicite și opțiuni

Descriere

Nume serviciu aplicație XML

Implicită: Gol

Numele aplicației 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) prin introducerea unui șir în acest format:

<XML_Application_Service_Name ua="na">Nume APLICAȚIE XML</XML_Application_Service_Name>

URL serviciu aplicație XML

Implicită: Gol

URL-ul în care se află aplicația XML.

De asemenea, puteți configura acest parametru în fișierul XML de configurare a telefonului (cfg. xml) prin introducerea unui șir în acest format:

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

Variabilele de macrocomenzi sunt acceptate în URL-urile XML. Pentru variabilele de macrocomenzi valide, consultați Variabile de macrocomenzi acceptate în URL-urile XML.

Numai protocoalele HTTP sau HTTP sunt acceptate în URL.

Nume utilizator XML

Implicită: Gol

Nume de utilizator serviciu XML în scopuri de autentificare.

De asemenea, puteți configura acest parametru în fișierul XML de configurare a telefonului (cfg. xml) prin introducerea unui șir în acest format:

<XML_User_Name ua="na">Nume de utilizator</XML_User_Name>

Parolă XML

Implicită: Gol

Parola serviciului XML 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> -->

Activați CISCO XML EXE

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) prin introducerea unui șir în acest format:

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

Modul de autentificare CISCO XML EXE

Implicită: Acreditări locale

Opțiuni: De încredere, date de autentificare locale, date de autentificare de la distanță

Specifică modul de autentificare pentru Cisco XML EXE.

  • De încredere – nu se efectuează nicio autentificare, indiferent de acreditările locale.

  • Acreditări locale — Autentificarea se bazează pe autentificarea cea mai simplă, utilizând acreditările locale, dacă este setată. Dacă acreditarea locală nu este setată, nu se efectuează autentificarea.

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

De asemenea, puteți configura acest parametru în fișierul XML de configurare a telefonului (cfg. xml) prin introducerea unui șir în acest format:

<CISCO_XML_EXE_Auth_Mode ua="na">Acreditări locale</CISCO_XML_EXE_Auth_Mode>

Adăugați o aplicație XML la o tastă soft

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

Înainte de a începe

Serviciul aplicației XML a fost configurat corect.

1

Accesați pagina web pentru administrarea telefonului.

2

Selectați Voce > Telefon.

3

În secțiunea Taste programabile, setați Activare tastă programabilă 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 programabile, editați câmpurile disponibile din PSK1 în PSK16 în acest format:

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

unde url este linkul la care 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=Meniu<cod de configurare></PSK_n>

unde n este numărul tastei soft.

5

Faceți clic pe Salvați toate modificările.

Adăugați o aplicație XML la o tastă de linie

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

Înainte de a începe

Serviciul aplicației XML a fost configurat corect.

1

Accesați pagina web pentru administrarea telefonului.

2

Selectați Voce > Telefon.

3

Selectați o tastă de linie.

4

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

Dacă caracteristica Configurare directă PLK este dezactivată, trebuie să dezactivați extensia pentru a adăuga o funcție extinsă la tasta de linie. Dacă funcția este activată, puteți omite acest pas. Pentru detalii, consultați Activați configurația Direct PLK.
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 la care 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=Meniu<cod de configurare></Extended_Function_n_>

unde n este numărul extensiei.

6

Faceți clic pe Salvați toate modificările.

Variabile de macrocomenzi acceptate în URL-urile XML

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

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

  • Nume afișat — DISPLAYNAME1, DISPLAYNAME2 în DISPLAYNAMEn

  • ID de autentificare — AUTHID1, AUTHID2 în AUTHIDn

  • Proxy — PROXY1, PROXY2 către PROXYn

  • Adresă MAC utilizând cifre hexazecimale mici—MA

  • Denumirea produsului—PN

  • Număr serie produs—PSN

  • Număr de serie — NUMĂR_SERIE

Tabelul 2. Macrocomenzi acceptate
Nume macrocomandăExtindere macrocomenzi
$Formularul $$ se extinde la un singur caracter $.
A până la PÎnlocuit cu parametri de uz general GPP_A prin GPP_P.
SA prin SDÎnlocuit cu parametri de scop special GPP_SA prin GPP_SD. Acești parametri păstrează cheile sau parolele utilizate în configurare.
$SA până la $SD sunt recunoscute ca argumente pentru specificatorul opţional de resincronizare, --key.
Ministerul SănătățiiAdresă MAC utilizând cifre hexazecimale mici (000e08aabbcc).
MAUAdresa MAC utilizând cifre hexazecimale mari (000E08AABBCC).
macAdresa MAC utilizând cifre hexazecimale mici 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.
Partidul Național SocialistNumăr serie produs; de exemplu, 8875, 9841, 9861
snȘir Număr de serie; de exemplu, 88012BA01234.
ccerețiStare certificat client SSL, instalat sau nu.
IPAdresa IP a telefonului din subrețeaua sa locală; de exemplu, 192.168.1.100.
DetașațiIP-ul extern al telefonului, așa cum este văzut pe internet; de exemplu, 66.43.16.52.

swver (dezambiguizare)

Șirul versiunii software. De exemplu,

phoneos.3-2-1-0104-37

hwver

Șir versiune hardware. De exemplu, 2.0.1

Prvst (dezambiguizare)

Starea setării (un șir numeric):

-1 = solicitare explicită de resincronizare

0 = resincronizare de alimentare

1 = resincronizare periodică

2 = resincronizarea a eșuat, încercați din nou

Răscruce

Stare upgrade (un șir numeric):

1 = prima încercare de upgrade

2 = upgrade nereușit, încercați din nou

upgerr

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

prvtmr-ului

Secunde de la ultima încercare de resincronizare.

upgtmr

Secunde de la ultima încercare de upgrade.

regtmr1

Secunde de la linia 1 a pierdut înscrierea la serverul SIP.

regtmr2

Secunde de la linia 2 a pierdut înscrierea la serverul SIP.

upgcond

Denumirea anterioară a macrocomenzilor.

schemă

Schemă de acces la fișiere, una dintre opțiunile TFTP, HTTP sau HTTPS, astfel cum a fost obținută după analizarea URL-ului de resincronizare sau upgrade.

serv

Solicitați numele gazdei serverului țintă, așa cum a fost obținut după analizarea URL-ului de resincronizare sau upgrade.

servitoare

Solicitați adresa IP a serverului țintă, așa cum a fost obținută după analizarea URL-ului de resincronizare sau upgrade, posibil în urma căutării DNS.

port

Solicitați portul UDP/TCP destinație, așa cum a fost obținut după analizarea URL-ului de resincronizare sau upgrade.

cale

Solicitați calea fișierului țintă, așa cum a fost obținută după analizarea URL-ului de resincronizare sau upgrade.

eroare

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

Nume utilizator

Conținutul parametrului de configurare Line n UserID.

iscuș

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

Starea personalizării poate fi vizualizată pe pagina de informații a interfeței web.

incominnameNumele asociat cu primul apel conectat, care sună sau primit.
Nume la distanță

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

Nume afișatConținutul parametrului de configurare a numelui afișat al liniei N.
AutentificațiConținutul parametrului de configurare a ID-ului de autentificare a liniei N.