Pregled

XML Services Interface (XSI) je protokol koji omogućuje komunikaciju između aplikacija i telefonskog sustava. Možete dodati vlastite XSI usluge telefonu pomoću podržanih XML objekata i URI-ja.

Nakon pretplate telefona na usluge, korisnici mogu pristupiti svim konfiguriranim uslugama na telefonu prelaskom na Postavke > Mreža i usluga > Cisco XML usluge. Usluge Cisco XML zadani je naziv. Također možete promijeniti ime. Kako biste korisnicima pružili jednostavan pristup, možete dodati XML aplikacije funkcijskim tipkama ili linijskim tipkama.

Podržane značajke su:

  • Poruke (slike i tekst)
  • Dojavljivanje

Podržani XML objekti

  • Izbornik Cisco IPPhone

  • Cisco IPPhoneText

  • CiscoIPPhone

  • CiscoIPPhoneDirectory

  • Cisco IPPhoneImage

  • Cisco IPhoneImageFile

  • Izbornik CiscoIPPhoneIcon

  • CiscoIPPhoneIconDatotekaIzbornik

  • Status CiscoIPPhone (osim 9841)

  • CiscoIPPhoneStatusFile (osim 9841)

  • CiscoIPPhone

Podržani URI-ji

  • Uređaj

  • Biraj broj

  • Uredi dail

  • Init

  • Ključ

  • Reproduciraj (samo zvukovi zvona)

  • Funkcijska tipka

Dodatne pojedinosti o konfiguraciji XSI usluge potražite u Bilješke o razvoju aplikacije 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 usluge aplikacije i URL usluge XML aplikacije kao što je definirano u Parametri za XML usluge.

4

(Neobavezno) Za dodavanje provjere autentičnosti za pristup usluzi aplikacije konfigurirajte polja za tezu: XML korisničko ime, XML lozinka, omogućavanje CISCO XML EXE i način rada za provjeru autentičnosti CISCO XML EXE.

5

Kliknite na Spremi sve promjene.

Parametri za XML usluge

Sljedeća tablica definira funkciju i upotrebu parametara XML aplikacije u odjeljku XML usluga pod karticom Glas > Telefon 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.

Tablica 1. Parametri za XML usluge

Parametar

Zadane postavke i opcije

Opis

Naziv usluge XML aplikacije

Zadano: Prazno

Naziv XML aplikacije. Naziv se prikazuje na telefonu kao izbor web aplikacije.

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

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

URL XML usluge aplikacije

Zadano: Prazno

URL na kojem se nalazi XML aplikacija.

