- Domov
- /
- Članek
Konfiguracija aplikacij XML za telefone v sistemu BroadWorks
Ta članek pomoči velja za telefona Cisco Desk Phone 9800 Series in Cisco Video Phone 8875, ki sta registrirana v Cisco BroadWorks. V tem članku so navedeni podprti objekti XML, URI in koraki za konfiguriranje storitev XSI na spletni strani telefona.
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
. 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 . |
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 v spletnem vmesniku telefona. Opredeljuje tudi sintakso niza, ki se doda v konfiguracijsko datoteko telefona (cfg.xml) s kodo XML za konfiguracijo parametra.
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:
|
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:
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:
|
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:
|
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:
|
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.
Ta parameter lahko nastavite tudi v datoteki XML za konfiguracijo telefona (cfg.xml) z vnosom niza v tej obliki:
|
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 . |
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:
|
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
Ta parameter lahko nastavite tudi v konfiguracijski datoteki (cfg.xml). Vnesite niz v tej obliki:
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 . |
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
Ta parameter lahko nastavite tudi v konfiguracijski datoteki (cfg.xml). Vnesite niz v tej obliki:
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
Ime makra | Razširitev na makro |
---|---|
$ | Oblika $$$ se razširi na en sam znak $. |
A do P | Nadomestijo jih parametri za splošne namene GPP_A do GPP_P. |
SA do SD | Nadomestijo 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č. |
MA | naslov MAC z malimi šestnajstiškimi številkami (000e08aabbcc). |
MAU | naslov MAC z velikimi šestnajstiškimi številkami (000E08AABBCC). |
MAC | naslov MAC z uporabo malih šestnajstiških številk z dvopičjem za ločitev parov šestnajstiških številk (00:0e:08:aa:bb:cc). |
PN | Ime izdelka; na primer videotelefon 8875, namizni telefon 9851. |
PSN | Številka serije izdelkov; na primer 8875, 9841, 9861 |
SN | Niz serijskih številk; na primer 88012BA01234. |
CCERT | Stanje potrdila odjemalca SSL, je nameščeno ali ni nameščeno. |
IP | naslov IP telefona v lokalnem podomrežju; na primer 192.168.1.100. |
EXTIP | Zunanji 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. |
INCOMINGNAME | Ime, 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. |
DISPLAYNAMEn | Vsebina konfiguracijskega parametra Line N Display Name. |
AUTHIDn | Vsebina konfiguracijskega parametra Line N auth ID. |