V tem članku
dropdown icon
Pregled
    Podprti predmeti XML
    Podprti URI-ji
Konfigurirajte telefon za povezavo s storitvijo XML
Parametri za storitve XML
Dodajte aplikacijo XML v programsko tipko
Dodajte aplikacijo XML v vrsticni ključ
Makro spremenljivke, podprte v URL-jih XML

Konfiguracija aplikacij XML za telefone 9800 in 8875 (BroadWorks)

list-menuV tem članku
list-menuPovratne informacije?

Ta članek pomoči velja za Cisco Desk Phone 9800 Series in Cisco Video Phone 8875, ki sta registrirana na Cisco BroadWorks. Preberite ta članek za podprte predmete XML, URI-je in korake za konfiguriranje storitev XSI na spletni strani telefona.

Pregled

XML Services Interface (XSI) je protokol, ki omogoča komunikacijo med aplikacijami in telefonskim sistemom. V telefon lahko dodate lastne storitve XSI s pomočjo podprtih predmetov XML in URI-jev.

Po naročilu telefona na storitve lahko uporabniki dostopajo do vseh konfiguriranih storitev v telefonu tako, da se pomaknejo na Nastavitve > Om režje in storitev > Storitve Cisco XML. Storitve Cisco XML so privzeto ime. Spremenite lahko tudi ime. Če želite uporabnikom omogočiti enostaven dostop, lahko aplikacije XML dodate v programske tipke ali vrstične tipke.

Podprte funkcije so:

  • Sporočila (slike in besedilo)
  • Paging

Podprti predmeti XML

  • CiscoipPhoneMenu

  • CiscoipphoneNaslednji

  • CiscoipPhoneInput

  • CISCOIPPhoneImenik

  • CiscoipPhoneImage

  • CISCOIPPhoneSlikovna datoteka

  • CiscoipPhoneIkonmeni

  • CiscoipPhoneIconIme datoteke

  • CiscoipPhoneStatus (razen 9811 in 9841)

  • CISCOIPPhonEstatusFile (razen 9811 in 9841)

  • CiscoipPhoneIzvedite

Podprti URI-ji

  • Naprava

  • Pokličite

  • UrediDail

  • Init

  • Ključ

  • Predvajanje (samo melodije zvonjenja)

  • Softkey

Če želite več podrobnosti o konfiguraciji storitve XSI, glejte Opombe za razvoj aplikacij Cisco Unified IP Phone Services.

Konfigurirajte telefon za povezavo s storitvijo XML

1

Dostopite do spletne strani za upravljanje telefona.

2

Izberite Glas > Telefon.

3

V razdelku Storitev XML konfigurirajte ime storitve XML in URL parametrov XML Application Service, kot so opredeljeni v Parametri za storitve XML.

4

(Neobvezno) Če želite dodati preverjanje pristnosti za dostop do aplikacijske storitve, konfigurirajte ta polja: XML uporabniško ime, geslo XML, CISCO XML EXE En able in CISCO XML EXE Auth Mo de.

5

Kliknite Shrani vse spremembe.

Parametri za storitve XML

Naslednja tabela določa funkcijo in uporabo parametrov aplikacije XML v razdelku XML Service pod zavihkom G las > Telefon v spletnem vmesniku telefona. Določa tudi sintakso niza, ki je dodan v konfiguracijski datoteki telefona (cfg.xml) s kodo XML za konfiguriranje parametra.

Tabela 1. Parametri za storitve XML

Parameter

Privzeto in možnosti

Opis

Ime storitve XML aplikacije

Privzeto: Prazno

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

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

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

URL storitve aplikacij XML

Privzeto: Prazno

URL, kjer se nahaja aplikacija XML.

