Pregled

XML servisni interfejs (XSI) je protokol koji omogućava komunikaciju između aplikacija i telefonskog sistema. Možete da dodate sopstvene XSI usluge na telefon koristeći podržane XML objekte i URI-je.

Kada se pretplatite na telefon, korisnici mogu da pristupe svim konfigurisanim uslugama na telefonu tako što će preći na Podešavanja > Mreža i usluga > Cisco XML usluge. Cisco XML usluge su podrazumevano ime. Takođe možete da promenite ime. Da biste korisnicima pružili jednostavan pristup, XML aplikacije možete dodati softverskim tasterima ili linijskim tasterima.

Podržane funkcije su:

  • Poruke (slike i tekst)
  • Пејџер

Podržani XML objekti

  • CiscoIPPhoneMenu

  • CiscoIPPhoneText

  • CiscoIPPhoneInput

  • CiscoIPPhoneDirectory

  • CiscoIPPhoneImage

  • CiscoIPPhoneImageFile

  • CiscoIPPhoneIconMenu

  • CiscoIPPhoneIconFileMenu

  • CiscoIPPhoneStatus (osim 9841)

  • CiscoIPPhoneStatusFile (osim 9841)

  • CiscoIPPhoneIzvršavanje

Podržani URI-ji

  • Uređaj

  • Biranje broja

  • лижење

  • ињем

  • Ključ

  • Reprodukuj (samo melodije)

  • Softverski taster

Više detalja o konfiguraciji XSI usluge potražite u članku Cisco Unified IP napomene za razvoj aplikacija za telefonske usluge.

Konfigurišite telefon za povezivanje sa XML uslugom

1

Pristupite veb stranici za administraciju telefona.

2

Izaberite stavku Glas > Telefon.

3

U odeljku XML usluge konfigurišite Ime XML usluge aplikacije i URL adresu XML usluge aplikacije kako su definisani u Parametri za XML usluge.

4

(Opcionalno) Da biste dodali potvrdu identiteta za pristup usluzi aplikacije, konfigurišite polja: XML korisničko ime, XML lozinka, CISCO XML EXE omogućavanje i CISCO XML EXE režima potvrde identiteta.

5

Kliknite na Sačuvaj sve promene.

Parametri za XML usluge

Sledeća tabela definiše funkciju i upotrebu parametara XML aplikacije u odeljku XML usluge pod stavkom Glas > Telefon u Veb interfejsu telefona. Takođe definiše sintaksu niske koja se dodaje u telefonsku datoteku (cfg.xml) sa XML kodom za konfigurisanje parametra.

Tabela 1. Parametri za XML usluge

Parametar

Podrazumevano i opcije

Opis

Ime usluge XML aplikacije

Podrazumevano: Prazno

Ime XML aplikacije. Ime se prikazuje na telefonu kao izbor veb-aplikacije.

Ovaj parametar možete da konfigurišete i u XML datoteci konfiguracije telefona (cfg.xml) unosom niske u ovom formatu:

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

URL XML usluge aplikacije

Podrazumevano: Prazno

URL adresa na kojoj se nalazi XML aplikacija.

Ovaj parametar možete da konfigurišete i u XML datoteci konfiguracije telefona (cfg.xml) unosom niske u ovom formatu:

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

Promenljive makroa su podržane u XML URL adresama. Za važeće promenljive makroa pogledajte članak Promenljive makroa podržane u XML URL adresama.

Samo HTTP ili HTTP protokoli su podržani u URL adresi.

XML korisničko ime

Podrazumevano: Prazno

Korisničko ime XML usluge u svrhe potvrde identiteta.

Ovaj parametar možete da konfigurišete i u XML datoteci konfiguracije telefona (cfg.xml) unosom niske u ovom formatu:

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

XML lozinka

Podrazumevano: Prazno

XML lozinka usluge za navedeno XML korisničko ime.

Lozinka koju ste uneli u ovo polje prikazuje se u datoteci za konfiguraciju (cfg.xml) kao sledeće:

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

Omogući CISCO XML EXE

Podrazumevano: Ne

Opcije: Da, Ne

Određuje da li je autentifikacija potrebna za pristup serveru XML aplikacije.

