Yleiskatsaus

XML Services Interface (XSI) on protokolla, joka mahdollistaa sovellusten ja puhelinjärjestelmän välisen viestinnän. Voit lisätä puhelimeesi omia XSI-palveluita tuettujen XML objektien ja URI:en avulla.

Kun puhelin on tilattu palveluihin, käyttäjät voivat käyttää kaikkia puhelimen määritettyjä palveluita siirtymällä Asetuksiin > Networkiin ja palveluun > Cisco XML -palveluihin . Cisco XML -palvelut ovat oletusnimi. Voit myös muuttaa nimeä. Voit helpottaa käyttäjien käyttöä lisäämällä XML sovellukset toimintonäppäimiin tai linja-avaimiin.

Tuetut ominaisuudet ovat:

  • Viestit (kuvat ja teksti)
  • Sivutus

Tuetut XML objektit

  • CiscoIPPhoneMenu

  • CiscoIPPhoneText

  • CiscoIPPhoneInput

  • CiscoIPPhoneDirectory

  • CiscoIPPhoneImage

  • CiscoIPPhoneImageFile

  • CiscoIPPhoneIconMenu

  • CiscoIPPhoneIconFileMenu

  • CiscoIPPhoneStatus (paitsi 9841)

  • CiscoIPPhoneStatusFile (paitsi 9841)

  • CiscoIPPhoneExvaloute

Tuetut URI:t

  • Laite

  • Kellotaulu

  • Muokkaa -aihi

  • Init

  • Avain

  • Toista (vain soittoäänet)

  • Toimintonäppäin

Lisätietoja XSI-palvelun määrityksistä on kohdassa Cisco Unified IP Phone Palvelut-sovelluksen kehittämistä koskevat huomautukset.

Puhelimen määrittäminen muodostamaan yhteys XML-palveluun

1

Siirry puhelimen hallintaverkkosivulle.

2

Valitse Puheposti > puhelin.

3

Määritä XML Service - osassa XML Sovelluspalvelun nimi - ja XML Sovelluspalvelun URL-parametrit sellaisiksi, jotka on määritetty XML palvelujen parametreissa .

4

(Valinnainen) Voit lisätä sovelluspalvelun todennuksen määrittämällä kentät: XML käyttäjänimi, XML salasana, CISCO XML EXE käyttöön ja CISCO XML EXE -todennustila.

5

Valitse Tallenna kaikki muutokset.

XML-palvelujen parametrit

Seuraavassa taulukossa määritetään puhelimen Web-käyttöliittymän Voice>Phone -välilehden XML-palvelun XML sovellusparametrien toiminta ja käyttö. Se määrittää myös puhelimen määritystiedostoon (cfg.xml) lisätyn merkkijonon syntaksin, jossa on XML koodi parametrin määrittämiseksi.

Taulukko 1. XML-palvelujen parametrit

Parametri

Oletus ja asetukset

Kuvaus

XML sovelluspalvelun nimi

Oletus: tyhjä

XML-sovelluksen nimi. Nimi näkyy puhelimessa Web-sovelluksen valintana.

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

<XML_Application_Service_Name ua="na">XML APP-nimi</XML_Application_Service_Name>

XML Sovelluspalvelun URL

Oletus: tyhjä

URL, jossa XML-sovellus sijaitsee.

Voit määrittää tämän parametrin myös puhelimen 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>

Makromuuttujat ovat tuettuja XML URL-osoitteissa. Kelvollisia makromuuttujia on kohdassa Makromuuttujat, joita tuetaan XML URL-osoitteissa.

URL-osoite tukee vain HTTP- tai HTTP-protokollia.

XML-käyttäjänimi

Oletus: tyhjä

XML palvelun käyttäjänimeä todennustarkoituksia varten.

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

<XML_User_Name ua="na">username</XML_User_Name>

XML-salasana

Oletus: tyhjä

XML määritetylle XML käyttäjänimelle palvelun salasana.

Tähän kenttään annettu salasana näkyy määritystiedostossa (cfg.xml) seuraavasti:

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

CISCO XML EXE käytössä

Oletus: Ei

Asetukset: Kyllä, Ei

Määrittää, tarvitaanko XML-sovelluspalvelimen käyttäminen todennusta.