Ta parameter lahko konfigurirate tudi v datoteki XML konfiguracije telefona (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 URL-jih XML. Za veljavne spremenljivke makrov glejte Spremenljiv ke makrov, podprte v URL-jih XML.

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

XML uporabniško ime

Privzeto: Prazno

Uporabniško ime storitve XML za namene preverjanja pristnosti.

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

<XML_User_Name ua="na">username</XML_User_Name>

XML geslo

Privzeto: Prazno

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 na naslednji način:

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

CISCO XML EXE Omogoči

Privzeto: Ne

Možnosti: Da, Ne

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

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

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

Način avtorizacije CISCO XML EXE

Privzeto: lokalna poverilnica

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

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

  • Zaupno — preverjanje pristnosti se ne izvaja ne glede na lokalno poverilnico.

  • Lokalna poverilnica — preverjanje pristnosti temelji na povzetku preverjanja pristnosti z uporabo lokalnih poverilnic, če je nastavljena. Če lokalna poverilnica ni nastavljena, se preverjanje pristnosti ne izvede.

  • Oddaljena poverilnica — preverjanje pristnosti temelji na povzetku preverjanja pristnosti z uporabo oddaljene poverilnice, ki je nastavljena v aplikaciji XML na spletni strani (za dostop do strežnika aplikacij XML).

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

<CISCO_XML_EXE_Auth_Mode ua="na">Local Credential</CISCO_XML_EXE_Auth_Mode>

Dodajte aplikacijo XML v programsko tipko

Pogosto uporabljene aplikacije dodajte v programske tipke, da uporabniki lažje dostopajo do storitve.

Preden začnete

Aplikacijska storitev XML je pravilno konfigurirana.

1

Dostopite do spletne strani za upravljanje telefona.

2

Izberite Glas > Telefon.

3

V razdelku Programabilne programirane programske tip ke nastavite možnost Programmable Softkey Enable na Da.

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

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

V razdelku Programabilne programirane programske tip ke uredite razpoložljiva polja PSK1 do PSK 16 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 konfigurirate 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</PSK_n> <configuration code>

kjer je n številka programske tipke.

5

Kliknite Shrani vse spremembe.

Dodajte aplikacijo XML v vrsticni ključ

Dodajte pogosto uporabljene aplikacije v vrstične tipke, da uporabniki lažje dostopajo do storitev.

Preden začnete

Aplikacijska storitev XML je pravilno konfigurirana.

1

Dostopite do spletne strani za upravljanje telefona.

2

Izberite Glas > Telefon.

3

Izberite tipko vrstice.

4

Če želite onemogo čiti razširitev, nastav ite parameter Extension na Onemogočeno.

Če je funkcija Direct PLK Configuration onemogočena, morate razširitev onemogočiti, da dodate razširjeno funkcijo vrstici tipki. Če je funkcija omogočena, lahko ta korak preskočite. Za podrobnosti glejte O mogočanje neposredne konfiguracije PLK.
5

V parameter Extended Fun ction 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 konfigurirate 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</Extended_Function_n_> <configuration code>

kjer je n številka razširitve.

6

Kliknite Shrani vse spremembe.

Makro spremenljivke, podprte v URL-jih XML

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

  • ID uporabnika — UID1, UID2 v UIDn

  • Prikazno ime — DisplayName1, DISPLAYNAME2 v DisplayNamen

  • ID avtiranja — AUTHID1, AUTHID2 v AuthIDN

  • Proxy—Proxy1, PROXY2 v ProxyN

  • MAC naslov z majhnimi šesterokotnimi številkami-MA

  • Ime izdelka—PN

  • Številka serije izdelka - PSN

  • Serijska številka - Serial_number

Tabela 2. Podprti makri
Ime makraMakro razširitev
$Obrazec $$ se razširi na en sam znak $.
A do PNadomeščen s splošnimi parametri GPP_A prek GPP_P.
SA prek SDNadomeščen s posebnimi parametri GPP_SA prek GPP_SD. Ti parametri vsebujejo ključe ali gesla, ki se uporabljajo pri zagotavljanju.

$SA do $SD so prepoznani kot argumenti izbirnega kvalifikatorja URL-ja za ponovno sinhronizacijo, --key.

MAMAC naslov z majhnimi šesterokostnimi številkami (000e08aab bcc).
MAUMAC naslov z velikimi šesterokostnimi številkami (000E08AABBCC).
MACMAC naslov z majhnimi šesterokostnimi številkami z dvojico za ločevanje šesterokostnih parov (00:0 e:08:aa:bb:cc).
PNIme izdelka; na primer Video telefon 8875, namizni telefon 9851.
PSNŠtevilka serije izdelka; na primer 8875, 9841, 9861
SNNiz serijske številke; na primer 88012BA01234.
CCERTStanje potrdila odjemalca SSL, nameščeno ali ni nameščeno.
IPIP naslov telefona znotraj njegovega lokalnega podomrežja; na primer 192.168.1.100.
EXTIPZunanji IP telefona, kot je razvidno na internetu; na primer 66.43.16.52.

SWVER

Niz različice programske opreme. Na primer,

PHONEOS.3-2-1-0104-37

HWVER

Niz različice strojne opreme. Na primer, 2.0.1

PRVST

Stanje zagotavljanja (številski niz):

-1 = eksplicitna zahteva za ponovno sinhronizacijo

0 = ponovna sinhronizacija vklopa

1 = periodična ponovna sinhronizacija

2 = ponovna sinhronizacija ni uspela, poskusite znova

UPGST

Stanje nadgradnje (številski niz):

1 = prvi poskus nadgradnje

2 = nadgradnja ni uspela, poskusite znova

UPGERR

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

PRVTMR

Sekunde od zadnjega poskusa ponovne sinhronizacije.

UPGTMR

Sekunde od zadnjega poskusa nadgradnje.

REGTMR1

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

REGTMR2

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

UPGCOND

Zapuščeno ime makra.

SCHEME

Shema dostopa do datotek, ena od TFTP, HTTP ali HTTPS, kot je pridobljena po razčlenitvi ponovne sinhronizacije ali nadgradnje URL-ja.

SERV

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

SERVIP

Zahtevajte naslov IP ciljnega strežnika, pridobljen po razčlenjevanju ponovne sinhronizacije ali nadgradnje URL-ja, po možnosti po iskanju DNS.

PORT

Zahtevajte ciljna vrata UDP/TCP, kot so pridobljena po razčlenjevanju ponovne sinhronizacije ali nadgradnje URL-ja.

PATH

Zahtevajte pot ciljne datoteke, kot jo dobite po razčlenitvi ponovne sinhronizacije ali nadgradnje URL-ja.

ERR

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

UIDn

Vsebina konfiguracijskega parametra Line n userId.

ISCUST

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

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

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

Telefonska številka prvega povezanega, zvonjenja ali dohodnega klica. Če je klicev več, so navedeni podatki, povezani s prvim najdenim klicem.

DisplayNameVsebina konfiguracijskega parametra Line N Display Name.
AuthidNVsebina konfiguracijskega parametra Line N auth ID.
Ali je bil ta članek koristen?
Ali je bil ta članek koristen?