Pregled

Vmesnik storitev XML (XSI) je protokol, ki omogoča komunikacijo med aplikacijami in telefonskim sistemom. V telefon lahko dodate lastne storitve XSI z uporabo podprtih objektov XML in URI.

Po naročilu telefona na storitve lahko uporabniki dostopajo do vseh konfiguriranih storitev v telefonu tako, da se pomaknejo na Nastavitve > Omrežje in storitve > Storitve Cisco XML. Privzeto ime je Cisco XML storitve. Spremenite lahko tudi ime. Če želite uporabnikom omogočiti enostaven dostop, lahko aplikacije XML dodate programskim ali linijskim tipkam.

Podprte funkcije so:

  • Sporočila (slike in besedilo)
  • Pozivanje

Podprti objekti XML

  • CiscoIPPhoneMenu

  • CiscoIPPhoneText

  • CiscoIPPhoneInput

  • CiscoIPPhoneDirectory

  • CiscoIPPhoneImage

  • CiscoIPPhoneImageFile

  • CiscoIPPhoneIconMenu

  • CiscoIPPhoneIconFileMenu

  • CiscoIPPhoneStatus (razen 9841)

  • CiscoIPPhoneStatusFile (razen 9841)

  • CiscoIPPhoneExecute

Podprti URI

  • Naprava

  • Izberite

  • EditDail

  • Init

  • Ključ

  • Predvajaj (samo melodije zvonjenja)

  • Programska tipka

Za več podrobnosti o konfiguraciji storitve XSI glejte Cisco Unified IP Phone Services Application Development Notes.

Konfiguracija telefona za povezavo s storitvijo XML

1

Dostopite do spletne strani za upravljanje telefona.

2

Izberite Voice > Phone.

3

V razdelku Storitev XML konfigurirajte parametre XML Application Service Name in XML Application Service URL, kot je določeno v razdelku Parametri za storitve XML.

4

(Neobvezno) Če želite dodati preverjanje pristnosti za dostop do storitve aplikacije, konfigurirajte ta polja: Uporabniško ime XML, Geslo XML, CISCO XML EXE Enable, in CISCO XML EXE Auth Mode.

5

Kliknite Shrani vse spremembe.

Parametri za storitve XML

Naslednja preglednica opredeljuje funkcijo in uporabo parametrov aplikacije XML v razdelku XML Service v zavihku Voice > Phone v spletnem vmesniku telefona. Opredeljuje tudi sintakso niza, ki se doda v konfiguracijsko datoteko telefona (cfg.xml) s kodo XML za konfiguracijo parametra.

Tabela 1. Parametri za storitve XML

Parameter

Privzeto in možnosti

Opis

Ime storitve aplikacije XML

Privzeto: Prazen

Ime aplikacije XML. Ime je v telefonu prikazano kot izbira spletne aplikacije.

Ta parameter lahko nastavite tudi v datoteki XML za konfiguracijo telefona (cfg.xml) z vnosom niza v tej obliki:

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

URL storitve aplikacije XML

Privzeto: Prazen

URL, v katerem se nahaja aplikacija XML.

Ta parameter lahko nastavite tudi v datoteki XML za konfiguracijo telefona (cfg.xml) z vnosom niza v tej obliki:

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

Makropremenljivke so podprte v URL-jih XML. Za veljavne makrospremenljivke glejte Makrospremenljivke, podprte v URL-jih XML.

V naslovu URL so podprti samo protokoli HTTP ali HTTPs.

Uporabniško ime XML

Privzeto: Prazen

Uporabniško ime storitve XML za namene avtentikacije.

Ta parameter lahko nastavite tudi v datoteki XML za konfiguracijo telefona (cfg.xml) z vnosom niza v tej obliki:

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

Geslo XML

Privzeto: Prazen

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

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

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

CISCO XML EXE Omogoči

Privzeto: Ne

Možnosti: Da, Ne

Določa, ali je za dostop do aplikacijskega strežnika XML potrebna avtentikacija.

Ta parameter lahko nastavite tudi v datoteki XML za konfiguracijo telefona (cfg.xml) z vnosom niza v tej obliki:

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

