- Početak
- /
- Članak
XML konfiguracija aplikacija za telefone na BroadWorks
Ovaj članak pomoći odnosi se na Cisco Desk Phone 9800 Series i Cisco Video Phone 8875 registrirane na Cisco BroadWorks. Pročitajte ovaj članak za podržane XML objekte, URI-je 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. Na telefon možete dodati vlastite XSI usluge pomoću podržanih XML objekata i URI-ja.
Nakon pretplate na telefon na usluge, korisnici mogu pristupiti svim konfiguriranim uslugama na telefonu tako da odu na Settings>Network i service
Cisco XML usluge je zadani naziv. Možete i promijeniti ime. Da biste korisnicima omogućili jednostavan pristup, možete dodati XML aplikacije funkcijskim tipkama ili tipkama linija.Podržane značajke su:
- Poruke (slike i tekst)
- Dojavljivanje
Podržani XML objekti
-
CiscoIPPhoneMenu
-
CiscoIPPhoneText
-
CiscoIPPhoneInput
-
CiscoIPPhoneDirectory
-
CiscoIPPhoneImage
-
CiscoIPPhoneImageFile
-
CiscoIPPhoneIconMenu
-
CiscoIPPhoneIconFileMenu
-
CiscoIPPhoneStatus (osim 9841)
-
CiscoIPPhoneStatusFile (osim 9841)
-
CiscoIPPhoneExecute
Podržani URI-ji
-
Uređaj
-
Brojčanik
-
EditDail
-
Init
-
Ključ
-
Reproduciraj (samo melodije zvona)
-
Funkcijske tipke
Dodatne informacije o konfiguraciji XSI servisa potražite u odjeljku Cisco Unified IP Phone Napomene o razvoju aplikacija servisa.
Konfiguriranje telefona za povezivanje sa servisom XML
1 |
Pristupite web stranici administracije telefona. |
2 |
Odaberite . |
3 |
U odjeljku XML Usluga konfigurirajte parametre XML Naziv usluge aplikacije i XML URL usluge aplikacije kako je definirano parametrima za XML usluge. |
4 |
(Neobavezno) Za dodavanje provjere autentičnosti za pristup aplikacijskom servisu konfigurirajte teze polja: XML Korisničko ime,XML Lozinka,CISCO XML EXE Enable i CISCO XML EXE Auth način. |
5 |
Kliknite Spremi sve promjene. |
Parametri za XML usluge
Sljedeća tablica definira funkciju i korištenje parametara XML aplikacije u odjeljku XML Usluga u u 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 |
Zadano i mogućnosti |
Opis |
---|---|---|
Naziv servisa XML aplikacije |
Zadano: prazno |
Naziv aplikacije za XML. Naziv se na telefonu prikazuje kao odabir web-aplikacije. Ovaj parametar možete konfigurirati i u konfiguraciji telefona XML datoteci (cfg.xml) unosom niza u ovom formatu:
|
URL servisa aplikacije XML |
Zadano: prazno |
URL na kojem se nalazi XML aplikacija. Ovaj parametar možete konfigurirati i u konfiguraciji telefona XML datoteci (cfg.xml) unosom niza u ovom formatu:
Varijable makronaredbi podržane su u XML URL-ovima. Za valjane varijable makronaredbe pogledajte Varijable makronaredbe podržane u XML URL-ovima. U URL-u su podržani samo HTTP ili HTTPs protokoli. |
XML korisničko ime |
Zadano: prazno |
XML korisničko ime usluge u svrhu provjere autentičnosti. Ovaj parametar možete konfigurirati i u konfiguraciji telefona XML datoteci (cfg.xml) unosom niza u ovom formatu:
|
XML lozinka |
Zadano: prazno |
XML lozinku usluge za navedeno XML korisničko ime. Lozinka koju ste unijeli u ovo polje prikazuje se u konfiguracijskoj datoteci (cfg.xml) kao sljedeća:
|
CISCO XML EXE omogućiti |
Zadano: Ne Opcije: Da, Ne |
Određuje je li potrebna provjera autentičnosti za pristup XML poslužitelju aplikacije. Ovaj parametar možete konfigurirati i u konfiguraciji telefona XML datoteci (cfg.xml) unosom niza u ovom formatu:
|
Način rada CISCO XML EXE Auth |
Zadana: lokalna vjerodajnica Mogućnosti: Pouzdana, Lokalna vjerodajnica, Udaljena vjerodajnica |
Određuje način provjere autentičnosti za Cisco XML EXE.
Ovaj parametar možete konfigurirati i u konfiguraciji telefona XML datoteci (cfg.xml) unosom niza u ovom formatu:
|
Dodavanje XML aplikacije funkciji funkcijskih tipki
Dodajte često korištene aplikacije na funkcijske tipke kako bi korisnici mogli jednostavno pristupiti usluzi.
Prije nego što počnete
Servis XML aplikacije ispravno je konfiguriran.
1 |
Pristupite web stranici administracije telefona. |
2 |
Odaberite . |
3 |
U odjeljku Programibilne funkcijske tipke postavite programabilnu funkcijsku tipku Omogući na Da. Ovaj parametar možete konfigurirati i u konfiguracijskoj datoteci (cfg.xml). Unesite niz u ovom obliku:
|
4 |
U odjeljku Programibilne funkcijske tipke uredite dostupna polja psk1 u PSK16 u ovom formatu: fnc=xml;URL=<xml_app_path>; nme=<app_name>
gdje
Primjer Ovaj parametar možete konfigurirati i u konfiguracijskoj datoteci (cfg.xml). Unesite niz u ovom obliku:
gdje je n broj funkcijske tipke. |
5 |
Kliknite Spremi sve promjene. |
Dodavanje XML aplikacije na tipku linije
Dodajte često korištene aplikacije linijskim tipkama kako bi korisnici mogli jednostavno pristupiti uslugama.
Prije nego što počnete
Servis XML aplikacije ispravno je konfiguriran.
1 |
Pristupite web stranici administracije telefona. |
2 |
Odaberite . |
3 |
Odaberite tipku linije. |
4 |
Postavite parametar Proširenje na Onemogućeno da biste onemogućili proširenje. Ako je značajka konfiguracije izravnog PLK-a onemogućena, morate onemogućiti proširenje kako biste dodali proširenu funkciju na tipku linije. Ako je značajka omogućena, možete preskočiti ovaj korak. Detalje potražite u odjeljku Omogućivanje konfiguracije izravnog PLK-a. |
5 |
U parametar Proširena funkcija unesite niz u ovom formatu: fnc=xml;URL=<xml_app_path>; nme=<app_name>
gdje
Primjer Ovaj parametar možete konfigurirati i u konfiguracijskoj datoteci (cfg.xml). Unesite niz u ovom obliku:
pri čemu je n kućni broj. |
6 |
Kliknite Spremi sve promjene. |
Varijable makronaredbi podržane u XML URL-ovima
Varijable makronaredbi možete koristiti u XML URL-ovima. Podržane su sljedeće varijable makronaredbe:
-
Korisnički ID — UID1, UID2 u UIDn
-
Zaslonsko ime—DISPLAYNAME1, DISPLAYNAME2 na DISPLAYNAMEn
-
Auth ID — AUTHID1, AUTHID2 na AUTHIDn
-
Proxy—PROXY1, PROXY2 na PROXYn
-
MAC adresa malim slovima heksadecimalnim brojkama – MA
-
Naziv proizvoda – PN
-
Broj serije proizvoda – PSN
-
Serijski broj – SERIAL_NUMBER
Naziv makronaredbe | Proširenje makronaredbe |
---|---|
$ | Oblik $$ proširuje se na jedan znak $ . |
A do P | Zamijenjeno parametrima opće namjene GPP_A kroz GPP_P. |
SA do SD | Zamijenjeno parametrima za posebne namjene GPP_SA do GPP_SD. Ti parametri imaju ključeve i lozinke koji se koriste u implementaciji. $SA do $SD prepoznaju se kao argumenti za opcijsko ponovno sinkroniziranje URL kvalifikatora, tipka --. |
MA | MAC adresu malim heksadecimalnim brojkama (000e08aabbcc). |
MAU | MAC adresu velikim šesterokutnim znamenkama (000E08AABBCC). |
MAC | MAC adresu pomoću malih šesterokutnih znamenki s dvotočkom za razdvajanje parova heksadecimalnih znamenki (00:0e:08:aa:bb:cc). |
PN | Naziv proizvoda; na primjer, Video telefon 8875, Stolni telefon 9851. |
PSN | Serijski broj proizvoda; Na primjer, 8875, 9841, 9861 |
SN | Niz serijskog broja; na primjer, 88012BA01234. |
CCERT | SSL Status klijentskog certifikata, instaliran ili nije instaliran. |
IP | IP adresu telefona unutar lokalne podmreže; na primjer 192.168.1.100. |
EXTIP | Vanjski IP telefona, kako 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 softvera. Na primjer, 2.0.1 |
PRVST |
Stanje postavljanja (numerički niz): -1 = eksplicitni zahtjev za ponovnu sinkronizaciju 0 = ponovna sinkronizacija kod uključivanja 1 = povremena ponovna sinkronizacija 2 = ponovna sinkronizacija nije uspjela, ponovni pokušaj |
UPGST |
Stanje nadogradnje (numerički niz): 1 = prvi pokušaj nadogradnje 2 = nadogradnja nije uspjela, ponovni pokušaj |
UPGERR |
Poruka rezultata (ERR) prethodnog pokušaja nadogradnje; na primjer http_get neuspjelo. |
PRVTMR |
Sekunde od zadnjeg pokušaja ponovne sinkronizacije. |
UPGTMR |
Sekunde od zadnjeg pokušaja nadogradnje. |
REGTMR1 |
Sekunde od gubitka registracije za liniju 1 sa SIP poslužiteljem. |
REGTMR2 |
Sekunde od gubitka registracije za liniju 2 sa SIP poslužiteljem. |
UPGCOND |
Naslijeđeni naziv makronaredbe. |
SCHEME |
Shema pristupa datoteci, jedna od TFTP, HTTP ili HTTPS, kako je dobiveno nakon raščlanjivanja URL-a ponovne sinkronizacije ili nadogradnje. |
SERV |
Zatraži naziv glavnog računala ciljnog poslužitelja kako je dobiveno nakon raščlanjivanja URL-a ponovne sinkronizacije ili nadogradnje. |
SERVIP |
Zatraži IP adresu ciljnog poslužitelja kako je dobiveno nakon raščlanjivanja URL-a ponovne sinkronizacije ili nadogradnje, vjerojatno nakon pretraživanja DNS-a. |
PORT |
Zatraži ciljni UDP/TCP priključak kako je dobiveno nakon raščlanjivanja URL-a ponovne sinkronizacije ili nadogradnje. |
PATH |
Zatraži stazu ciljne datoteke kako je dobiveno nakon raščlanjivanja URL-a ponovne sinkronizacije ili nadogradnje. |
ERR |
Poruka rezultata pokušaja ponovne sinkronizacije ili nadogradnje. Korisno samo kod stvaranja poruka rezultata za syslog. Vrijednost se zadržava u varijabli UPGERR u slučaju pokušaja nadogradnje. |
UIDn |
Sadržaj parametra konfiguracije UserID linije n. |
ISCUST |
Ako je jedinica prilagođena, value=1, u suprotnom 0. Stanje prilagodbe moguće je vidjeti na stranici Web UI Info. |
DOLAZNI NAZIV | Naziv pridružen prvom povezivanom, zvonjavom ili dolaznom pozivu. |
UDALJENI BROJ |
Telefonski broj prvog povezanog, zvonjenog ili dolaznog poziva. Ako postoji više poziva, navode se podaci povezani s prvim pronađenim pozivom. |
DISPLAYNAMEn | Sadržaj parametra konfiguracije zaslonskog naziva retka N. |
AUTHIDn | Sadržaj parametra konfiguracije ID provjere autentičnosti retka N. |