Ovaj parametar možete da konfigurišete i u XML datoteci konfiguracije telefona (cfg.xml) unosom niske u ovom formatu:

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

Režim CISCO XML EXE potvrde identiteta

Podrazumevano: Lokalni akreditivi

Opcije: Pouzdani, lokalni akreditivi, udaljeni akreditivi

Određuje režim potvrde identiteta za Cisco XML EXE.

  • Pouzdano – potvrda identiteta se ne vrši bez obzira na lokalne akreditive.

  • Lokalni akreditivi – potvrda identiteta se zasniva na potvrdi identiteta sažimanja pomoću lokalnih akreditiva, ako je podešena. Ako lokalni akreditivi nisu podešeni, onda se ne izvršava nikakva potvrda identiteta.

  • Daljinski akreditivi – potvrda identiteta se zasniva na potvrdi identiteta sažimanja pomoću daljinskih akreditiva kao što je podešeno u XML aplikaciji na veb stranici (za pristup XML serveru aplikacije).

Ovaj parametar možete da konfigurišete i u XML datoteci konfiguracije telefona (cfg.xml) unosom niske u ovom formatu:

<CISCO_XML_EXE_Auth_Mode ua="na">Lokalni akreditivi</CISCO_XML_EXE_Auth_Mode>

Dodajte XML aplikaciju softverskom tasteru

Dodajte često korišćene aplikacije u softverske tastere za korisnike da bi lako pristupili usluzi.

Pre nego što počnete

XML usluga aplikacije je pravilno konfigurisana.

1

Pristupite veb stranici za administraciju telefona.

2

Izaberite stavku Glas > Telefon.

3

U odeljku Softverski tasteri koji mogu da se programiraju postavite Softverski taster Omogući na Da.

Ovaj parametar takođe možete da konfigurišete u konfiguracionoj datoteci (cfg.xml). Unesite nisku u ovom formatu:

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

U odeljku Programabilni softverski tasteri uredite dostupna polja PSK1 u PSK16 u ovom formatu:

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

gde je url veza na kojoj je uskladištena XML aplikacija; nme je ime za prikaz aplikacije na ekranu telefona.

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

Ovaj parametar takođe možete da konfigurišete u konfiguracionoj datoteci (cfg.xml). Unesite nisku u ovom formatu:

<PSK_n ua="na">fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu<kôd za konfiguraciju></PSK_n>

gde je n broj softverskog ključa.

5

Kliknite na Sačuvaj sve promene.

Dodajte XML aplikaciju tasteru za liniju

Dodajte često korišćene aplikacije na linijske tastere za korisnike za jednostavan pristup uslugama.

Pre nego što počnete

XML usluga aplikacije je pravilno konfigurisana.

1

Pristupite veb stranici za administraciju telefona.

2

Izaberite stavku Glas > Telefon.

3

Izaberite taster linije.

4

Postavite parametar lokala na Onemogućeno da biste onemogućili lokal.

Ako je onemogućena funkcija direktne PLK konfiguracije, morate da onemogućite proširenje da biste dodali proširenu funkciju na ključ linije. Ako je funkcija omogućena, možete da preskočite ovaj korak. Detaljnije informacije potražite u članku Omogućavanje direktnog PLK konfiguracije.
5

U parametru proširene funkcije unesite nisku u ovom formatu:

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

gde je url veza na kojoj je uskladištena XML aplikacija; nme je ime za prikaz aplikacije na ekranu telefona.

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

Ovaj parametar takođe možete da konfigurišete u konfiguracionoj datoteci (cfg.xml). Unesite nisku 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_>

gde je n broj proširenja.

6

Kliknite na Sačuvaj sve promene.

Promenljive makroa podržane u XML URL adresama

Promenljive makroa možete koristiti u XML URL adresama. Podržane su sledeće promenljive makroa:

  • ID korisnika – UID1, UID2 do UIDn

  • Ime za prikaz—DISPLAYNAME1, DISPLAYNAME2 u DISPLAYNAMEn

  • ID potvrde identiteta – AUTHID1, AUTHID2 na AUTHIDn

  • Proksi – PROKSI1, PROKSI2 u PROKSIn

  • MAC adresa pomoću malih heks cifara – MA

  • Ime proizvoda—PN

  • Broj serije proizvoda – PSN

  • Serijski broj – SERIAL_NUMBER

