Pregled

XML Services Interface (XSI) je protokol, ki omogoča komunikacijo med aplikacijami in telefonskim sistemom. V telefon lahko dodate svoje storitve XSI s podprtimi XML predmeti in URI-ji.

Ko se telefon naroči na storitve, lahko uporabniki dostopajo do vseh konfiguriranih storitev na telefonu tako, da se pomaknejo do možnosti Nastavitve > Omrežje in storitve > Cisco XML storitve. Storitve Cisco XML je privzeto ime. Spremenite lahko tudi ime. Če želite uporabnikom omogočiti enostaven dostop, lahko XML aplikacije dodate na dinamične ali linijske tipke.

Podprte funkcije so:

  • Sporočila (slike in besedilo)
  • Poziv

Podprti XML predmeti

  • CiscoIPPhoneMenu

  • CiscoIPPhoneText

  • CiscoIPPhoneInput

  • CiscoIPPhoneDirectory

  • CiscoIPPhoneImage

  • CiscoIPPhoneImageFile

  • CiscoIPPhoneIconMenu

  • CiscoIPPhoneIconFileMenu

  • CiscoIPPhoneStatus (razen 9841)

  • Datoteka CiscoIPPhoneStatusFile (razen 9841)

  • CiscoIPPhoneExecute

Podprti URI-ji

  • Naprava

  • Dial

  • UrediDail

  • Init

  • Ključ

  • Predvajaj (samo toni zvonjenja)

  • Dinamična tipka

Če želite več podrobnosti o konfiguraciji storitve XSI, glejte Cisco Unified IP Phone Services Application Development Notes.

Konfiguriranje telefona za povezavo s storitvijo XML

1

Odprite spletno stran za skrbništvo telefona.

2

Izberite Glas> telefon.

3

V razdelku XML storitev konfigurirajte parametre Ime storitve aplikacije in XML URL storitve aplikacije XML kot je določeno v razdelku Parametri za storitve XML.

4

(Neobvezno) Če želite dodati preverjanje pristnosti za dostop do storitve aplikacije, konfigurirajte naslednja polja: XML Uporabniško ime, XML Geslo, Omogoči CISCO XML EXE in Način preverjanja pristnosti CISCO XML EXE.

5

Kliknite Shrani vse spremembe.

Parametri za storitve XML

V spodnji tabeli sta opredeljeni funkcija in uporaba parametrov aplikacije XML v razdelku XML storitev pod zavihkom Glas> telefon v spletnem vmesniku telefona. Določa tudi sintakso niza, ki je dodana v konfiguracijsko datoteko telefona (cfg.xml) s kodo XML za konfiguriranje parametra.

Preglednica 1. Parametri za storitve XML

Parameter

Privzeto in možnosti

Opis

XML Ime storitve aplikacije

Privzeto: Prazno

Ime XML aplikacije. Ime se na telefonu prikaže kot izbira spletne aplikacije.

Ta parameter lahko konfigurirate tudi v konfiguraciji telefona XML datoteki (cfg.xml), tako da vnesete niz v tej obliki:

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

URL storitve XML aplikacije

Privzeto: Prazno

URL, kjer se nahaja XML aplikacija.

Ta parameter lahko konfigurirate tudi v konfiguraciji telefona XML datoteki (cfg.xml), tako da vnesete niz v tej obliki:

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

Makro spremenljivke so podprte v XML URL-jih. Za veljavne makrospremenljivke glejte Spremenljivke makrov, podprte v XML URL-jih.

V URL-ju so podprti samo protokoli HTTP ali HTTP.

Uporabniško ime za XML

Privzeto: Prazno

XML uporabniško ime storitve za namene preverjanja pristnosti.

Ta parameter lahko konfigurirate tudi v konfiguraciji telefona XML datoteki (cfg.xml), tako da vnesete niz v tej obliki:

<XML_User_Name UA="na">uporabniško ime</XML_User_Name>

Geslo XML

Privzeto: Prazno

XML geslo storitve za določeno XML uporabniško ime.

Geslo, ki ste ga vnesli v to polje, je v konfiguracijski datoteki (cfg.xml) prikazano tako:

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

Omogoči CISCO XML EXE

Privzeto: Ne

Možnosti: Da, ne

Določa, ali je za dostop do XML strežnika programa potrebno preverjanje pristnosti.

Ta parameter lahko konfigurirate tudi v konfiguraciji telefona XML datoteki (cfg.xml), tako da vnesete niz v tej obliki:

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

