Pregled

XML Services Interface (KSSI) je protokol koji omogućava komunikaciju između aplikacija i telefonskog sistema. Možete dodati svoje KSSI usluge na svoj telefon koristeći podržane XML objekte i URI.

Nakon pretplate telefona na usluge, korisnici mogu pristupiti svim konfigurisanim uslugama na telefonu tako što će se kretati do Settings > Netvork and service > Cisco XML services. Cisco XML usluge su podrazumevano ime. Takođe možete da promenite ime. Da biste korisnicima omogućili lak pristup, možete dodati XML aplikacije na softverske ključeve ili linijske tastere.

Podržane funkcije su:

  • Poruke (slike i tekst)
  • Numerisanje stranica

Podržani XML objekti

  • CiscoIPPhoneMenu

  • Srpskohrvatski / srpskohrvatski

  • CiscoIPPhoneInput

  • Srpskohrvatski / srpskohrvatski

  • Srpskohrvatski / srpskohrvatski

  • Srpskohrvatski / srpskohrvatski

  • CiscoIPPhoneIconMenu

  • CiscoIPPhoneIconFileMenu

  • CiscoIPPhoneStatus (osim 9841)

  • CiscoIPPhoneStatusFile (osim 9841)

  • Srpskohrvatski / srpskohrvatski

Podržani URI-ji

  • Uređaj

  • Biraj

  • OMILjENO

  • Pretraga

  • Ključ

  • Plai (samo melodije zvona)

  • Softver za upotrebu

Za više detalja o konfiguraciji KSSI servisa, pogledajteCisco Unified IP Phone Services Application Development Notes.

Konfigurišite telefon za povezivanje sa XML uslugom

1

Pristupite administracionoj veb stranici telefona.

2

Izaberite opciju Glas > Telefon.

3

U odeljku XML servis , konfigurišite XML naziv aplikativne usluge i XML parametre URL aplikacije kao što je definisano u Parametri za XML usluge.

4

(Opciono) Da biste dodali autentifikaciju za pristup aplikacijskoj usluzi, konfigurišite polja teza: XML korisničko ime, XML lozinka, CISCO XML EKSE Enable i CISCO XML EKSE Auth Mode.

5

Kliknite na dugme Sačuvaj sve promene.

Parametri za XML usluge

Sledeća tabela definiše funkciju i upotrebu parametara XML aplikacije u XML odeljku Servis na kartici Glas> telefon u veb interfejsu telefona. On takođe definiše sintaksu niza koji je dodat u datoteku za konfiguraciju telefona sa (cfg.xml) sa XML kodom za podešavanje parametra.

Tabela 1. Parametri za XML usluge

Parametar

Podrazumevano i opcije

Opis

XML aplikacija servis ime

Podrazumevano: Prazno

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

Takođe možete konfigurisati ovaj parametar u konfiguraciji telefona XML fajl (cfg.xml) unosom niza u ovom formatu:

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

URL XML aplikativnog servisa

Podrazumevano: Prazno

URL adresa na kojoj se nalazi XML aplikacija.

