Yleiskatsaus

XML Services Interface (XSI) on protokolla, joka mahdollistaa viestinnän sovellusten ja puhelinjärjestelmän välillä. Voit lisätä puhelimeesi omia XSI-palveluita käyttämällä tuettuja XML-objekteja ja URI-osoitteita.

Kun puhelin on tilattu 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 on oletusnimi. Voit myös muuttaa nimeä. Voit tarjota käyttäjille helpon pääsyn lisäämällä XML-sovellukset valonäppäimiin tai viivanäppäimiin.

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)

  • CiscoIPPhoneExecute

Tuetut URI-osoitteet

  • Laite

  • Valitse

  • EditDail

  • Init

  • Avain

  • Toista (vain soittoäänet)

  • Softkey

Lisätietoja XSI-palvelun määrityksestä on kohdassa Cisco Unified IP Phone Services -sovelluskehityksen huomautukset.

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

1

Siirry puhelimen hallinnan verkkosivulle.

2

Valitse Voice > Phone.

3

Määritä XML-palvelu-osassa XML-sovelluspalvelun nimi - ja XML-sovelluspalvelun URL-parametrit , jotka on määritetty kohdassa XML-palveluidenparametrit.

4

(Valinnainen) Jos haluat lisätä todennuksen sovelluspalvelun käyttöä varten, määritä opinnäytetyökentät: XML-käyttäjänimi, XML-salasana, CISCO XML EXE -toiminto ja CISCO XML EXE -todennustila .

5

Klikkaa Tallenna kaikki muutokset.

XML-palveluiden parametrit

Seuraavassa taulukossa määritetään XML-sovellusparametrien toiminta ja käyttö puhelimen verkkokäyttöliittymän Ääni- > Puhelin-välilehden XML-palvelu-osassa . Se määrittää myös syntaksin merkkijonolle, 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

Laiminlyönti: Tyhjä

XML-sovelluksen nimi. Nimi näkyy puhelimessa verkkosovellusvalintana.

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

Laiminlyönti: Tyhjä

URL-osoite, jossa XML-sovellus sijaitsee.

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

XML-URL-osoitteet tukevat makromuuttujia. Katso kelvolliset makromuuttujat kohdasta XML-URL-osoitteidentukemat makromuuttujat.

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

XML-käyttäjänimi

Laiminlyönti: Tyhjä

XML-palvelun käyttäjänimi todennusta varten.

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

<XML_User_Name ua="na">käyttäjänimi</XML_User_Name>

XML-salasana

Laiminlyönti: 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

Laiminlyönti: Ei

Asetukset: Kyllä, ei

Määrittää, vaaditaanko todennusta XML-sovelluspalvelimen käyttämiseen.

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

<CISCO_XML_EXE_Enable ua="na">Kyllä</CISCO_XML_EXE_Enable>

CISCO XML EXE -todennustila

Laiminlyönti: Paikalliset tunnistetiedot

Asetukset: Luotettu, paikalliset tunnistetiedot, etätunnistetiedot

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

  • Luotettu – Todennusta ei suoriteta paikallisista tunnistetiedoista riippumatta.

  • Paikalliset tunnistetiedot – Todennus perustuu koostetodennukseen, jossa käytetään paikallisia tunnistetietoja, jos määritetty. Jos paikallisia tunnistetietoja ei ole määritetty, todennusta ei suoriteta.

  • Etätunnistetiedot – Todennus perustuu tiivistetodennukseen, jossa käytetään verkkosivun XML-sovelluksessa määritettyjä etätunnistetietoja (XML-sovelluspalvelimen käyttämiseksi).

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

<CISCO_XML_EXE_Auth_Mode ua="na">Paikalliset tunnistetiedot</CISCO_XML_EXE_Auth_Mode>

XML-sovelluksen lisääminen valoavaimeen

Lisää usein käytetyt sovellukset valonä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 Voice > Phone.

3

Määritä Ohjelmoitavat valonäppäimet -osassa Ohjelmoitava valonäppäin Ota käyttöön -asetukseksi Kyllä .

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

<Programmable_Softkey_Enable ua="na">Kyllä</Programmable_Softkey_Enable>
4

Muokkaa Ohjelmoitavat valonäppäimet -osassa PSK1 :n ja PSK16 :n käytettävissä olevia kenttiä tässä muodossa:

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

jossa url on linkki, johon XML-sovellus on tallennettu; NME on sovelluksen näyttönimi puhelimen näytöllä.

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

Voit määrittää tämän parametrin myös 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=Valikko<configuration code=""></configuration></PSK_n>

jossa n on valonäppäimen numero.

5

Klikkaa Tallenna kaikki muutokset.

XML-sovelluksen lisääminen riviavaimeen

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 Voice > Phone.

3

Valitse rivinäppäin.

4

Poista laajennus käytöstä määrittämällä Laajennus-parametrin arvoksi Disabled (Ei käytössä ).

Jos Direct PLK Configuration -ominaisuus on poistettu käytöstä, laajennus on poistettava käytöstä, jotta rivinäppäimeen voidaan lisätä laajennettu toiminto. Jos ominaisuus on käytössä, voit ohittaa tämän vaiheen. Lisätietoja on kohdassa Direct PLK -määrityksenottaminen käyttöön.
5

Kirjoita Extended Function -parametriin merkkijono tässä muodossa:

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

