- Pagină de pornire
- /
- Articol
Configurarea aplicațiilor XML pentru telefoanele 9800 și 8875 (BroadWorks)
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 . 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 . |
| 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 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.
|
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:
|
|
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:
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:
|
|
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ă:
|
|
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:
|
|
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.
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 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 . |
| 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:
|
| 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
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 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 . |
| 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
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 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
| Nume macro | Expansiune 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. |
| MA | Adresa MAC folosind cifre hexagonale minuscule (000e08aabbcc). |
| MAU | Adresa MAC folosind cifre hexagonale majuscule (000E08AABBCC). |
| MAC | Adresa MAC folosind cifre hexagonale minuscule cu două puncte pentru a separa perechile de cifre hexagonale (00:0 e:08:aa:bb:cc). |
| PN | Numele produsului; de exemplu, telefon video 8875, telefon de birou 9851. |
| PSN | Numărul seriei de produs; de exemplu, 8875, 9841, 9861 |
| SN | Șir număr de serie; de exemplu, 88012BA01234. |
| CCERT | Starea certificatului client SSL, instalat sau neinstalat. |
| IP | Adresa IP a telefonului în subrețeaua sa locală; de exemplu, 192.168.1.100. |
| EXTIP | IP-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. |
| INCOMINGNAME | Numele 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șare | Conținutul parametrului de configurare a numelui afișat Line N. |
| AutentificareIDN | Conținutul parametrului de configurare ID autentificare Line N. |