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

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 kartici Voice > Phone 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.

Stol 1. Parametri za XML usluge

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:

<XML_Application_Service_Name ua="na">XML NAZIV APLIKACIJE</XML_Application_Service_Name>

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:

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

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

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:

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

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:

<CISCO_XML_EXE_Enable ua="na">Da</CISCO_XML_EXE_Enable>

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.

  • Pouzdano – provjera autentičnosti ne provodi se bez obzira na lokalnu vjerodajnicu.

  • Lokalna vjerodajnica – provjera autentičnosti temelji se na sažetoj provjeri autentičnosti pomoću lokalne vjerodajnice, ako je postavljena. Ako lokalna vjerodajnica nije postavljena, tada se ne provodi provjera autentičnosti.

  • Udaljena vjerodajnica – provjera autentičnosti temelji se na sažetoj provjeri autentičnosti pomoću udaljene vjerodajnice kako je postavljeno u XML aplikaciji na web-stranici (za pristup poslužitelju aplikacije XML).

Ovaj parametar možete konfigurirati i u konfiguraciji telefona XML datoteci (cfg.xml) unosom niza u ovom formatu:

<CISCO_XML_EXE_Auth_Mode ua="na">Lokalna vjerodajnica</CISCO_XML_EXE_Auth_Mode>

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

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:

<Programmable_Softkey_Enable ua="na">Da</Programmable_Softkey_Enable>
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 je URL veza na kojoj je pohranjena XML aplikacija; nme je zaslonski naziv 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 obliku:

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

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

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 je URL veza na kojoj je pohranjena XML aplikacija; nme je zaslonski naziv 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 obliku:

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

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

Stol 2. Podržane makronaredbe
Naziv makronaredbeProširenje makronaredbe
$Oblik $$ proširuje se na jedan znak $ .
A do PZamijenjeno parametrima opće namjene GPP_A kroz GPP_P.
SA do SDZamijenjeno 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 --.
MAMAC adresu malim heksadecimalnim brojkama (000e08aabbcc).
MAUMAC adresu velikim šesterokutnim znamenkama (000E08AABBCC).
MACMAC adresu pomoću malih šesterokutnih znamenki s dvotočkom za razdvajanje parova heksadecimalnih znamenki (00:0e:08:aa:bb:cc).
PNNaziv proizvoda; na primjer, Video telefon 8875, Stolni telefon 9851.
PSNSerijski broj proizvoda; Na primjer, 8875, 9841, 9861
SNNiz serijskog broja; na primjer, 88012BA01234.
CCERTSSL Status klijentskog certifikata, instaliran ili nije instaliran.
IPIP adresu telefona unutar lokalne podmreže; na primjer 192.168.1.100.
EXTIPVanjski 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 NAZIVNaziv 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.

DISPLAYNAMEnSadržaj parametra konfiguracije zaslonskog naziva retka N.
AUTHIDnSadržaj parametra konfiguracije ID provjere autentičnosti retka N.