jossa url on linkki, johon XML-sovellus on tallennettu; NME on sovelluksen näyttönimi puhelimen näytöllä.

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

Voit määrittää tämän parametrin myös 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=Valikko<configuration code=""></configuration></Extended_Function_n_>

jossa n on alaliittymän numero.

6

Klikkaa 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

  • Todennustunnus — AUTHID1, AUTHID2 AUTHIDnille

  • Välityspalvelin – PROXY1, PROXY2 - PROXYn

  • MAC-osoite pienillä heksadesimaalinumeroilla – MA

  • Tuotteen nimi – PN

  • Tuotesarjan numero – PSN

  • Sarjanumero—SERIAL_NUMBER

Taulukko 2. Tuetut makrot
Makron nimiMakron laajennus
$Muoto $$ laajenee yhdeksi $-merkiksi.
A–PKorvattu yleiskäyttöisillä parametreilla GPP_A–GPP_P.
SA–SDKorvattu erikoisparametreilla GPP_SA–GPP_SD. Nämä parametrit sisältävät valmistelussa käytettyjä avaimia tai salasanoja.
$SA–$SD tunnistetaan argumenteiksi valinnaiselle uudelleensynkronoinnin URL-tarkenteelle --avain.
ÄITIMAC-osoite pienillä heksadesimaalinumeroilla (000e08aabbcc).
MAUMAC-osoite isoilla heksadesimaalinumeroilla (000E08AABBCC).
SADETAKKIMAC-osoite, jossa käytetään pieniä heksadesimaalinumeroita kaksoispisteellä hex-numeroparien erottamiseksi toisistaan (00:0e:08:aa:bb:cc).
PNtuotteen nimi; esimerkiksi Videopuhelin 8875, Pöytäpuhelin 9851.
PSNtuotesarjan numero; Esimerkiksi 8875, 9841, 9861
SNSarjanumeron merkkijono; esimerkiksi 88012BA01234.
CCERTSSL-asiakasvarmenteen tila, asennettu tai ei asennettu.
IPpuhelimen IP-osoite sen paikallisessa aliverkossa; Esimerkiksi 192.168.1.100.
KÄRKIPuhelimen ulkoinen IP, kuten Internetissä nähdään; Esimerkiksi 66.43.16.52.

SWVER

Ohjelmistoversion merkkijono. Esimerkiksi

PHONEOS.3-2-1-0104-37

HWVER

Laitteistoversion merkkijono. Esimerkiksi 2.0.1

PRVST

Valmistelutila (numeerinen merkkijono):

-1 = eksplisiittinen uudelleensynkronointipyyntö

0 = Virran uudelleensynkronointi

1 = säännöllinen uudelleensynkronointi

2 = uudelleensynkronointi epäonnistui, uudelleenyritys

UPGST

Päivitystila (numeerinen merkkijono):

1 = ensimmäinen päivitysyritys

2 = päivitys epäonnistui, uudelleenyritys

UPGERR

Edellisen päivitysyrityksen tulosviesti (ERR); Esimerkiksi http_get epäonnistui.

PRVTMR

Sekunteja edellisestä uudelleensynkronointiyrityksestä.

UPGTMR

Sekunteja edellisestä päivitysyrityksestä.

REGTMR1

Sekunteja siitä, kun linja 1 menetti rekisteröinnin SIP-palvelimelle.

REGTMR2

Sekunteja siitä, kun linja 2 menetti rekisteröinnin SIP-palvelimelle.

UPGCOND

Vanha makron nimi.

JÄRJESTELMÄ

Tiedostojen käyttöjärjestelmä, TFTP-, HTTP- tai HTTPS-malli, joka saadaan URL-osoitteen uudelleensynkronoinnin tai päivityksen jälkeen.

PAL

Pyydä kohdepalvelimen isäntänimeä, joka saadaan URL-osoitteen jäsentämisen, uudelleensynkronoinnin tai päivityksen jälkeen.

SERVIP

Pyydä kohdepalvelimen IP-osoitetta, joka saadaan uudelleensynkronoinnin tai päivityksen URL-osoitteen jäsentämisen jälkeen, mahdollisesti DNS-haun jälkeen.

SATAMA

Pyydä kohde-UDP/TCP-porttia, joka saadaan URL-osoitteen uudelleensynkronoinnin tai päivityksen jälkeen.

POLKU

Pyydä kohdetiedoston polkua, joka saadaan URL-osoitteen jäsentämisen, uudelleensynkronoinnin tai päivityksen jälkeen.

EREHTYÄ

Uudelleensynkronoinnin tai päivitysyrityksen tulosviesti. Hyödyllinen vain tulosjärjestelmälokiviestien luomisessa. Arvo säilyy UPGERR-muuttujassa päivitysyritysten yhteydessä.

UIDn

Line n UserID -määritysparametrin sisältö.

ISCUST

Jos yksikkö on mukautettu, arvo=1, muuten 0.

Mukautuksen tila näkyy Web UI Info -sivulla.

SAAPUVA NIMINimi, joka liittyy ensimmäiseen yhdistettyyn, soivaan tai saapuvaan puheluun.
ETÄNUMERO

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

DISPLAYNAMEnRivin N näyttönimen määritysparametrin sisältö.
AUTHIDnRivin N todennustunnuksen määritysparametrin sisältö.