- Pagină de pornire
- /
- Articol
XML configurarea aplicațiilor pentru telefoane pe BroadWorks
Acest articol de ajutor se aplică la Cisco Desk Phone seria 9800 și Cisco Video Phone 8875 înregistrate la Cisco BroadWorks. Citiți acest articol pentru obiectele XML acceptate, URI-uri ș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 pe telefon navigând la
. 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 . |
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 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.
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 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:
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:
|
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ă:
|
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:
|
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 asemenea, puteți configura acest parametru în fișierul XML de configurare a telefonului (cfg.xml), introducând un șir în acest format:
|
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 . |
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:
|
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
Exemplu De asemenea, puteți configura acest parametru în fișierul de configurare (cfg.xml). Introduceți un șir în acest format:
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 . |
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
Exemplu De asemenea, puteți configura acest parametru în fișierul de configurare (cfg.xml). Introduceți un șir în acest format:
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
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. |
MA | MAC adresă utilizând cifre hexazecimale minuscule (000e08aabbcc). |
MAU | MAC adresă utilizând cifre hexazecimale majuscule (000E08AABBCC). |
MAC | MAC adresă utilizând cifre hexazecimale minuscule cu două puncte pentru a separa perechile de cifre hexazecimale (00:0e:08:aa:bb:cc). |
PN | Numele produsului; de exemplu, telefon video 8875, telefon de birou 9851. |
PSN | Numărul seriei produsului; De exemplu, 8875, 9841, 9861 |
SN | Număr de serie șir; de exemplu, 88012BA01234. |
CCERT | SSL starea certificatului client, instalat sau neinstalat. |
IP | IP adresa telefonului în subrețeaua locală; de exemplu, 192.168.1.100. |
EXTIP | IP 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. |
INCOMINGNAME | Nume 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. |
DISPLAYNAMEn | Conținutul parametrului de configurare Nume afișat linie N. |
AUTHIDn | Conținutul parametrului de configurare ID autentificare linie N. |