Tässä artikkelissa
dropdown icon
Yleiskatsaus
    Tuetut XML-objektit
    Tuetut URI:t
Määritä puhelin muodostamaan yhteyden XML-palveluun
XML-palveluiden parametrit
XML-sovelluksen lisääminen toimintonäppäimeen
XML-sovelluksen lisääminen rivinäppäimeen
XML-URL-osoitteissa tuetut makromuuttujat

XML-sovellusten kokoonpano 9800- ja 8875-puhelimille (BroadWorks)

list-menuTässä artikkelissa
list-menuOnko sinulla palautetta?

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 ja palvelu > Cisco XML -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 Ääni > Puhelin.

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 > Puhel in- 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.

Taulukko 1. XML-palveluiden parametrit

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_Application_Service_Name
ua="na">XML APP Name</XML_Application_Service_Name>

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:

<XML_Application_Service_URL
ua="na">https://server.com/path/app.xml</XML_Application_Service_URL>

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_User_Name ua="na">username</XML_User_Name>

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:

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

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_Enable ua="na">Yes</CISCO_XML_EXE_Enable>

CISCO XML EXE -todennustila

Oletus: Paikallinen tunnistetiedot

Vaihtoehdot: Luotettu, Paikallinen tunnistetiedot, Etätunnistetiedot

Määrittää Cisco XML EXE: n todennustilan.

  • Luotettu — todennusta ei suoriteta paikallisesta tunnistetiedosta riippumatta.

  • Paikalliset tunnistetiedot — Todennus perustuu yhteenvetotodennukseen, jossa käytetään paikallisia tunnistetietoja, jos se on määritetty. Jos paikallista tunnistetietoa ei ole määritetty, todennusta ei suoriteta.

  • Etätunnistetiedot — todennus perustuu yhteenvetotodistukseen, jossa käytetään WWW-sivun XML-sovelluksessa määritettyä etätunnistetietoa (XML-sovelluspalvelimen käyttämiseksi).

Voit myös määrittää tämän parametrin puhelimen kokoonpanon XML-tiedostossa (cfg.xml) kirjoittamalla merkkijonon tässä muodossa:

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

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 Ääni > Puhelin.

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:

<Programmable_Softkey_Enable ua="na">Yes</Programmable_Softkey_Enable>
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ä url on linkki, johon XML-sovellus on tallenn ettu; nme on sovelluksen näyttönimi puhelimen näytöllä.

Esimerkki fnc=xml; url = http://10.77.21.37/xmlapp/menu.xml;nme=Menu

Voit myös määrittää tämän parametrin määritystiedostossa (cfg.xml). Kirjoita merkkijono tässä muodossa:

<PSK_n ua="na">fnc=xml; url = http://10.77.21.37/xmlapp/menu.xml;nme=Menu</PSK_n> <configuration code>

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 Ääni > Puhelin.

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ä url on linkki, johon XML-sovellus on tallenn ettu; nme on sovelluksen näyttönimi puhelimen näytöllä.

Esimerkki fnc=xml; url = http://10.77.21.37/xmlapp/menu.xml;nme=Menu

Voit myös määrittää tämän parametrin määritystiedostossa (cfg.xml). Kirjoita merkkijono tässä muodossa:

<Extended_Function_n_ ua="na">fnc=xml; url = http://10.77.21.37/xmlapp/menu.xml;nme=Menu</Extended_Function_n_> <configuration code>

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

Taulukko 2. Tuetut makrot
Makron nimiMakrolaajennus
$Lomake $$ laajenee yhdeksi $ -merkiksi.
A - PKorvattu yleiskäyttöisillä parametreilla GPP_A GPP_P: n kautta.
SA SD: n kauttaKorvattu 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.

MAMAC-osoite pienillä heksadesimerkeillä (000e08aabbcc).
MAUMAC-osoite isoilla heksadesimerkeillä (000E08AABBCC).
MACMAC-osoite, jossa käytetään pieniä heksadesimerkkejä kaksoispisteellä hex-numeroparien erottamiseksi (00:0 e:08:aa:bb:cc).
PNTuotteen nimi; esimerkiksi videopuhelin 8875, pöytäpuhelin 9851.
PSNTuotesarjanumero; esimerkiksi 8875, 9841, 9861
SNSarjanumeron merkkijono; esimerkiksi 88012BA01234.
CCERTSSL-asiakasvarmenteen tila, asennettu tai ei asennettu.
IPPuhelimen IP-osoite paikallisessa aliverkossa; esimerkiksi 192.168.1.100.
EXTIPPuhelimen 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.

INCOMINGNAMEEnsimmä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önimiLine N Display Name -määritysparametrin sisältö.
AuthenticIDNLine N auth ID -määritysparametrin sisältö.
Oliko tästä artikkelista apua?
Oliko tästä artikkelista apua?