Način avtentikacije CISCO XML EXE

Privzeto: Lokalno pooblastilo

Možnosti: Zaupanja vredno, lokalno pooblastilo, oddaljeno pooblastilo

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

  • Zaupanja vredno - avtentikacija se ne izvede ne glede na lokalno poverilnico.

  • Lokalno poverilnico - preverjanje pristnosti temelji na avtentikaciji s prebavo z uporabo lokalne poverilnice, če je nastavljena. Če lokalno pooblastilo ni nastavljeno, se avtentikacija ne izvede.

  • Preverjanje pristnosti z oddaljenim poverilnikom temelji na preverjanju pristnosti s prebavo z uporabo oddaljenega poverilnika, nastavljenega v aplikaciji XML na spletni strani (za dostop do strežnika aplikacije XML).

Ta parameter lahko nastavite tudi v datoteki XML za konfiguracijo telefona (cfg.xml) z vnosom niza v tej obliki:

<CISCO_XML_EXE_Auth_Mode ua="na">Lokalno pooblastilo</CISCO_XML_EXE_Auth_Mode>

Dodajanje aplikacije XML v programsko tipko

Pogosto uporabljene aplikacije dodajte v programske tipke, da bodo uporabniki lahko preprosto dostopali do storitve.

Preden začnete

Aplikacijska storitev XML je pravilno konfigurirana.

1

Dostopite do spletne strani za upravljanje telefona.

2

Izberite Voice > Phone.

3

V razdelku Programirljive programske tipke nastavite možnost Programirljive programske tipke Omogoči na Da.

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

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

V razdelku Programmable Softkeys uredite razpoložljiva polja PSK1 do PSK16 v tej obliki:

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

kjer je url povezava, kjer je shranjena aplikacija XML; 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 nastavite tudi v konfiguracijski datoteki (cfg.xml). Vnesite niz v tej obliki:

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

kjer je n številka programskega gumba.

5

Kliknite Shrani vse spremembe.

Dodajanje aplikacije XML v vrstični ključ

Pogosto uporabljene aplikacije dodajte linijskim tipkam, da bodo uporabniki zlahka dostopali do storitev.

Preden začnete

Aplikacijska storitev XML je pravilno konfigurirana.

1

Dostopite do spletne strani za upravljanje telefona.

2

Izberite Voice > Phone.

3

Izberite linijsko tipko.

4

Parameter Razširitev nastavite na Disabled, da onemogočite razširitev.

Če je funkcija neposredne konfiguracije PLK onemogočena, morate za dodajanje razširjene funkcije linijski tipki onemogočiti razširitev. Če je funkcija omogočena, lahko ta korak preskočite. Za podrobnosti glejte Omogočanje neposredne konfiguracije PLK.
5

V parameter Extended Function vnesite niz v tej obliki:

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

kjer je url povezava, kjer je shranjena aplikacija XML; 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 nastavite tudi v konfiguracijski datoteki (cfg.xml). Vnesite niz v tej obliki:

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

kjer je n številka razširitve.

6

Kliknite Shrani vse spremembe.

Podprte makrospremenljivke v URL-jih XML

V URL-jih XML lahko uporabite makrospremenljivke. Podprte so naslednje makro spremenljivke:

  • ID uporabnika-UID1, UID2 do UIDn

  • Ime zaslona - DISPLAYNAME1, DISPLAYNAME2 do DISPLAYNAMEn

  • ID avtentikacije - AUTHID1, AUTHID2 do AUTHIDn

  • Proxy-PROXY1, PROXY2 do PROXYn

  • Naslov MAC z uporabo malih šestnajstiških številk-MA

  • Ime izdelka-PN

  • Številka serije izdelkov-PSN

  • Serijska številka-SERIAL_NUMBER

