- Domov
- /
- Članek
XML za telefone 9800 in 8875 (BroadWorks)
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 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 . |
| 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 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.
|
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 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:
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:
|
|
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:
|
|
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 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.
Ta parameter lahko konfigurirate tudi v datoteki konfiguracije telefona XML (cfg.XML) tako, da vnesete niz v tej obliki:
|
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 . |
| 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:
|
| 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
Primer Ta parameter lahko konfigurirate tudi v konfiguracijski datoteki (cfg.XML). Vnesite niz v tej obliki zapisa:
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 . |
| 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
Primer Ta parameter lahko konfigurirate tudi v konfiguracijski datoteki (cfg.XML). Vnesite niz v tej obliki zapisa:
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
| Ime makra | Razširitev makra |
|---|---|
| $ | Obrazec $$$ se razširi na en znak $. |
| Od A do P | Nadomeščen s splošnimi parametri GPP_A do GPP_P. |
| SA do SD | Nadomešč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. |
| MA | MAC naslov z malimi šestnajstiškimi številkami (000e08aabbcc). |
| MAU | MAC naslov z velikimi šestnajstiškimi številkami (000E08AABBCC). |
| MAC | MAC naslov z malimi šestnajstiškimi številkami in dvopičjem za ločevanje šestnajstiških parov (00:0E:08:AA:bb:cc). |
| PN | Ime izdelka; na primer Video telefon 8875, Namizni telefon 9851. |
| PSN | številka serije izdelkov; Na primer 8875, 9841, 9861 |
| SN | Niz serijske številke; na primer 88012BA01234. |
| CCERT | SSL Stanje certifikata odjemalca, nameščeno ali nenameščeno. |
| IP | IP naslov telefona v lokalnem podomrežju; na primer 192.168.1.100. |
| NASVET | Zunanji 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 IME | Ime, 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 IMEn | Vsebina konfiguracijskega parametra prikaznega imena vrstice N. |
| AUTHIDn | Vsebina parametra konfiguracije ID-ja avte vrstice N. |