În acest articol
dropdown icon
Prezentare generală
    Obiecte XML acceptate
    URI-uri acceptate
Configurarea unui telefon pentru a se conecta la un serviciu XML
Parametrii pentru serviciile XML
Adăugarea unei aplicații XML la o tastă softkey
Adăugarea unei aplicații XML la o cheie de linie
Variabile macro acceptate în URL-uri XML

Configurarea aplicațiilor XML pentru telefoanele 9800 și 8875 (BroadWorks)

list-menuÎn acest articol
list-menuFeedback?

Acest articol de ajutor se aplică pentru Cisco Desk Phone 9800 Series și Cisco Video Phone 8875 care sunt înregistrate la Cisco BroadWorks. Citiți acest articol pentru obiectele XML acceptate, URI-urile și pașii pentru configurarea serviciilor XSI pe pagina web a telefonului.

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 de pe telefon navigând la Setări > Rețea și serviciu > Servicii Cisco XML. Serviciile Cisco XML sunt numele implicit. De asemenea, puteți schimba numele. Pentru a oferi acces ușor 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

  • CiscoIPPhoneIntrare

  • CiscoIPPhoneDirector

  • CiscoIPPhoneImagine

  • CiscoIPPhoneImageFile

  • CiscoIPPhoneIconMenu

  • CiscoIPPhoneIconFileMenu

  • CiscoIPPhoneStatus (cu excepția 9811 și 9841)

  • CiscoIPPhoneStatusFile (cu excepția 9811 și 9841)

  • CiscoIPPhoneExecute

URI-uri acceptate

  • Dispozitiv

  • Cadran

  • EditDail

  • Init

  • Cheie

  • Redare (numai tonuri de apel)

  • Tasta softkey

Pentru mai multe detalii despre configurația serviciului XSI, consultați Note privind dezvoltarea aplicațiilor Cisco Unified IP Phone Services.

Configurarea unui telefon pentru a se conecta la un serviciu XML

1

Accesați pagina web de administrare a telefonului.

2

Selectaţi Vo ce > Telefon.

3

În secțiunea Serviciu XML, configurați parametrii Numele serviciului de aplicație XML și parametrii URL a serviciului de aplicație XML 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: Nume utilizator XML, Parolă XML, CISCO XML EXE Enable și CISCO XML EXE Auth Mode.

5

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

Parametrii pentru serviciile XML

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

Tabelul 1. Parametrii pentru serviciile XML

Parametru

Implicit și opțiuni

Descriere

Numele serviciului de aplicație XML

Implicit: gol

Numele aplicației XML. Numele se afișează pe telefon ca o alegere a aplicației 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 Name</XML_Application_Service_Name>

Adresa URL a serviciului de aplicație XML

Implicit: gol

Adresa URL 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 macro sunt acceptate în URL-urile XML. Pentru variabilele macro valide, consultați Vari abilele macro acceptate în URL-urile XML.

Numai protocoalele HTTP sau HTTPs sunt acceptate în URL.

Nume utilizator XML

Implicit: gol

Numele de utilizator al serviciului XML î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">username</XML_User_Name>

Parola XML

Implicit: gol

Parola serviciului XML pentru numele de utilizator XML specificat.

Parola pe care ați introdus-o în acest câmp apare în fișierul de configurare (cfg.xml) după cum urmează:

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

CISCO XML EXE Activare

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">Yes</CISCO_XML_EXE_Enable>

Modul de autentificare CISCO XML EXE

Implicit: acreditare locală

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

Specifică modul de autentificare pentru Cisco XML EXE.

  • Încredere — Nu se efectuează nicio autentificare indiferent de acreditarea locală.

  • Acreditare locală — Autentificarea se bazează pe autentificarea în rezumat utilizând acreditarea locală, dacă este setată. Dacă acreditarea locală nu este setată, atunci nu se efectuează nicio autentificare.

  • Acreditare la distanță — Autentificarea se bazează pe autentificarea de 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 tastă softkey

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

Î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 Vo ce > Telefon.

3

În secțiunea T aste programabile, setați Activare tastat ură 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">Yes</Programmable_Softkey_Enable>
4

În secțiunea T aste programabile, editați câmpurile disponibile din PSK1 la PSK 16 în acest format:

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

unde url este linkul în 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=Menu</PSK_n> <configuration code>

unde n este numărul tastelor softkey.

5

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

Adăugarea unei aplicații XML la o cheie 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 de aplicații XML a fost configurat corect.