Preglednica 2. Podprti makri
Ime makraRazširitev na makro
$Oblika $$$ se razširi na en sam znak $.
A do PNadomestijo jih parametri za splošne namene GPP_A do GPP_P.
SA do SDNadomestijo jih parametri za posebne namene GPP_SA do GPP_SD. V teh parametrih so shranjeni ključi ali gesla, ki se uporabljajo pri zagotavljanju.
$SA do $SD so prepoznani kot argumenti za izbirni kvalifikator URL ponovne sinhronizacije, --ključ.
MAnaslov MAC z malimi šestnajstiškimi številkami (000e08aabbcc).
MAUnaslov MAC z velikimi šestnajstiškimi številkami (000E08AABBCC).
MACnaslov MAC z uporabo malih šestnajstiških številk z dvopičjem za ločitev parov šestnajstiških številk (00:0e:08:aa:bb:cc).
PNIme izdelka; na primer videotelefon 8875, namizni telefon 9851.
PSNŠtevilka serije izdelkov; na primer 8875, 9841, 9861
SNNiz serijskih številk; na primer 88012BA01234.
CCERTStanje potrdila odjemalca SSL, je nameščeno ali ni nameščeno.
IPnaslov IP telefona v lokalnem podomrežju; na primer 192.168.1.100.
EXTIPZunanji naslov IP telefona, kot je viden v internetu; na primer 66.43.16.52.

SWVER

Niz različic programske opreme. Na primer,

PHONEOS.3-2-1-0104-37

HWVER

Niz različic strojne opreme. Na primer 2.0.1

PRVST

Stanje zagotavljanja (številčni niz):

-1 = izrecna zahteva za ponovno sinhronizacijo

0 = ponovna sinhronizacija ob vklopu

1 = periodična ponovna sinhronizacija

2 = ponovna sinhronizacija ni uspela, poskusite znova.

UPGST

Stanje nadgradnje (številčni niz):

1 = prvi poskus nadgradnje

2 = nadgradnja ni uspela, ponovite poskus

UPGERR

Sporočilo o rezultatu (ERR) prejšnjega poskusa nadgradnje; na primer http_get ni uspel.

PRVTMR

Sekunde od zadnjega poskusa ponovne sinhronizacije.

UPGTMR

Sekunde od zadnjega poskusa nadgradnje.

REGTMR1

Sekunde, odkar je linija 1 izgubila registracijo s strežnikom SIP.

REGTMR2

Sekunde, odkar je linija 2 izgubila registracijo s strežnikom SIP.

UPGCOND

Ime zapuščenega makra.

SHEMA

Shema dostopa do datoteke, ena od TFTP, HTTP ali HTTPS, ki jo dobite po razčlenitvi URL-ja ponovne sinhronizacije ali nadgradnje.

SERV

Zahtevajte ime gostitelja ciljnega strežnika, kot ga dobite po razčlenitvi URL-ja ponovne sinhronizacije ali nadgradnje.

SERVIP

Zahteva IP naslov ciljnega strežnika, ki ga dobi po razčlenitvi URL naslova ponovne sinhronizacije ali nadgradnje, po možnosti po poizvedbi DNS.

PORT

Ciljna vrata UDP/TCP za zahtevo, kot jih dobite po razčlenitvi URL za ponovno sinhronizacijo ali nadgradnjo.

PATH

Pot do ciljne datoteke, kot je bila pridobljena po razčlenitvi URL-ja ponovne sinhronizacije ali nadgradnje.

ERR

Sporočilo o rezultatu poskusa ponovne sinhronizacije ali nadgradnje. Uporabno samo pri ustvarjanju sporočil syslog z rezultati. Vrednost se ohrani v spremenljivki UPGERR v primeru poskusov nadgradnje.

UIDn

Vsebina konfiguracijskega parametra Line n UserID.

ISCUST

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

Stanje prilagajanja je vidno na informacijski strani spletnega uporabniškega vmesnika.

INCOMINGNAMEIme, povezano s prvim povezanim, zvonjenim ali dohodnim klicem.
REMOTENUMBER

Telefonska številka prvega povezanega, zvonkajočega ali dohodnega klica. Če je klicev več, so na voljo podatki, povezani s prvim najdenim klicem.

DISPLAYNAMEnVsebina konfiguracijskega parametra Line N Display Name.
AUTHIDnVsebina konfiguracijskega parametra Line N auth ID.