V tem članku
dropdown icon
Pregled
    Podprti predmeti XML
    Podprti URI-ji
Konfiguriranje telefona za povezavo s storitvijo XML
Parametri za storitve XML
Dodajanje aplikacije XML dinamični tipki
Dodajanje aplikacije XML v linijsko tipko
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 za 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 svoje storitve XSI s podprtimi predmeti XML in URI-ji.

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

Podprte funkcije so:

  • Sporočila (slike in besedilo)
  • Poziv

Podprti predmeti XML

  • CiscoIPPhoneMenu

  • CiscoIPPhoneText

  • CiscoIPPhoneInput

  • CiscoIPPhoneDirectory

  • CiscoIPPhoneImage

  • CiscoIPPhoneImageFile

  • CiscoIPPhoneIconMenu

  • CiscoIPPhoneIconFileMenu

  • CiscoIPPhoneStatus (razen 9811 in 9841)

  • Datoteka CiscoIPPhoneStatusFile (razen 9811 in 9841)

  • CiscoIPPhoneExecute

Podprti URI-ji

  • Naprava

  • Dial

  • UrediDail

  • Init

  • Ključ

  • Predvajaj (samo toni zvonjenja)

  • Dinamična tipka

Za 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 Service konfigurirajte parametre URL-ja storitve aplikacije XML 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: XML Uporabniško ime, XML Geslo, Cisco XML Omogoči EXE in Cisco XML Način preverjanja pristnosti EXE.

5

Kliknite Shrani vse spremembe.

Parametri za storitve XML

V spodnji tabeli sta opredeljeni funkcija in uporaba parametrov aplikacije XML v razdelku XML Service pod Voice > Phone Tab 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 aplikacije XML. Ime se na telefonu prikaže kot izbira spletne aplikacije.

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

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

XML URL aplikacijske storitve

Privzeto: Prazno

URL, kjer se nahaja aplikacija XML.

Ta parameter lahko konfigurirate tudi v datoteki konfiguracije telefona XML (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 makrospremenljivke glejte Spremenljivke makrov, podprte v URL-jih XML.

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 datoteki konfiguracije telefona XML (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 uporabniško ime XML.

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

<!-- <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 potrebno preverjanje pristnosti.

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

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

Cisco XML Način preverjanja pristnosti 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 aplikaciji XML na spletni strani (za dostop do aplikacijskega strežnika XML).

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

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

Dodajanje aplikacije XML v dinamično tipko

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

Preden začnete

Storitev aplikacije 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 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 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 aplikacije XML 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 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 zapisa:

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

kjer je n interna številka.

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 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 makra
$Obrazec $$$ se razširi na en znak $.
Od A do PNadomeščen s splošnimi parametri GPP_A do GPP_P.
SA do SDNadomeščen s parametri posebnega namena GPP_SA do GPP_SD. Ti parametri vsebujejo ključe ali gesla, ki se uporabljajo pri omogočanju uporabe.

$SA do $SD so prepoznani kot argumenti izbirnega kvalifikatorja URL-ja za ponovno sinhronizacijo, --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 certifikata odjemalca, nameščeno ali nenameščeno.
IPIP naslov telefona v lokalnem podomrežju; na primer 192.168.1.100.
NASVETZunanji IP-telefona, kot ga vidimo na internetu; na primer 66.43.16.52.

SWVER

Niz različic programske opreme. Primer:

PHONEOS.3-2-1-0104-37

HWVER

Niz različice strojne opreme. Primer: 2.0.1

PRVST

Stanje zagotavljanja rezervacije (številski niz):

-1 = izrecna zahteva za ponovno sinhronizacijo

0 = ponovna sinhronizacija vklopa

1 = periodična ponovna sinhronizacija

2 = ponovna sinhronizacija ni uspela, poskus ponovnega poskusa

UPGST

Stanje nadgradnje (številski niz):

1 = prvi poskus nadgradnje

2 = nadgradnja ni uspela, poskus ponovnega poskusa

UPGERR

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

PRVTMR

Sekunde od zadnjega poskusa vnovične sinhronizacije.

UPGTMR

Sekunde od zadnjega poskusa nadgradnje.

REGTMR1

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

REGTMR2

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

UPGCOND

Podedovano ime makra.

SHEMA

Shema dostopa do datotek, ena od TFTP, HTTP ali HTTPS, kot je bila pridobljena po razčlenjevanju URL-ja za vnovično sinhronizacijo ali nadgradnjo.

SERV

Zahtevajte ime gostitelja ciljnega strežnika, pridobljeno po razčlenitvi URL-ja za vnovično sinhronizacijo ali nadgradnjo.

SERVIP

Zahtevajte naslov IP ciljnega strežnika, kot ga pridobite po razčlenitvi URL-ja za ponovno sinhronizacijo ali nadgradnjo, po možnosti po iskanju DNS.

LUKA

Zahtevajte ciljna vrata UDP/TCP, kot jih pridobite po razčlenjevanju URL-ja za vnovično sinhronizacijo ali nadgradnjo.

STEZA

Zahtevajte pot ciljne datoteke, kot jo dobite po razčlenitvi URL-ja za vnovično sinhronizacijo ali nadgradnjo.

NAPAČNO

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

UIDn

Vsebina konfiguracijskega parametra Line n UserID.

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.
Ali je bil ta članek koristen?
Ali je bil ta članek koristen?