Način preverjanja pristnosti CISCO XML EXE

Privzeto: lokalne poverilnice

Možnosti: zaupanja vredna, lokalna poverilnica, oddaljena poverilnica

Določa način preverjanja pristnosti za Cisco XML EXE.

  • Zaupanja vredno – preverjanje pristnosti ni izvedeno ne glede na lokalne poverilnice.

  • Lokalne poverilnice – preverjanje pristnosti temelji na preverjanju pristnosti s povzetkom z lokalnimi poverilnicami, če je nastavljeno. Če lokalna poverilnica ni nastavljena, preverjanje pristnosti ni izvedeno.

  • Oddaljene poverilnice – preverjanje pristnosti temelji na preverjanju pristnosti s povzetkom z oddaljeno poverilnico, kot je nastavljeno v programu XML na spletni strani (za dostop do strežnika XML programa).

Ta parameter lahko konfigurirate tudi v konfiguraciji telefona XML datoteki (cfg.xml), tako da vnesete niz v tej obliki:

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

Dodajanje XML programa dinamični tipki

Dodajte pogosto uporabljene aplikacije na dinamične tipke, da bodo uporabniki lahko preprosto dostopali do storitve.

Preden začnete

Aplikacijska storitev XML je bila pravilno konfigurirana.

1

Odprite spletno stran za skrbništvo telefona.

2

Izberite Glas> telefon.

3

V razdelku Nastavljive dinamične tipke nastavite možnost Programirljiva dinamična tipka Omogoči na Da .

Ta parameter lahko konfigurirate tudi v konfiguracijski datoteki (cfg.xml). Vnesite niz v tej obliki zapisa:

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

V razdelku Programabilne dinamične tipke uredite razpoložljiva polja PSK1 v PSK16 v tej obliki:

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

kjer je URL povezava, kjer je shranjena XML aplikacija; NME je prikazno ime aplikacije na zaslonu telefona.

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

Ta parameter lahko konfigurirate tudi v konfiguracijski datoteki (cfg.xml). Vnesite niz v tej obliki zapisa:

<PSK_n UA="na">fnc=xml;URL=http://10.77.21.37/xmlapp/menu.xml;nme=Menu<konfiguracijska koda></PSK_n>

kjer je n številka dinamične tipke.

5

Kliknite Shrani vse spremembe.

Dodajanje XML programa v linijsko tipko

Dodajte pogosto uporabljene aplikacije v linijske tipke, da bodo uporabniki lahko preprosto dostopali do storitev.

Preden začnete

Aplikacijska storitev XML je bila pravilno konfigurirana.

1

Odprite spletno stran za skrbništvo telefona.

2

Izberite Glas> telefon.

3

Izberite linijsko tipko.

4

Parameter Extension nastavite na Onemogočeno , da onemogočite razširitev.

Če je funkcija neposredne konfiguracije PLK onemogočena, morate onemogočiti razširitev, da linijski tipki dodate razširjeno funkcijo. Če je funkcija omogočena, lahko ta korak preskočite. Če želite podrobnosti, glejte Omogočanje konfiguracije neposrednega PLK.
5

V parameter Razširjena funkcija vnesite niz v tej obliki zapisa:

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

kjer je URL povezava, kjer je shranjena XML aplikacija; NME je prikazno ime aplikacije na zaslonu telefona.

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

Ta parameter lahko konfigurirate tudi v konfiguracijski datoteki (cfg.xml). Vnesite niz v tej obliki zapisa:

<Extended_Function_n_ UA="na">fnc=xml;URL=http://10.77.21.37/xmlapp/menu.xml;nme=Menu<konfiguracijska koda></Extended_Function_n_>

kjer je n interna številka.

6

Kliknite Shrani vse spremembe.

Makro spremenljivke, podprte v XML URL-jih

Spremenljivke makrov lahko uporabite v XML URL-jih. Podprte so naslednje makro spremenljivke:

  • ID uporabnika – UID1, UID2 do UIDn

  • Prikazano ime – DISPLAYNAME1 DISPLAYNAME2 na DISPLAYNAMEn

  • Auth ID – AUTHID1, AUTHID2 na AUTHIDn

  • Proxy – proxy1, PROXY2 do PROXYn

  • MAC Naslov z malimi šestnajstiškimi številkami – MA

  • Ime izdelka – PN

  • Številka serije izdelkov – PSN

  • Serijska številka – SERIAL_NUMBER

