- Početak
- /
- Članak
Konfiguracija XML aplikacija za telefone 9800 i 8875 (BroadWorks)
Ovaj članak pomoći odnosi se na Cisco Desk Phone 9800 Series i Cisco Video Phone 8875 koji su registrirani na Cisco BroadWorks. Pročitajte ovaj članak za podržane XML objekte, URI-ove i korake za konfiguriranje XSI usluga na web stranici telefona.
Pregled
XML Services Interface (XSI) je protokol koji omogućuje komunikaciju između aplikacija i telefonskog sustava. Možete dodati vlastite XSI usluge na telefon koristeći podržane XML objekte i URI-ove.
Nakon pretplate telefona na usluge, korisnici mogu pristupiti svim konfiguriranim uslugama na telefonu kretanjem na usluge. Cisco XML usluge zadani su naziv. Također možete promijeniti ime. Da biste korisnicima omogućili jednostavan pristup, možete dodati XML aplikacije softključima ili linijskim tipkama.
Podržane značajke su:
- Poruke (slike i tekst)
- Pejdžing
Podržani XML objekti
-
CiscoIPPhoneMenu
-
CiscoipphoneSljedeći
-
CiscoipPhoneInput
-
CISCOIPPhoneDirektorij
-
CiscoipphoneSlika
-
CiscoipPhoneDatoteka slike
-
CISCOIPPhoneIconMenu
-
CiscoipPhoneIconFile Menu
-
CiscoipPhoneStatus (osim 9811 i 9841)
-
CISCOIPPhonStatusFile (osim 9811 i 9841)
-
CiscoipPhoneIzvršiti
Podržani URI-ji
-
Uređaj
-
Birajte
-
UređiDail
-
Init
-
Ključ
-
Reproduciranje (samo melodije zvona)
-
Softkey
Više detalja o konfiguraciji XSI usluge potražite u članku Napomene o razvoju aplikacija Cisco Unified IP Phone Services.
Konfigurirajte telefon za povezivanje s XML uslugom
| 1 |
Pristupite web stranici administracije telefona. |
| 2 |
Odaberite . |
| 3 |
U odjeljku XML usluga konfigurirajte parametre XML Application Service Name i XML Application Service URL parametre kako je definirano u Parametri za XML usluge. |
| 4 |
(Opcionalno) Da biste dodali provjeru autentičnosti za pristup aplikacijskoj usluzi, konfigurirajte ova polja: XML korisničko ime, XML lozin ka, CISCO XML EXE Enable i CISCO XML EXE Auth Mo de. |
| 5 |
Kliknite Spremi sve promjene. |
Parametri za XML usluge
Sljedeća tablica definira funkciju i upotrebu parametara XML aplikacije u odjeljku XML usluga pod karticom G na web sučelju telefona. Također definira sintaksu niza koji se dodaje u konfiguracijsku datoteku telefona (cfg.xml) s XML kodom za konfiguriranje parametra.
|
Parametar |
Zadane postavke i opcije |
Opis |
|---|---|---|
|
Naziv usluge XML aplikacije |
Zadano: Prazno |
Naziv XML aplikacije. Ime se prikazuje na telefonu kao izbor web aplikacije. Ovaj parametar možete konfigurirati i u XML datoteci konfiguracije telefona (cfg.xml) unosom niza u ovom formatu:
|
|
URL usluge XML aplikacije |
Zadano: Prazno |
URL na kojem se nalazi XML aplikacija. Ovaj parametar možete konfigurirati i u XML datoteci konfiguracije telefona (cfg.xml) unosom niza u ovom formatu:
Makro varijable podržane su u XML URL-ovima. Za važeće makro varijable pogledajte Makro varijable podržane u XML URL-ovima. U URL-u su podržani samo protokoli HTTP ili HTTP. |
|
XML korisničko ime |
Zadano: Prazno |
Korisničko ime XML usluge u svrhu provjere autentičnosti. Ovaj parametar možete konfigurirati i u XML datoteci konfiguracije telefona (cfg.xml) unosom niza u ovom formatu:
|
|
XML lozinka |
Zadano: Prazno |
XML lozinka usluge za navedeno XML korisničko ime. Lozinka koju ste unijeli u ovo polje prikazuje se u konfiguracijskoj datoteci (cfg.xml) kako slijedi:
|
|
Omogući CISCO XML EXE |
Zadano: Ne Opcije: Da, Ne |
Određuje je li potrebna provjera autentičnosti za pristup poslužitelju XML aplikacija. Ovaj parametar možete konfigurirati i u XML datoteci konfiguracije telefona (cfg.xml) unosom niza u ovom formatu:
|
|
CISCO XML EXE način autorizacije |
Zadano: Lokalni vjerodajnik Opcije: Pouzdana, lokalna vjerodajnica, udaljena vjerodajnica |
Određuje način provjere autentičnosti za Cisco XML EXE.
Ovaj parametar možete konfigurirati i u XML datoteci konfiguracije telefona (cfg.xml) unosom niza u ovom formatu:
|
Dodavanje XML aplikacije softkey
Dodajte često korištene aplikacije softključima kako bi korisnici mogli lako pristupiti usluzi.
Prije nego što počnete
XML Application Service ispravno je konfigurirana.
| 1 |
Pristupite web stranici administracije telefona. |
| 2 |
Odaberite . |
| 3 |
U odjeljku Programabilni softkeys postavite programabilni softkey Enable na Da. Ovaj parametar možete konfigurirati i u konfiguracijskoj datoteci (cfg.xml). Unesite niz u ovom formatu:
|
| 4 |
U odjeljku Programmable Softkeys uredite dostupna polja PSK1 do PSK 16 u ovom formatu: fnc=xml;url=<xml_app_path>;nme=<app_name>
gdje je
Primjer
Ovaj parametar možete konfigurirati i u konfiguracijskoj datoteci (cfg.xml). Unesite niz u ovom formatu:
gdje je n softkey broj. |
| 5 |
Kliknite Spremi sve promjene. |
Dodajte XML aplikaciju u linijski ključ
Dodajte često korištene aplikacije u linijske tipke kako bi korisnici mogli lako pristupiti uslugama.
Prije nego što počnete
XML Application Service ispravno je konfigurirana.
| 1 |
Pristupite web stranici administracije telefona. |
| 2 |
Odaberite . |
| 3 |
Odaberite linijski ključ. |
| 4 |
Postavite parametar Pro ši renje na Onem oguć eno da biste onemogućili proširenje. Ako je značajka Direct PLK Configuration onemogućena, morate onemogućiti proširenje da biste dodali proširenu funkciju linijskoj tipki. Ako je značajka omogućena, možete preskočiti ovaj korak. Pojedinosti potražite u odjeljku Omogući direktnu konfiguraciju PLK. |
| 5 |
U paramet ru Proširena funkcija unesite niz u ovom formatu: fnc=xml;url=<xml_app_path>;nme=<app_name>
gdje je
Primjer
Ovaj parametar možete konfigurirati i u konfiguracijskoj datoteci (cfg.xml). Unesite niz u ovom formatu:
gdje je n broj proširenja. |
| 6 |
Kliknite Spremi sve promjene. |
Makro varijable podržane u XML URL-ovima
Makro varijable možete koristiti u XML URL-ovima. Podržane su sljedeće makro varijable:
-
Korisnički ID — UID1, UID2 do UIDn
-
Ime prikaza—DisplayName1, DISPLAYNAME2 do DisplayNamen
-
Autentički ID — AUTHID1, AUTHID2 u AuthIDN
-
Proxy—Proxy1, PROXY2 u ProxyN
-
MAC adresa pomoću malih šesterokutnih znakova—MA
-
Naziv proizvoda — PN
-
Broj serije proizvoda - PSN
-
Serijski broj - Serial_number
| Naziv makro | Makro proširenje |
|---|---|
| $ | Obrazac $$ proširuje se na jedan $ znak. |
| A do P | Zamijenjen parametrima opće namjene GPP_A preko GPP_P. |
| SA preko SD | Zamijenjen parametrima posebne namjene GPP_SA putem GPP_SD. Ovi parametri sadrže
ključeve ili lozinke koje se koriste u pružanju usluga. $SA do $SD prepoznaju se kao argumenti opcionalnog kvalifikatora za ponovnu sinkronizaciju URL-a, --key. |
| MA | MAC adresa pomoću malih šesterokutnih znamenki (000e08aabbcc). |
| MAU | MAC adresa pomoću velikih šesterokutnih znamenki (000E08AABBCC). |
| MAC | MAC adresa pomoću malih šesterokutnih znamenki s dvotočkom za odvajanje parova šesterokutnih znamenki (00:0 e:08:aa:bb:cc). |
| PN | Naziv proizvoda; na primjer, video telefon 8875, stolni telefon 9851. |
| PSN | Broj serije proizvoda; na primjer, 8875, 9841, 9861 |
| SN | Niz serijskog broja; na primjer, 88012BA01234. |
| CCERT | Status certifikata SSL klijenta, instaliran ili nije instaliran. |
| IP | IP adresa telefona unutar njegove lokalne podmreže; na primjer, 192.168.1.100. |
| EXTIP | Vanjski IP telefona, kao što se vidi na internetu; na primjer, 66.43.16.52. |
|
SWVER |
Niz verzije softvera. Na primjer, PHONEOS.3-2-1-0104-37 |
|
HWVER |
Niz verzije hardvera. Na primjer, 2.0.1 |
|
PRVST |
Stanje osiguranja (numerički niz): -1 = eksplicitni zahtjev za ponovnu sinkronizaciju 0 = ponovna sinkronizacija uključivanja 1 = periodična ponovna sinkronizacija 2 = ponovna sinkronizacija nije uspjela, pokušaj ponovnog pokušaja |
|
UPGST |
Stanje nadogradnje (numerički niz): 1 = prvi pokušaj nadogradnje 2 = nadogradnja nije uspjela, pokušaj ponovnog pokušaja |
|
UPGERR |
Poruka rezultata (ERR) prethodnog pokušaja nadogradnje; na primjer http_get nije uspio. |
|
PRVTMR |
Sekunde od zadnjeg pokušaja ponovne sinkronizacije. |
|
UPGTMR |
Sekunde od posljednjeg pokušaja nadogradnje. |
|
REGTMR1 |
Sekunde otkako je linija 1 izgubila registraciju na SIP poslužitelju. |
|
REGTMR2 |
Sekunde otkako je linija 2 izgubila registraciju na SIP poslužitelju. |
|
UPGCOND |
Naslijeđeni naziv makronaredbe. |
|
SCHEME |
Shema pristupa datotekama, jedna od TFTP, HTTP ili HTTPS, kako je dobivena nakon raščlanjivanja ponovne sinkronizacije ili nadogradnje URL-a. |
|
SERV |
Zatražite ime hosta ciljnog poslužitelja, kako je dobiveno nakon raščlanjivanja ponovne sinkronizacije ili nadogradnje URL-a. |
|
SERVIP |
Zatražite IP adresu ciljnog poslužitelja, dobivenu nakon raščlanjivanja ponovne sinkronizacije ili nadogradnje URL-a, moguće nakon pretraživanja DNS-a. |
|
PORT |
Zatražite ciljni UDP/TCP port, kako je dobiveno nakon raščlanjivanja ponovne sinkronizacije ili nadogradnje URL-a. |
|
PATH |
Zatražite putanju ciljne datoteke, kako je dobiveno nakon raščlanjivanja ponovne sinkronizacije ili nadogradnje URL-a. |
|
ERR |
Poruka rezultata ponovne sinkronizacije ili pokušaja nadogradnje. Korisno samo u generiranju poruka rezultata syslog. Vrijednost se čuva u UPGERR varijabli u slučaju pokušaja nadogradnje. |
|
UIDn |
Sadržaj konfiguracijskog parametra Line n userId. |
| ISCUST |
Ako je jedinica prilagođena, valute:1, inače 0. Status prilagodbe može se vidjeti na stranici Web UI Info. |
| INCOMINGNAME | Ime povezano s prvim povezanim, zvonim ili dolaznim pozivom. |
| REMOTENUMBER |
Telefonski broj prvog povezanog, zvona ili dolaznog poziva. Ako postoji više poziva, daju se podaci povezani s prvim pronađenim pozivom. |
| DisplayName | Sadržaj konfiguracijskog parametra Line N Display Name. |
| AuthIDN | Sadržaj konfiguracijskog parametra Line N auth ID. |