Voit määrittää tämän parametrin myös puhelimen 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 tunnistetieto

Asetukset: Luotettu, Paikallinen tunnistetieto, Etätunnistetieto

Määrittää Cisco XML EXE -ohjelman todennustilan.

  • Luotettu – Todennusta ei suoriteta paikallisesta tunnistetietosta riippumatta.

  • Paikallinen tunnistetieto – Todennus perustuu koontitodennukseen paikallisella tunnistetiedoilla, jos se on asetettu. Jos paikallista tunnistetietoa ei ole asetettu, todennusta ei suoriteta.

  • Etätunnistetieto – Todennus perustuu koontitodennukseen etätunnistetiedoilla Kuten Web-sivun XML -sovelluksessa on määritetty (XML-sovelluspalvelimen käyttäminen).

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

<CISCO_XML_EXE_Auth_Mode ua="na">Local-tunnistetieto</CISCO_XML_EXE_Auth_Mode>

XML-sovelluksen lisääminen toimintonäppäimeen

Lisää usein käytetyt sovellukset toimintonäppäimiin, jotta käyttäjät voivat käyttää palvelua helposti.

Ennen aloittamista

XML-sovelluspalvelu on määritetty oikein.

1

Siirry puhelimen hallintaverkkosivulle.

2

Valitse Puheposti > puhelin.

3

Määritä Ohjelmoitavat toimintonäppäimet -osassa Ohjelmoitava toimintonäppäin käyttöön - kyllä.

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

<Programmable_Softkey_Enable ua="na">Yes</Programmable_Softkey_Enable>
4

Muokkaa PSK1-PSK1-PSK16-kenttien ohjelmoitavissa olevia toimintonäppäimiä tässä muodossa:

fnc=xml;url=<xml_app_path>; nme=<app_name>

missä URL on linkki, jossa XML-sovellus on tallennettu; nme on sovelluksen näyttönimi puhelimen näytössä.

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

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

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

jossa n on toimintonäppäinnumero.

5

Valitse Tallenna kaikki muutokset.

XML-sovelluksen lisääminen linjanäppäintä varten

Lisää usein käytetyt sovellukset linja-avaimiin, jotta käyttäjät voivat käyttää palveluita helposti.

Ennen aloittamista

XML-sovelluspalvelu on määritetty oikein.

1

Siirry puhelimen hallintaverkkosivulle.

2

Valitse Puheposti > puhelin.

3

Valitse linjanäppäin.

4

Poista alanumero käytöstä määrittämällä alanumeron parametriksi Ei käytössä .

Jos Direct PLK Configuration -toiminto on poistettu käytöstä, alanumero on poistettava käytöstä, jotta voit lisätä linjanäppäimeen laajennetun toiminnon. Jos ominaisuus on käytössä, voit ohittaa tämän vaiheen. Lisätietoja on kohdassa Direct PLK -määritysten käyttöönotto.
5

Anna merkkijono laajennetun toiminnon parametrissa seuraavassa muodossa:

fnc=xml;url=<xml_app_path>; nme=<app_name>

missä URL on linkki, jossa XML-sovellus on tallennettu; nme on sovelluksen näyttönimi puhelimen näytössä.

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

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

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

jossa n on alanumero.

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 kohteeseen DISPLAYNAMEn

  • Tod.tunnus – AUTHID1, AUTHID2 kohteeseen AUTHIDn

  • Välityspalvelin – PROXY1, PROXY2 to PROXYn

  • MAC osoite käyttäen pieniä heksanumeroita – MA

  • Tuotteen nimi – luettelonumero

  • Tuotesarjan numero – PSN

  • Sarjanumero – SERIAL_NUMBER