Tabela 2. Podržani makroi
Ime makroaProširenje makroa
$Obrazac $$$ proširuje se na jedan $ znak.
A kroz PZamenjen je parametrima opšte namene GPP_A putem GPP_P.
za SA SDZamenjen je parametrima specijalne namene GPP_SA preko GPP_SD. Ovi parametri sadrže ključeve ili lozinke koje se koriste prilikom dodeljivanja privilegija.
$SA do $SD se priznaju kao argumenti za opcionalni resinc URL kvalifikator, --ključ.
ЛезбејкиMAC adresa pomoću malih hex cifara (000e61aabbcc).
MAUMAC adresa pomoću velikih hex cifara (000E61AABBCC).
бубуљицеMAC adresa koristi male hex cifre sa dve tačke za razdvajanje hex cifara (00:0e:08:aa:bb:cc).
pnJsIme proizvoda; na primer, Video telefon 8875, Stoni telefon 9851.
psnBroj serije proizvoda; na primer, 8875, 9841, 9861
БловјобNiska serijskog broja; na primer, 88012BA01234.
пустињаStatus SSL klijenta je instaliran ili nije instaliran.
IPIP adresa telefona u okviru lokalne podmreže; na primer, 192.168.1.100.
одвојенSpoljni IP telefona, kao što se vidi na internetu; na primer, 66.43.16.52.

svвер

Niska verzije softvera. Na primer:

фоне.3-2-1-0104-37

vučiću

Niska hardverske verzije. Na primer, 2.0.1

Кућа

Stanje dodele privilegija (numerička niska):

-1 = eksplicitni zahtev za resinc

0 = ponovo za napajanje

1 = periodična resinka

2 = ponovo sinhronizacija nije uspela. Pokušajte ponovo

јужне

Stanje nadogradnje (numerička niska):

1 = prvi pokušaj nadogradnje

2 = nadogradnja nije uspela, pokušajte ponovo

милфдупе

Poruka rezultata (ERR) prethodnog pokušaja nadogradnje; na primer http_get nije uspela.

фејсситинг

Nekoliko sekundi od poslednjeg pokušaja resinka.

цигле

Sekundi od poslednjeg pokušaja nadogradnje.

Јун 1

Sekundi od kada je linija 1 izgubila registraciju sa SIP serverom.

одвојен2color

Sekundi od kada je linija 2 izgubila registraciju sa SIP serverom.

фејсситинг

Zastarelo ime makroa.

шецем

Šema pristupa datotekama, jedan od TFTP, HTTP ili HTTPS, kao što je dobijena nakon raščlanjivanja resinka ili URL adrese nadogradnje.

Милошевић

Zahtevaj ime hosta ciljnog servera, kao što je preuzeto nakon raščlanjivanja resinka ili URL adrese nadogradnje.

Јумбо

Zahtevajte IP adresu ciljnog servera, kao što je dobijeno nakon raščlanjivanja resinka ili URL adrese nadogradnje, moguće sledeći DNS traženje.

Кућа

Zahtevaj ciljni UDP/TCP port, kao što je dobijeno nakon raščlanjivanja resinka ili URL adrese nadogradnje.

Кућа

Zahtevaj putanju ciljne datoteke, kao što je dobijeno nakon raščlanjivanja resinka ili URL adrese nadogradnje.

плејер

Rezultat poruke o pokušaju resinka ili nadogradnje. Korisno samo u generisanju rezultata sistemskih poruka. Vrednost se čuva u promenljivoj UPGERR u slučaju pokušaja nadogradnje.

UIDn

Sadržaj parametra konfiguracije linije n UserID-a.

Кућа

Ako je jedinica prilagođena, vrednost=1, inače 0.

Status prilagođavanja je vidljiv na stranici Web UI informacija.

инвестицијеIme je povezano sa prvim povezanim, zvonom ili dolaznim pozivom.
шљем,

Broj telefona prvog povezanog, zvona ili dolaznog poziva. Ako postoji više poziva, obezbeđeni su podaci povezani sa prvim pronađenim pozivom.

ОмиљеноSadržaj parametra za konfiguraciju imena za prikaz Linije N.
AuthidNSadržaj parametra konfiguracije ID-a linije N za autorizaciju.