U ovome članku
dropdown icon
Pregled
    Podržani XML objekti
    Podržani URI-ji
Konfigurirajte telefon za povezivanje s XML uslugom
Parametri za XML usluge
Dodavanje XML aplikacije softkey
Dodajte XML aplikaciju u linijski ključ
Makro varijable podržane u XML URL-ovima

Konfiguracija XML aplikacija za telefone 9800 i 8875 (BroadWorks)

list-menuU ovome članku
list-menuŽelite li poslati povratne informacije?

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 Post avke> Mre ža i usluga > Cisco XML 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 Glas > Telefon.

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 las > Telefon 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.

Tablica 1. Parametri za XML usluge

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:

<XML_Application_Service_Name
ua="na">XML APP Name</XML_Application_Service_Name>

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:

<XML_Application_Service_URL
ua="na">https://server.com/path/app.xml</XML_Application_Service_URL>

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_User_Name ua="na">username</XML_User_Name>

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:

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

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_Enable ua="na">Yes</CISCO_XML_EXE_Enable>

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.

  • Pouzdano — Ne provodi se provjera autentičnosti bez obzira na lokalnu vjerodajnicu.

  • Lokalna vjerodajnica — Autentifikacija temelji se na sažetku provjere autentičnosti pomoću lokalne vjerodajnice, ako je postavljena. Ako lokalni vjerodajnik nije postavljen, tada se ne vrši provjera autentičnosti.

  • Daljinska vjerodajnica — Autentifikacija temelji se na sažetku provjere autentičnosti pomoću udaljene vjerodajnice kako je postavljeno u XML aplikaciji na web stranici (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_Auth_Mode ua="na">Local Credential</CISCO_XML_EXE_Auth_Mode>

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 Glas > Telefon.

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:

<Programmable_Softkey_Enable ua="na">Yes</Programmable_Softkey_Enable>
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 url veza na kojoj se pohranjuje XML aplikacija; nme je naziv za prikaz aplikacije na zaslonu telefona.

Primjer fnc=xml; url= http://10.77.21.37/xmlapp/menu.xml;nme=Menu

Ovaj parametar možete konfigurirati i u konfiguracijskoj datoteci (cfg.xml). Unesite niz u ovom formatu:

<PSK_n ua="na">fnc=xml; url= http://10.77.21.37/xmlapp/menu.xml;nme=Menu</PSK_n> <configuration code>

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 Glas > Telefon.

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 url veza na kojoj se pohranjuje XML aplikacija; nme je naziv za prikaz aplikacije na zaslonu telefona.

Primjer fnc=xml; url= http://10.77.21.37/xmlapp/menu.xml;nme=Menu

Ovaj parametar možete konfigurirati i u konfiguracijskoj datoteci (cfg.xml). Unesite niz u ovom formatu:

<Extended_Function_n_ ua="na">fnc=xml; url= http://10.77.21.37/xmlapp/menu.xml;nme=Menu</Extended_Function_n_> <configuration code>

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

Tablica 2. Podržani makronaredbi
Naziv makroMakro proširenje
$Obrazac $$ proširuje se na jedan $ znak.
A do PZamijenjen parametrima opće namjene GPP_A preko GPP_P.
SA preko SDZamijenjen 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.

MAMAC adresa pomoću malih šesterokutnih znamenki (000e08aabbcc).
MAUMAC adresa pomoću velikih šesterokutnih znamenki (000E08AABBCC).
MACMAC adresa pomoću malih šesterokutnih znamenki s dvotočkom za odvajanje parova šesterokutnih znamenki (00:0 e:08:aa:bb:cc).
PNNaziv proizvoda; na primjer, video telefon 8875, stolni telefon 9851.
PSNBroj serije proizvoda; na primjer, 8875, 9841, 9861
SNNiz serijskog broja; na primjer, 88012BA01234.
CCERTStatus certifikata SSL klijenta, instaliran ili nije instaliran.
IPIP adresa telefona unutar njegove lokalne podmreže; na primjer, 192.168.1.100.
EXTIPVanjski 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.

INCOMINGNAMEIme 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.

DisplayNameSadržaj konfiguracijskog parametra Line N Display Name.
AuthIDNSadržaj konfiguracijskog parametra Line N auth ID.
Je li taj članak bio koristan?
Je li taj članak bio koristan?