Taulukko 2. Tuetut makrot
Makron nimiMakrolaajennus
$Lomake $$ kasvaa yhteen $ merkkiin.
A–PKorvattu yleisluont. parametreilla, jotka GPP_A GPP_P.
SA–SDKorvautuvat erikoisparametrien GPP_SA–GPP_SD sisällöillä. Nämä parametrit sisältävät valmistelussa käytetyt avaimet tai salasanat.
$SA–$SD tunnistetaan valinnaisen uudelleensynkronoinnin URL-tarkenteen --key argumenteiksi.
MAMAC osoite käyttäen pieniä heksanumeroita (000e08aabbcc).
MAUMAC osoite käyttäen isoja heksanumeroita (000E08AABBCC).
MACMAC osoite käyttäen pieniä heksanumeroita, joiden kaksoispiste erottaa heksanumeroparit (00:0e:08:aa:bb:cc).
PNTuotteen nimi; Esimerkiksi videopuhelin 8875, pöytäpuhelin 9851.
PSNTuotesarjan numero; Esimerkiksi 8875, 9841, 9861
SNSarjanumeromerkkijono; esimerkiksi 88012BA01234.
CCERTSSL asiakasvarmenteen tila, asennettu tai asentamatta.
IPPuhelimen IP osoite sen paikallisessa aliverkossa. Esimerkiksi 192.168.1.100.
EXTIPPuhelimen ulkoiset IP, kuten Internetissä näkyy; esimerkiksi 66.43.16.52.

SWVER

Ohjelmistoversio. Esimerkki:

PHONEOS.3-2-1-0104-37

HWVER

Laiteversio. Esimerkiksi 2.0.1

PRVST

Valmistelutila (numero merkkijonona):

-1 = erillinen uudelleensynkronointipyyntö

0 = uudelleensynkronointi päälle kytkettäessä

1 = säännöllinen uudelleensynkronointi

2 = uudelleensynkronointi epäonnistunut, uudelleenyritetään

UPGST

Päivitystila (numero merkkijonona):

1 = ensimmäinen päivitysyritys

2 = päivitys epäonnistui, uusi yritys

UPGERR

Edellisen päivitysyrityksen tulosviesti (ERR), esimerkiksi "http_get failed".

PRVTMR

Edellisestä uudelleensynkronointiyrityksestä kulunut aika sekunteina.

UPGTMR

Edellisestä päivitysyrityksestä kulunut aika sekunteina.

REGTMR1

Linjan 1 SIP-palvelinrekisteröinnin menettämisestä kulunut aika sekunteina.

REGTMR2

Linjan 2 SIP-palvelinrekisteröinnin menettämisestä kulunut aika sekunteina.

UPGCOND

Vanhan version mukainen makronimi.

SCHEME

Tiedostonsiirtoprotokolla. TFTP, HTTP tai HTTPS uudelleensynkronoinnin tai päivityksen URL-osoitteen jäsennyksen mukaisesti.

SERV

Pyynnön kohdepalvelimen isäntänimi uudelleensynkronoinnin tai päivityksen URL-osoitteen jäsennyksen mukaisesti.

SERVIP

Pyynnön kohdepalvelimen IP-osoite uudelleensynkronoinnin tai päivityksen URL-osoitteen jäsennyksen tai mahdollisesti DNS-haun mukaisesti.

PORT

Pyynnön UDP-/TCP-kohdeportti uudelleensynkronoinnin tai päivityksen URL-osoitteen jäsennyksen mukaisesti.

PATH

Pyynnön kohdetiedostopolku uudelleensynkronoinnin tai päivityksen URL-osoitteen jäsennyksen mukaisesti.

ERR

Uudelleensynkronointi- tai päivitysyrityksen tulosviesti. Hyödyllinen vain syslog-tulosviestien muodostamisessa. Arvo säilytetään UPGERR-muuttujassa päivitysyrityksissä.

UIDn

Linjan n UserID-määrittelyparametrin sisältö.

ISCUST

Jos yksikkö on mukautettu, arvo=1, muussa tapauksessa 0.

Mukautustila on katsottavissa Web-käyttöliittymän tiedot -sivulla.

SAAPUVA NIMINimi, joka liittyy ensimmäiseen yhdistettyyn, soivaan tai saapuvaan puheluun.
REMOTENUMBER

Ensimmäisen yhdistetyn, soivan tai saapuvan puhelun puhelinnumero. Jos puheluja on useita, ensimmäiseen löydettyyn puheluun liittyvät tiedot ilmoitetaan.

DISPLAYNAMEnLinjan N näyttönimen määritysparametrin sisältö.
AUTHIDnLinjan N todennustunnuksen määritysparametrin sisältö.