- Etusivu
- /
- Artikkeli
XML-sovellusten kokoonpano 9800- ja 8875-puhelimille (BroadWorks)
Tämä ohjeartikkeli koskee Cisco BroadWorks -palveluun rekisteröityjä Cisco Desk Phone 9800 -sarjaa ja Cisco Video Phone 8875 -puhelinta. Lue tässä artikkelissa tuetut XML-objektit, URI:t ja ohjeet XSI-palveluiden määrittämiseen puhelimen verkkosivulla.
Yleiskatsaus
XML-palveluiden käyttöliittymä (XSI) on protokolla, joka mahdollistaa viestinnän sovellusten ja puhelinjärjestelmän välillä. Voit lisätä omia XSI-palveluita puhelimeesi tuettujen X ML-objektien ja URI-osoitteiden avulla.
Kun olet tilannut puhelimen palveluihin, käyttäjät voivat käyttää kaikkia puhelimen määritettyjä palveluita siirtymällä kohtaan Asetukset > Verkko -palvelut. Cisco XML -palvelut ovat oletusnimi. Voit myös muuttaa nimeä. Voit helpottaa käyttäjien pääsyä lisäämällä XML-sovellukset ohjelmistonäppäimiin tai rivinäppäimiin.
Tuetut ominaisuudet ovat:
- Viestit (kuvat ja teksti)
- Sivunhaku
Tuetut XML-objektit
-
CiscoIpPhoneMenu
-
CiscoIPPhoneText
-
CiscoIPPhone-tulo
-
CiscoIPPhoneHakemisto
-
CiscoIPPhone-kuva
-
CiscoIPPhoneImageTiedosto
-
CiscoIPPhoneIconValikko
-
CiscoIPPhoneIconFileMenu
-
CiscoIPPhoneStatus (lukuun ottamatta 9811 ja 9841)
-
CiscoIPPhoneStatustiedosto (lukuun ottamatta 9811 ja 9841)
-
CiscoIPPhoneExecute
Tuetut URI:t
-
Laite
-
Kellotaulu
-
EditDail
-
Into
-
Avain
-
Toista (vain soittoäänet)
-
Ohjelmistonäppäin
Lisätietoja XSI-palvelun määrityksistä on artikkelissa Cisco Unified IP Phone Services Application Development Notes.
Määritä puhelin muodostamaan yhteyden XML-palveluun
| 1 |
Siirry puhelimen hallinnan verkkosivulle. |
| 2 |
Valitse . |
| 3 |
Määritä XML-palvel u-osiossa XML-sovelluspalvelun nimi- ja XML-sovelluspalvelun URL- osoitteen parametrit XML-palveluiden parametrien mukaisesti. |
| 4 |
(Valinnainen) Jos haluat lisätä todennuksen sovelluspalvelun käyttämiseen, määritä nämä kentät: XML-käyttäjänimi, XML-salasana, CISCO XML EXE Enable ja CISCO XML EXE Auth -tila. |
| 5 |
Valitse Tallenna kaikki muutokset. |
XML-palveluiden parametrit
Seuraavassa taulukossa määritellään XML-sovellusparametrien toiminta ja käyttö puhelimen verkkoli ittymän Ääni välilehden XML-palvelu -osiossa. Se määrittelee myös merkkijonon syntaksin, joka lisätään puhelimen määritystiedostoon (cfg.xml) XML-koodilla parametrin määrittämiseksi.
|
Parametri |
Oletus ja asetukset |
Kuvaus |
|---|---|---|
|
XML-sovelluspalvelun nimi |
Oletus: Tyhjä |
XML-sovelluksen nimi. Nimi näkyy puhelimessa verkkosovellusvaihtoehtona. Voit myös määrittää tämän parametrin puhelimen kokoonpanon XML-tiedostossa (cfg.xml) kirjoittamalla merkkijonon tässä muodossa:
|
|
XML-sovelluspalvelun URL-osoite |
Oletus: Tyhjä |
URL-osoite, jossa XML-sovellus sijaitsee. Voit myös määrittää tämän parametrin puhelimen kokoonpanon XML-tiedostossa (cfg.xml) kirjoittamalla merkkijonon tässä muodossa:
Makromuuttujia tuetaan XML-URL-osoitteissa. Kelvolliset makromuuttujat on ohjeaiheessa XML-URL-osoitteissa tuetut makromuuttujat. URL-osoite tukee vain HTTP- tai HTTPS-protokollia. |
|
XML-käyttäjänimi |
Oletus: Tyhjä |
XML-palvelun käyttäjänimi todennustarkoituksiin. Voit myös määrittää tämän parametrin puhelimen kokoonpanon XML-tiedostossa (cfg.xml) kirjoittamalla merkkijonon tässä muodossa:
|
|
XML-salasana |
Oletus: Tyhjä |
XML-palvelun salasana määritetylle XML-käyttäjänimelle. Tähän kenttään antamasi salasana näkyy määritystiedostossa (cfg.xml) seuraavasti:
|
|
CISCO XML EXE Ota käyttöön |
Oletus: Ei Vaihtoehdot: Kyllä, Ei |
Määrittää, vaaditaanko todennusta XML-sovelluspalvelimen käyttämiseen. Voit myös määrittää tämän parametrin puhelimen kokoonpanon XML-tiedostossa (cfg.xml) kirjoittamalla merkkijonon tässä muodossa:
|
|
CISCO XML EXE -todennustila |
Oletus: Paikallinen tunnistetiedot Vaihtoehdot: Luotettu, Paikallinen tunnistetiedot, Etätunnistetiedot |
Määrittää Cisco XML EXE: n todennustilan.
Voit myös määrittää tämän parametrin puhelimen kokoonpanon XML-tiedostossa (cfg.xml) kirjoittamalla merkkijonon tässä muodossa:
|
XML-sovelluksen lisääminen toimintonäppäimeen
Lisää usein käytetyt sovellukset ohjelmistonäppäimiin, jotta käyttäjät voivat käyttää palvelua helposti.
Ennen kuin aloitat
XML-sovelluspalvelu on määritetty oikein.
| 1 |
Siirry puhelimen hallinnan verkkosivulle. |
| 2 |
Valitse . |
| 3 |
Aseta Ohjelmoitavat toimintonäppäimet - osiossa Ohjel moitava toimintonäppäin Ota käyttöön -arvoksi Kyllä. Voit myös määrittää tämän parametrin määritystiedostossa (cfg.xml). Kirjoita merkkijono tässä muodossa:
|
| 4 |
Muokkaa Ohjel moitavat ohjelmist onäppäimet -osiossa PSK1- PSK16:n käytettävissä olevat kentät tässä muodossa: fnc=xml;url=<xml_app_path>;nme=<app_name>
missä
Esimerkki
Voit myös määrittää tämän parametrin määritystiedostossa (cfg.xml). Kirjoita merkkijono tässä muodossa:
missä n on näppäinnumero. |
| 5 |
Valitse Tallenna kaikki muutokset. |
XML-sovelluksen lisääminen rivinäppäimeen
Lisää usein käytetyt sovellukset rivinäppäimiin, jotta käyttäjät voivat käyttää palveluita helposti.
Ennen kuin aloitat
XML-sovelluspalvelu on määritetty oikein.
| 1 |
Siirry puhelimen hallinnan verkkosivulle. |
| 2 |
Valitse . |
| 3 |
Valitse rivinäppäin. |
| 4 |
Poista laaj ennus käytöstä asettamalla laajennusparametrin asetukseksi Pois käytöstä. Jos Direct PLK Configuration -ominaisuus on poistettu käytöstä, sinun on poistettava laajennus käytöstä lisätäksesi laajennetun toiminnon rivinäppäimeen. Jos ominaisuus on käytössä, voit ohittaa tämän vaiheen. Lisätietoja on kohdassa Suoran PLK-määrityksen ottaminen käyttöön. |
| 5 |
Kirjoita Extended Function -parametriin merkkijono tässä muodossa: fnc=xml;url=<xml_app_path>;nme=<app_name>
missä
Esimerkki
Voit myös määrittää tämän parametrin määritystiedostossa (cfg.xml). Kirjoita merkkijono tässä muodossa:
missä n on laajennusnumero. |
| 6 |
Valitse Tallenna kaikki muutokset. |
XML-URL-osoitteissa tuetut makromuuttujat
Voit käyttää makromuuttujia XML-URL-osoitteissa. Seuraavia makromuuttujia tuetaan:
-
Käyttäjätunnus — UID1, UID2 - UIDn
-
Näyttönimi — DisplayName1, DISPLAYNAME2 - DisplayNamen
-
Autentisointitunnus — AUTHID1, AUTHID2 - AuthIDN
-
Proxy—Proxy1, PROXY2 ProxyN
-
MAC-osoite pienillä heksadesimerkeillä — MA
-
Tuotenimi—PN
-
Tuotesarjanumero — PSN
-
Sarjanumero — Sarjanumero
| Makron nimi | Makrolaajennus |
|---|---|
| $ | Lomake $$ laajenee yhdeksi $ -merkiksi. |
| A - P | Korvattu yleiskäyttöisillä parametreilla GPP_A GPP_P: n kautta. |
| SA SD: n kautta | Korvattu erikoisparametreilla GPP_SA GPP_SD: n kautta. Näissä parametre
issa on avaimet tai salasanat, joita käytetään valmistelussa. $SA—$SD tunnistetaan valinnaisen uudelleensynkronoinnin URL- määrityksen, --key, argumenteina. |
| MA | MAC-osoite pienillä heksadesimerkeillä (000e08aabbcc). |
| MAU | MAC-osoite isoilla heksadesimerkeillä (000E08AABBCC). |
| MAC | MAC-osoite, jossa käytetään pieniä heksadesimerkkejä kaksoispisteellä hex-numeroparien erottamiseksi (00:0 e:08:aa:bb:cc). |
| PN | Tuotteen nimi; esimerkiksi videopuhelin 8875, pöytäpuhelin 9851. |
| PSN | Tuotesarjanumero; esimerkiksi 8875, 9841, 9861 |
| SN | Sarjanumeron merkkijono; esimerkiksi 88012BA01234. |
| CCERT | SSL-asiakasvarmenteen tila, asennettu tai ei asennettu. |
| IP | Puhelimen IP-osoite paikallisessa aliverkossa; esimerkiksi 192.168.1.100. |
| EXTIP | Puhelimen ulkoinen IP, kuten Internetissä nähdään; esimerkiksi 66.43.16.52. |
|
SWVER |
Ohjelmistoversion merkkijono. Esimerkiksi PHONEOS.3-2-1-0104-37 |
|
HWVER |
Laitteiston version merkkijono. Esimerkiksi 2.0.1 |
|
PRVST |
Provisionin tila (numeerinen merkkijono): -1 = eksplisiittinen uudelleensynkronointipyyntö 0 = käynnistyksen uudelleensynkronointi 1 = jaksollinen uudelleensynkronointi 2 = uudelleensynkronointi epäonnistui, yritä uudelleen |
|
UPGST |
Päivitystila (numeerinen merkkijono): 1 = ensimmäinen päivitysyritys 2 = päivitys epäonnistui, yritä uudelleen |
|
UPGERR |
Edellisen päivitysyrityksen tulosviesti (ERR); esimerkiksi http_get epäonnistui. |
|
PRVTMR |
Sekunteja edellisestä uudelleensynkronointiyrityksestä. |
|
UPGTMR |
Sekunteja viimeisestä päivitysyrityksestä. |
|
REGTMR1 |
Sekunteja siitä, kun rivi 1 menetti rekisteröinnin SIP-palvelimelle. |
|
REGTMR2 |
Sekunteja siitä, kun linja 2 menetti rekisteröinnin SIP-palvelimelle. |
|
UPGCOND |
Vanhan makron nimi. |
|
SCHEME |
Tiedostojen käyttöjärjestelmä, yksi TFTP-, HTTP- tai HTTPS-tiedostoista, sellaisena kuin se on saatu uudelleensynkronoinnin tai päivitysURL-osoitteen jäsentämisen jälkeen. |
|
SERV |
Pyydä kohdepalvelimen isäntänimeä, joka on saatu uudelleensynkronoinnin tai päivitysURL-osoitteen jäsentämisen jälkeen. |
|
SERVIP |
Pyydä kohdepalvelimen IP-osoitetta, joka on saatu uudelleensynkronoinnin tai päivitysURL-osoitteen jäsentämisen jälkeen, mahdollisesti DNS-haun jälkeen. |
|
PORT |
Pyydä kohde-UDP/TCP-porttia, joka on saatu uudelleensynkronoinnin tai päivitysURL-osoitteen jäsentämisen jälkeen. |
|
PATH |
Pyydä kohdetiedoston polkua, joka on saatu uudelleensynkronoinnin tai päivitysURL-osoitteen jäsentämisen jälkeen. |
|
ERR |
Uudelleensynkronointi- tai päivitysyrityksen tulosviesti. Hyödyllinen vain tulosten syslog-viestien luomisessa. Arvo säilyy UPGERR-muuttujassa päivitysyritysten tapauksessa. |
|
UIDn |
Line n UserId -määritysparametrin sisältö. |
| ISCUST |
Jos yksikkö on mukautettu, arvo = 1, muuten 0. Mukautustila on nähtävissä Web UI Info -sivulla. |
| INCOMINGNAME | Ensimmäiseen yhdistettyyn, soittavaan tai saapuvaan puheluun liittyvä nimi. |
| REMOTENUMBER |
Ensimmäisen yhdistetyn, soivan tai saapuvan puhelun puhelinnumero. Jos puheluita on useita, annetaan ensimmäiseen löydettyyn puheluun liittyvät tiedot. |
| Näyttönimi | Line N Display Name -määritysparametrin sisältö. |
| AuthenticIDN | Line N auth ID -määritysparametrin sisältö. |