Takođe možete konfigurisati ovaj parametar u konfiguraciji telefona XML fajl (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 su podržane u XML URL-ovima. Za ispravne makro promenljive, pogledajte Makro promenljive podržane u XML URL-ovima.

U URL-u su podržani samo HTTP ili HTTP protokoli.

XML Korisničko ime

Podrazumevano: Prazno

XML servis korisničko ime za potrebe autentifikacije.

Takođe možete konfigurisati ovaj parametar u konfiguraciji telefona XML fajl (cfg.xml) unosom niza u ovom formatu:

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

XML lozinka

Podrazumevano: Prazno

XML servisna lozinka za navedeno XML korisničko ime.

Lozinka koju ste uneli u ovom polju prikazuje se u konfiguracionoj datoteci (cfg.xml) na sledeći način:

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

CISCO XML EKSE Omogući

Podrazumevano: Ne

Opcije: Da, Ne

Određuje da li je provera identiteta potrebna za pristup XML aplikativnom serveru.

Takođe možete konfigurisati ovaj parametar u konfiguraciji telefona XML fajl (cfg.xml) unosom niza u ovom formatu:

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

CISCO XML EKSE Auth režim

Podrazumevano: Lokalni akreditivni

Opcije: Pouzdana, lokalna akreditacija, daljinska akreditacija

Određuje režim autentifikacije za Cisco XML EXE.

  • Pouzdano—Ne vrši se autentifikacija bez obzira na lokalnu akreditivu.

  • Lokalna akreditacija—Autentifikacija se zasniva na autentifikaciji digesta koristeći lokalnu akreditivu, ako je postavljena. Ako lokalni akreditivi nisu podešeni, onda se ne vrši autentifikacija.

  • Daljinska akreditacija—Autentifikacija se zasniva na autentifikaciji digesta pomoću udaljenog akreditiva kao što je postavljeno u XML aplikaciji na veb stranici (za pristup XML aplikativnom serveru).

Takođe možete konfigurisati ovaj parametar u konfiguraciji telefona XML fajl (cfg.xml) unosom niza u ovom formatu:

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

Dodajte XML aplikaciju u softkei

Dodajte često korišćene aplikacije na softverske tastere za korisnike da lako pristupe usluzi.

Pre nego što počnete

XML aplikativni servis je pravilno konfigurisan.

1

Pristupite administracionoj veb stranici telefona.

2

Izaberite opciju Glas > Telefon.

3

U odeljku Programabilni softverski tasteri podesite Programmable Softkei Enable na Da.

Takođe možete konfigurisati ovaj parametar u konfiguracionoj datoteci (cfg.xml). Unesite string u ovom formatu:

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

U odeljku Programmable Softkeis , izmenite dostupna polja PSK1 na PSK16 u ovom formatu:

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

gde url je veza na kojoj se čuva 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

Takođe možete konfigurisati ovaj parametar u konfiguracionoj datoteci (cfg.xml). Unesite string u ovom formatu:

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

gde je n broj softverskih tastera.

5

Kliknite na dugme Sačuvaj sve promene.

Dodajte XML aplikaciju na linijski ključ

Dodajte često korišćene aplikacije za linijske ključeve za korisnike da lako pristupe uslugama.

Pre nego što počnete

XML aplikativni servis je pravilno konfigurisan.

1

Pristupite administracionoj veb stranici telefona.

2

Izaberite opciju Glas > Telefon.

3

Izaberite taster za liniju.

4

Podesite parametar Ektension na Disabled da biste onemogućili ekstenziju.

Ako je funkcija Direct PLK Configuration onemogućena, morate onemogućiti ekstenziju da biste dodali proširenu funkciju na linijski taster. Ako je funkcija omogućena, možete preskočiti ovaj korak. Za detalje, pogledajte Omogući direktnu konfiguraciju PLK-a.
5

U parametru Produžena funkcija, unesite niz u ovom formatu:

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

gde url je veza na kojoj se čuva 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

Takođe možete konfigurisati ovaj parametar u konfiguracionoj datoteci (cfg.xml). Unesite string u ovom formatu:

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

gde je n broj lokala.

6

Kliknite na dugme Sačuvaj sve promene.

Makro promenljive podržane u XML URL adresama

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

  • ID korisnika – UID1, UID2 u UIDn

  • Prikazno ime—DISPLAYNAME1, DISPLAYNAME2 na DISPLAYNAMEn

  • Auth ID—AUTHID1, AUTHID2 u AUTHIDn

  • Proxy—PROXY1, PROXY2 u PROXYn

  • MAC adresa pomoću malih heksadecimalnih cifara—MA

  • Naziv proizvoda—PN

  • Broj serije proizvoda - PSN

  • Serijski broj—SERIAL_NUMBER

Tabela 2. Podržani makroi
Ime makroaMakro ekspanzija
$Oblik $$ se proširuje na jedan $ karakter.
A do PZamenjen parametrima opšte namene GPP_A kroz GPP_P.
SA do SDZamenjen specijalnim parametrima opšte namene GPP_SA do GPP_SD. Ovi parametri sadrže ključeve ili lozinke koje se koriste u obezbeđivanju.
$SA do $SD se prepoznaju kao argumenti za opcioni kvalifikator URL adrese za ponovnu sinhronizaciju, --key.
MAMAC adresa koristeći male heksadecimalne cifre (000e08aabbcc).
MAUMAC adresa koristeći velika slova heksadecimalnih cifara (000E08AABBCC).
MACMAC adresa koristeći mala slova heksadecimalnih cifara sa dvotačkom za razdvajanje heksadecimalnih parova cifara (00:0e:08:aa:bb:cc).
PNNaziv proizvoda; na primer, Video telefon 8875, Desk Phone 9851.
PSNBroj serije proizvoda; na primer, 8875, 9841, 9861
SNSerijski broj string; na primer, 88012BA01234.
CCERTStatus SSL klijentskog sertifikata, instaliran ili nije instaliran.
IPIP adresu telefona u lokalnoj podmreži; na primer, 192.168.1.100.
EXTIPSpoljni IP telefona, kao što se vidi na internetu; na primer, 66.43.16.52.

SWVER

Niz za verziju softvera. Na primer,

PHONEOS.3-2-1-0104-37

HWVER

Niz za verziju hardvera. Na primer, 2.0.1

PRVST

Status za obezbeđivanje (numerički niz):

-1 = eksplicitni zahtev za ponovnu sinhronizaciju

0 = ponovna sinhronizacija nakon uključivanja

1 = periodična ponovna sinhronizacija

2 = ponovna sinhronizacija nije uspela, ponovite pokušaj

UPGST

Status nadogradnje (numerički niz):

1 = prvi pokušaj nadogradnje

2 = nadogradnja nije uspela, ponovni pokušaj

UPGERR

Poruka o rezultatu (ERR) prethodnog pokušaja nadogradnje; na primer http_get nije uspeo.

PRVTMR

Sekundi od poslednjeg pokušaja ponovne sinhronizacije.

UPGTMR

Sekundi od poslednjeg pokušaja ažuriranja.

REGTMR1

Nekoliko sekundi otkako je linija 1 izgubila registraciju na SIP serveru.

REGTMR2

Nekoliko sekundi otkako je linija 2 izgubila registraciju na SIP serveru.

UPGCOND

Zastarelo ime makroa.

SCHEME

Šema pristupa datoteci, jedna od TFTP, HTTP ili HTTPS, dobijena nakon raščlanjivanja URL-a za ponovnu sinhronizaciju ili nadogradnju.

SERV

Zatražite ime hosta ciljnog servera, dobijeno nakon raščlanjivanja URL-a za ponovnu sinhronizaciju ili nadogradnju.

SERVIP

Zahtevajte IP adresu ciljnog servera, dobijenu nakon raščlanjivanja URL-a za ponovnu sinhronizaciju ili nadogradnju, verovatno nakon DNS traženja.

PORT

Zahtevajte ciljni UDP/TCP port, dobijen nakon raščlanjivanja URL adrese za ponovnu sinhronizaciju ili nadogradnju.

PATH

Zatražite putanju ciljne datoteke, dobijenu nakon raščlanjivanja URL-a za ponovnu sinhronizaciju ili nadogradnju.

ERR

Poruka o rezultatu pokušaja ponovne sinhronizacije ili nadogradnje. Korisno samo u generisanju poruka sistemskog dnevnika rezultata. Vrednost se čuva u promenljivoj UPGERR u slučaju pokušaja nadogradnje.

UIDn

Sadržaj konfiguracionog parametra Linija i ID korisnika.

ISKUST

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

Status prilagođavanja je vidljiv na Veb UI Info stranici.

DOLAZEIMEIme povezano sa prvim povezanim, zvonjavim ili dolaznim pozivom.
DALJINSKI BROJ

Broj telefona prvog povezanog, zvoni ili dolazni poziv. Ako postoji više poziva, podaci povezani sa prvim pozivom pronađen je obezbeđen.

EKSHIBICIONISTSadržaj parametra konfiguracije Line N Display Name.
OMILjENOSadržaj parametra konfiguracije Line N auth ID.