Ovaj parametar možete konfigurirati i u XML datoteci za konfiguraciju telefona (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 makronaredbi pogledajte odjeljak Varijable makronaredbi podržane u XML URL-ovima.

URL podržava samo HTTP ili HTTP protokole.

XML korisničko ime

Zadano: Prazno

Korisničko ime XML usluge za potrebe provjere autentičnosti.

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

<XML_User_Name ua="na">korisničko ime</XML_User_Name>

XML lozinka

Zadano: Prazno

Lozinka XML usluge za navedeno XML korisničko ime.

Lozinka koju ste unijeli u ovo polje prikazuje u konfiguracijskoj datoteci (cfg. xml) kao sljedeće:

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

Omogućavanje za CISCO XML EXE

Zadano: Ne

Mogućnosti: Da, ne

Određuje je li potrebna provjera autentičnosti za pristup poslužitelju XML aplikacije.

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

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

Način rada za CISCO XML EXE provjeru autentičnosti

Zadano: Lokalne vjerodajnice

Mogućnosti: Pouzdane, lokalne vjerodajnice, udaljene vjerodajnice

Određuje način provjere autentičnosti za Cisco XML EXE.

  • Pouzdano — provjera autentičnosti se ne provodi bez obzira na lokalne vjerodajnice.

  • Lokalne vjerodajnice – provjera autentičnosti temelji se na provjeri autentičnosti sažetka pomoću lokalnih vjerodajnica, ako je postavljena. Ako nisu postavljene lokalne vjerodajnice, provjera autentičnosti neće biti izvršena.

  • Udaljene vjerodajnice — provjera autentičnosti temelji se na provjeri autentičnosti sažetka pomoću udaljenih vjerodajnica kao što je postavljeno u XML aplikaciji na web-stranici (za pristup poslužitelju XML aplikacije).

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

<CISCO_XML_EXE_Auth_Mode ua="na">Lokalne vjerodajnice</CISCO_XML_EXE_Auth_Mode>

Dodaj XML aplikaciju funkcijskoj tipki

Dodajte često korištene aplikacije u funkcijske tipke kako bi korisnici mogli jednostavno pristupiti usluzi.

Prije početka

XML usluga aplikacije ispravno je konfigurirana.

1

Pristupite web stranici administracije telefona.

2

Odaberite Glas > Telefon.

3

U odjeljku Programibilne funkcijske tipke postavite opciju Programibilne funkcijske tipke na Da.

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

<Programmable_Softkey_Enable ua="na">Da</Programmable_Softkey_Enable>
4

U odjeljku Programibilne funkcijske tipke uredite dostupna polja od PSK1 do PSK16 u ovom formatu:

fnc=xml;url=<xml_app_path>;nme=<app_name>

gdje je url veza na koju 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 formatu:

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

gdje je n broj funkcijske tipke.

5

Kliknite na Spremi sve promjene.

Dodaj XML aplikaciju tipki linije

Dodajte često korištene aplikacije za linijske tipke kako bi korisnici mogli jednostavno pristupiti uslugama.

Prije početka

XML usluga aplikacije ispravno je konfigurirana.

1

Pristupite web stranici administracije telefona.

2

Odaberite Glas > Telefon.

3

Odaberite tipku linije.

4

Postavite parametar kućnog broja na Onemogućeno kako biste onemogućili kućni broj.

Ako je značajka izravne PLK konfiguracije onemogućena, morate onemogućiti kućni broj kako biste dodali proširenu funkciju tipki linije. Ako je značajka omogućena, možete preskočiti taj korak. Pojedinosti potražite u odjeljku Omogućavanje izravne konfiguracije PLK-a.
5

U parametru Proširena funkcija unesite niz u ovom formatu:

fnc=xml;url=<xml_app_path>;nme=<app_name>

gdje je url veza na koju 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 formatu:

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

gdje je n kućni broj.

6

Kliknite na Spremi sve promjene.

Varijable makronaredbi podržane u XML URL-ovima

Možete koristiti varijable makronaredbi u XML URL-ovima. Podržane su sljedeće varijable makronaredbi:

  • ID korisnika – UID1, UID2 u UIDn

  • Zaslonsko ime—DISPLAYNAME1, DISPLAYNAME2 na DISPLAYNAMEn

  • ID provjere autentičnosti – AUTHID1, AUTHID2 u AUTHIDn

  • Proxy—PROXY1, PROXY2 za PROXYn

  • MAC adresa malim heksadecimalnim brojkama – MA

  • Naziv proizvoda – PN

  • Serijski broj proizvoda – PSN

  • Serijski broj—SERIAL_NUMBER

Tablica 2 Podržane makronaredbe
Naziv makronaredbeProširenje makronaredbe
$Oblik $$ proširuje se na jedan znak $.
A do PZamijenjeno parametrima za opće svrhe od GPP_A do GPP_P.
SA do SDZamijenjeno parametrima za posebne namjene GPP_SA do GPP_SD. Ti parametri sadrže ključeve ili lozinke koji se koriste u dodjeljivanju resursa.
$SA do $SD prepoznaju se kao argumenti za opcijsko ponovno sinkroniziranje URL kvalifikatora, tipka --tipka.
maMAC adresa malim heksadecimalnim brojkama (000e08aabbcc).
MAUMAC adresa velikim heksadecimalnim brojevima (000E08AABBCC).
macMAC adresa malim heksadecimalnim brojkama s dvotočkom za razdvajanje parova heksadecimalnih brojki (00:0e:08:aa:bb:cc).
pnNaziv proizvoda; na primjer, videotelefon 8875, stolni telefon 9851.
psnSerijski broj 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.
ektipVanjski IP telefona, kako se vidi na internetu; na primjer, 66.43.16.52.

swver

Niz verzije softvera. Na primjer, msiexec /i c:\work\Webex.msi DEFAULT_THEME="Light" ALLUSERS=1

telefon.3-2-1-0104-37

hwwver

Niz verzije hardvera. Na primjer, 2.0.1

prvst

Stanje dodjele resursa (numerički niz):

-1 = eksplicitni zahtjev za ponovnu sinkronizaciju

0 = ponovna sinkronizacija pri uključivanju

1 = povremena ponovna sinkronizacija

2 = ponovna sinkronizacija nije uspjela, ponovni pokušaj

najnovije

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 nije uspjelo.

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.

shema

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.

priključak

Zatraži ciljni UDP/TCP ulaz kako je dobiveno nakon raščlanjivanja URL-a ponovne sinkronizacije ili nadogradnje.

putanja

Zatraži put ciljne datoteke kako je dobiveno nakon raščlanjivanja URL-a ponovne sinkronizacije ili nadogradnje.

greška

Poruka rezultata pokušaja ponovne sinkronizacije ili nadogradnje. Korisno samo u generiranju poruka rezultata za syslog. Vrijednost se zadržava u varijabli UPGERR u slučaju pokušaja nadogradnje.

UID

Sadržaj parametra konfiguracije UserID linije n.

iscust

Ako je jedinica prilagođena, vrijednost=1, u suprotnom 0.

Status prilagodbe vidljiv je na stranici s informacijama o web-korisničkom sučelju.

dolazinameNaziv povezan s prvim povezanim pozivom, zvonjenjem ili dolaznim pozivom.
udaljenumber

Telefonski broj prvog povezanog, zvonjenja ili dolaznog poziva. Ako postoji više poziva, navode se podaci povezani s prvim pronađenim pozivom.

Zaslonski NAZIVnSadržaj parametra konfiguracije zaslonskog naziva linije N.
AUTHIDnSadržaj parametra konfiguracije ID-a provjere autentičnosti linije N.