Preglednica 2. Podprti makri
Ime makraRazširitev makrov
$Obrazec $$$ se razširi na en znak $.
A do PNadomeščen s splošnimi parametri GPP_A do GPP_P.
SA do SDZamenjajo se s parametri za posebne namene od GPP_SA do GPP_SD. Ti parametri vsebujejo ključe ali gesla, uporabljene pri omogočanju uporabe.
$SA do $SD so prepoznani kot argumenti za izbirni kvalifikator resinhronizacijskega URL-ja: --key.
MAMAC naslov z malimi šestnajstiškimi številkami (000e08aabbcc).
MAUMAC naslov z velikimi šestnajstiškimi številkami (000E08AABBCC).
MACMAC naslov z malimi šestnajstiškimi številkami in dvopičjem za ločevanje šestnajstiških parov (00:0E:08:aa:bb:cc).
PNIme izdelka; na primer Video telefon 8875, Namizni telefon 9851.
PSNštevilka serije izdelkov; Na primer 8875, 9841, 9861
SNNiz serijske številke; na primer 88012BA01234.
CCERTSSL stanje potrdila odjemalca, nameščeno ali nenameščeno.
IPIP naslov telefona v lokalnem podomrežju; na primer 192.168.1.100.
EXTIPZunanji IP-telefona, kot ga vidimo na internetu; na primer 66.43.16.52.

SWVER

Niz različice programske opreme – Primer:

PHONEOS.3-2-1-0104-37

HWVER

Niz različice strojne opreme – primer: 2.0.1

PRVST

Stanje omogočanja uporabe (številski niz):

-1 = izrecna zahteva za resinhronizacijo

0 = resinhronizacija ob zagonu

1 = redna resinhronizacija

2 = resinhronizacija ni uspela, vnovični poskus

UPGST

Stanje nadgradnje (številski niz):

1 = prvi poskus nadgradnje

2 = nadgradnja ni uspela, vnovični poskus

UPGERR

Sporočilo z rezultatom (ERR) prejšnjega poskusa nadgradnje; primer: http_get failed

PRVTMR

Št. sekund od zadnjega poskusa resinhronizacije

UPGTMR

Št. sekund od zadnjega poskusa nadgradnje

REGTMR1

Št. sekund, odkar je linija 1 izgubila registracijo s strežnikom SIP

REGTMR2

Št. sekund, odkar je linija 2 izgubila registracijo s strežnikom SIP

UPGCOND

Ime podedovanega makra

SCHEME

Shema za dostop do datotek – TFTP, HTTP ali HTTPS, pridobljena z razčlenitvijo URL-ja za resinhronizacijo ali nadgradnjo

SERV

Gostiteljsko ime ciljnega strežnika zahteve, pridobljeno z razčlenitvijo URL-ja za resinhronizacijo ali nadgradnjo

SERVIP

Naslov IP ciljnega strežnika zahteve, pridobljen z razčlenitvijo URL-ja za resinhronizacijo ali nadgradnjo, po možnosti po iskanju DNS

PORT

Vrata UDP/TCP ciljnega strežnika zahteve, pridobljeno z razčlenitvijo URL-ja za resinhronizacijo ali nadgradnjo

PATH

Datotečna pot ciljnega strežnika zahteve, pridobljena z razčlenitvijo URL-ja za resinhronizacijo ali nadgradnjo

ERR

Sporočilo z rezultatom poskusa resinhronizacije ali nadgradnje Uporabno samo za generiranje sporočil sistemskega dnevnika z rezultatom. Vrednost je ohranjena v spremenljivki UPGERR v primeru poskusov nadgradnje.

UIDn

Vsebina konfiguracijskega parametra UserID za linijo n.

ISCUST

Če je enota prilagojena, value = 1, sicer 0.

Stanje prilagajanja si lahko ogledate na strani z informacijami o spletnem uporabniškem vmesniku.

DOHODNO IMEIme, povezano s prvim povezanim, zvonjenjem ali dohodnim klicem.
ODDALJENO ŠTEVILO

Telefonska številka prvega vzpostavljenega, zvonječega ali dohodnega klica. Če je klicev več, se navedejo podatki, povezani s prvim najdenim klicem.

PRIKAZNO IMEnVsebina konfiguracijskega parametra prikaznega imena vrstice N.
AUTHIDnVsebina parametra konfiguracije ID-ja avte vrstice N.