1

Accesați pagina web de administrare a telefonului.

2

Selectaţi Vo ce > Telefon.

3

Selectați o tastă de linie.

4

Setați parametrul Extensie la Dezactiv at 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 linie. Dacă funcția este activată, puteți sări peste acest pas. Pentru detalii, consultați Acti varea configurației PLK directe.
5

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

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

unde url este linkul în 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=Menu</Extended_Function_n_> <configuration code>

unde n este numărul extensiei.

6

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

Variabile macro acceptate în URL-uri XML

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

  • ID utilizator — UID1, UID2 la UIDn

  • Nume afișat — DisplayName1, DISPLAYNAME2 la DisplayNamen

  • ID de autentificare — AUTHID1, AUTHID2 la AuthIDN

  • Proxy — Proxy1, PROXY2 la ProxyN

  • Adresa MAC folosind cifre hexagonale minuscule — MA

  • Denumirea produsului—PN

  • Numărul seriei de produs — PSN

  • Număr de serie — Serial_number

Tabelul 2. Macro-uri acceptate
Nume macroExpansiune macro
$Formularul $$ se extinde la un singur caracter $.
A până la PÎnlocuit cu parametrii de uz general GPP_A prin GPP_P.
SA prin SDÎnlocuit cu parametrii de scop special GPP_SA prin GPP_SD. Acești parametri dețin cheile sau parolele utilizate în aprovizionare.

$SA până la $SD sunt recunoscute ca argumente pentru calificatorul opțional de resincronizare URL , --key.

MAAdresa MAC folosind cifre hexagonale minuscule (000e08aabbcc).
MAUAdresa MAC folosind cifre hexagonale majuscule (000E08AABBCC).
MACAdresa MAC folosind cifre hexagonale minuscule cu două puncte pentru a separa perechile de cifre hexagonale (00:0 e:08:aa:bb:cc).
PNNumele produsului; de exemplu, telefon video 8875, telefon de birou 9851.
PSNNumărul seriei de produs; de exemplu, 8875, 9841, 9861
SNȘir număr de serie; de exemplu, 88012BA01234.
CCERTStarea certificatului client SSL, instalat sau neinstalat.
IPAdresa IP a telefonului în subrețeaua sa locală; de exemplu, 192.168.1.100.
EXTIPIP-ul extern al telefonului, așa cum se vede pe internet; de exemplu, 66.43.16.52.

SWVER

Șir de versiuni software. De exemplu,

PHONEOS.3-2-1-0104-37

HWVER

Șir de versiune hardware. De exemplu, 2.0.1

PRVST

Starea provizionării (un șir numeric):

-1 = cerere explicită de resincronizare

0 = resincronizare a pornirii

1 = resincronizare periodică

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

UPGST

Stare de actualizare (un șir numeric):

1 = prima încercare de actualizare

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

UPGERR

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

PRVTMR

Secunde de la ultima încercare de resincronizare.

UPGTMR

Secunde de la ultima încercare de actualizare.

REGTMR1

Secunde de când Linia 1 a pierdut înregistrarea cu serverul SIP.

REGTMR2

Secunde de când Linia 2 a pierdut înregistrarea cu serverul SIP.

UPGCOND

Numele macrocomenzii vechi.

SCHEME

Schema de acces la fișiere, una dintre TFTP, HTTP sau HTTPS, obținută după analizarea resincronizării sau actualizării URL-ului.

SERV

Solicitați numele gazdei serverului țintă, așa cum se obține după analizarea resincronizării sau actualizării URL-ului.

SERVIP

Solicitați adresa IP a serverului țintă, obținută după analizarea resincronizării sau actualizării URL-ului, posibil după căutarea DNS.

PORT

Solicitați portul UDP/TCP țintă, așa cum se obține după analizarea resincronizării sau actualizării URL-ului.

PATH

Solicitați calea fișierului țintă, așa cum se obține după analizarea resincronizării sau actualizării URL-ului.

ERR

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

UIDn

Conținutul parametrului de configurare Line n UserId.

ISCUST

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

Starea de personalizare este vizibilă pe pagina Web UI Info.

INCOMINGNAMENumele asociat primului apel conectat, apelului sonor sau apelului de intrare.
REMOTENUMBER

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

Nume de afișareConținutul parametrului de configurare a numelui afișat Line N.
AutentificareIDNConținutul parametrului de configurare ID autentificare Line N.
A fost util acest articol?
A fost util acest articol?