Overzicht

XML Services Interface (XSI) is een protocol dat communicatie mogelijk maakt tussen toepassingen en het telefoonsysteem. U kunt uw eigen XSI-services toevoegen aan uw telefoon met behulp van de ondersteunde XML-objecten en URI's.

Nadat gebruikers de telefoon hebben geabonneerd op de services, hebben ze toegang tot alle geconfigureerde services op de telefoon door naar Instellingen > Netwerk en service > Cisco XML-services te gaan. Cisco XML-services is de standaardnaam. U kunt de naam ook wijzigen. Om gebruikers gemakkelijk toegang te bieden, kunt u de XML-toepassingen toevoegen aan schermtoetsen of lijntoetsen.

De ondersteunde functies zijn:

  • Berichten (afbeeldingen en tekst)
  • Paging

Ondersteunde XML-objecten

  • Cisco IP-telefoonmenu

  • Cisco IP-telefoontekst

  • Cisco IP-telefooninvoer

  • Cisco IP-telefoonlijst

  • Cisco IP-telefoonafbeelding

  • CiscoIP-telefoonImageFile

  • Cisco IP-telefoonIconMenu

  • CiscoIP-telefoonIconFileMenu

  • Cisco IP-telefoonstatus (behalve 9841)

  • CiscoIPPhoneStatusFile (behalve 9841)

  • Cisco IP-telefoon uitvoeren

Ondersteunde URI's

  • Apparaat

  • Kies

  • BewerkenDail

  • Init

  • Sleutel

  • Afspelen (alleen beltonen)

  • Schermtoets

Zie Opmerkingen over toepassingsontwikkeling voor Cisco Unified IP-telefoon-services voor meer informatie over de configuratie van de XSI-service.

Telefoon configureren om verbinding te maken met een XML-service

1

Open de beheerwebpagina van de telefoon.

2

Selecteer Spraak > Telefoon.

3

Configureer in het gedeelte XML-service de parameters XML-toepassingsservice en URL XML-toepassingsservice zoals is gedefinieerd in Parameters voor XML-services.

4

(Optioneel) Als u verificatie wilt toevoegen voor toegang tot de toepassingsservice, configureert u deze velden: XML-gebruikersnaam, XML-wachtwoord, CISCO XML EXE inschakelen en CISCO XML EXE-verificatiemodus.

5

Klik op Alle wijzigingen opslaan.

Parameters voor XML-services

De volgende tabel definieert de functie en het gebruik van de XML-toepassingsparameters in de sectie XML-service op het tabblad Spraak > Telefoon in de webinterface van de telefoon. Hij definieert ook de syntaxis van de tekenreeks die aan het telefoonconfiguratiebestand (cfg.xml) is toegevoegd met XML-code om een parameter te configureren.

Tabel 1. Parameters voor XML-services

Parameter

Standaard en opties

Beschrijving

Naam XML-toepassingsservice

Standaard: Leeg

Naam van de XML-toepassing. De naam wordt op de telefoon weergegeven als een webtoepassingskeuze.

U kunt deze parameter ook configureren in het XML-bestand met de telefoonconfiguratie (cfg.xml) door een tekenreeks met deze notatie in te voeren:

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

URL XML-toepassingsservice

Standaard: Leeg

De URL waar de XML-toepassing zich bevindt.

U kunt deze parameter ook configureren in het XML-bestand met de telefoonconfiguratie (cfg.xml) door een tekenreeks met deze notatie in te voeren:

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

Macrovariabelen worden ondersteund in XML-URL's. Zie Macrovariabelen ondersteund in XML-URL's voor de geldige macrovariabelen.

Alleen HTTP- of HTTPs-protocollen worden ondersteund in de URL.

XML-gebruikersnaam

Standaard: Leeg

Gebruikersnaam van de XML-service voor verificatiedoeleinden.

U kunt deze parameter ook configureren in het XML-bestand met de telefoonconfiguratie (cfg.xml) door een tekenreeks met deze notatie in te voeren:

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

XML-wachtwoord

Standaard: Leeg

Wachtwoord voor de XML-service voor de opgegeven XML-gebruikersnaam.

Het wachtwoord dat u in dit veld hebt ingevoerd, wordt in het configuratiebestand (cfg.xml) als volgt weergegeven:

<!-- <XML_Password ua="na">lt;/XML_Password;*************&> -->

CISCO XML EXE inschakelen

Standaard: Nee

Opties: Ja, Nee

Geeft aan of verificatie is vereist voor toegang tot de XML-toepassingsserver.

U kunt deze parameter ook configureren in het XML-bestand met de telefoonconfiguratie (cfg.xml) door een tekenreeks met deze notatie in te voeren:

<CISCO_XML_EXE_Enable ua="na">Ja</CISCO_XML_EXE_Enable>

CISCO XML EXE-verificatiemodus

Standaard: Lokale referentie

Opties: Vertrouwd, lokale referentie, externe referentie

Specificeert de verificatiemodus voor Cisco XML EXE.

  • Vertrouwd: er wordt geen verificatie uitgevoerd ongeacht de lokale referentie.

  • Lokale referentie: verificatie is gebaseerd op Digest-verificatie met de lokale referentie, indien ingesteld. Als de lokale referentie niet is ingesteld, wordt geen verificatie uitgevoerd.

  • Externe referentie: verificatie is gebaseerd op Digest-verificatie met externe referentie zoals is ingesteld in de XML-toepassing op de webpagina (voor toegang tot een XML-toepassingsserver).

U kunt deze parameter ook configureren in het XML-bestand met de telefoonconfiguratie (cfg.xml) door een tekenreeks met deze notatie in te voeren:

<CISCO_XML_EXE_Auth_Mode ua="na">Lokale referentie</CISCO_XML_EXE_Auth_Mode>

Een XML-toepassing toevoegen aan een schermtoets

Voeg de veelgebruikte toepassingen toe aan schermtoetsen zodat gebruikers eenvoudig toegang hebben tot de service.

Voordat u begint

De XML-toepassingsservice is correct geconfigureerd.

1

Open de beheerwebpagina van de telefoon.

2

Selecteer Spraak > Telefoon.

3

Stel in het gedeelte Programmeerbare schermtoetsen de optie Programmeerbare schermtoetsen inschakelen in op Ja.

U kunt deze parameter ook configureren in het configuratiebestand (cfg.xml). Voer een tekenreeks in met deze notatie:

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

Bewerk in het gedeelte Programmeerbare schermtoetsen de beschikbare velden van PSK1 tot PSK16 in deze indeling:

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

waarbij url de koppeling is waar de XML-toepassing is opgeslagen; nme is de weergavenaam van de toepassing op het telefoonscherm.

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

U kunt deze parameter ook configureren in het configuratiebestand (cfg.xml). Voer een tekenreeks in met deze notatie:

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

waarbij n het nummer van de schermtoets is.

5

Klik op Alle wijzigingen opslaan.

Een XML-toepassing toevoegen aan een lijntoets

Voeg de veelgebruikte toepassingen toe aan lijntoetsen zodat gebruikers eenvoudig toegang hebben tot de services.

Voordat u begint

De XML-toepassingsservice is correct geconfigureerd.

1

Open de beheerwebpagina van de telefoon.

2

Selecteer Spraak > Telefoon.

3

Selecteer een lijntoets.

4

Stel de parameter Toestel in op Uitgeschakeld om het toestel uit te schakelen.

Als de functie Directe PLK-configuratie is uitgeschakeld, moet u het toestel uitschakelen om een uitgebreide functie aan de lijntoets toe te voegen. U kunt deze stap overslaan als de functie is ingeschakeld. Zie Directe PLK-configuratie inschakelen voor meer informatie.
5

Voer in de parameter Uitgebreide functie een tekenreeks in deze notatie in:

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

waarbij url de koppeling is waar de XML-toepassing is opgeslagen; nme is de weergavenaam van de toepassing op het telefoonscherm.

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

U kunt deze parameter ook configureren in het configuratiebestand (cfg.xml). Voer een tekenreeks in met deze notatie:

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

waarbij n het toestelnummer is.

6

Klik op Alle wijzigingen opslaan.

Macrovariabelen die worden ondersteund in XML-URL's

U kunt macrovariabelen gebruiken in XML-URL's. De volgende macro variabelen worden ondersteund:

  • Gebruikers-ID: UID1, UID2 tot UIDn

  • Weergavenaam: DISPLAYNAME1, DISPLAYNAME2 tot DISPLAYNAMEn

  • Verificatie-id: AUTHID1, AUTHID2 tot AUTHIDn

  • Proxy: PROXY1, PROXY2 tot PROXYn

  • MAC-adres met kleine letters hexadecimale tekens: MA

  • Productnaam: PN

  • Productserienummer: PSN

  • Serienummer: SERIAL_NUMBER

Tabel 2. Ondersteunde macro's
MacronaamMacro-uitbreiding
$De vorm $$ wordt uitgebreid tot één teken $.
A tot en met PVervangen door parameters voor algemene doeleinden GPP_A tot en met GPP_P.
SA tot SDVervangen door speciale parameters GPP_SA tot en met GPP_SD. Deze parameters bevatten toetsen of wachtwoorden die worden gebruikt voor de inrichting.
$SA tot en met $SD worden herkend als argumenten voor de optionele URL-kwalificatie voor hersynchronisatie, --toets.
maMAC-adres met kleine letters hexadecimale tekens (000e08aabbcc).
MAUMAC-adres met hoofdletters hexadecimale tekens (000E08AABBCC).
macMAC-adres met kleine hexadecimale cijfers met een dubbele punt om hexadecimale cijferparen van elkaar te scheiden (00:0e:08:aa:bb:cc).
pnNaam van het product: bijvoorbeeld Video Phone 8875, Bureautelefoon 9851.
psnProductserienummer; bijvoorbeeld 8875, 9841, 9861
snTekenreeks voor serienummer: bijvoorbeeld 88012BA01234.
certificaatStatus SSL-clientcertificaat, al dan niet geïnstalleerd.
IPIP-adres van de telefoon binnen het lokale subnet, bijvoorbeeld 192.168.1.100.
uitdrijvingExtern IP-adres van de telefoon, weergegeven op het internet; bijvoorbeeld 66.43.16.52.

zwerver

Tekenreeks softwareversie. Bijvoorbeeld:

foneos.3-2-1-0104-37

hwver

Tekenreeks hardwareversie. Bijvoorbeeld 2.0.1

prvst

Inrichtingsstatus (een numerieke tekenreeks):

-1 = expliciete aanvraag hersynchroniseren

0 = opstarten hersynchroniseren

1 = periodiek hersynchroniseren

2 = hersynchroniseren is mislukt, nieuwe poging

opsteken

Upgradestatus (een reeks cijfers):

1 = eerste upgradepoging

2 = upgrade mislukt, nieuwe poging

upgerr

Resultaatbericht (ERR) van de vorige upgradepoging; bijvoorbeeld http_get is mislukt.

prvtmr

Seconden sinds de laatste hersynchronisatiepoging.

upgtmr

Seconden sinds de laatste upgradepoging.

regtmr1

Seconden sinds registratie lijn 1 met SIP-server is verbroken.

regtmr2

Seconden sinds registratie lijn 2 met SIP-server is verbroken.

upgcond

Oude macronaam.

schema

Bestandstoegangsschema, TFTP, HTTP of HTTPS, zoals verkregen na het parseren van hersynchronisatie- of upgrade-URL.

serv

Aanvraag doelserverhostnaam, zoals verkregen na het parseren van de hersynchronisatie- of upgrade-URL.

serpent

Aanvraag doelserver IP-adres, zoals verkregen na het parseren van de hersynchronisatie- of upgrade-URL, mogelijk na een DNS-zoekopdracht.

poort

Aanvraag doel UDP/TCP-poort, zoals verkregen na het parseren van de hersynchronisatie- of upgrade-URL.

pad

Aanvraag doelbestandspad, zoals verkregen na het parseren van de hersynchronisatie- of upgrade-URL.

fout

Resultaatbericht van hersynchronisatie- of upgradepoging. Alleen nuttig bij het genereren van resultaat syslog-berichten. De waarde wordt behouden in de variabele UPGERR in het geval van upgradepogingen.

UIDn

De inhoud van de configuratieparameter voor gebruikers-id voor lijn n.

iscust

Als de eenheid is aangepast, waarde = 1, anders 0.

De aanpassingsstatus kan worden weergegeven op de pagina Info webgebruikersinterface.

aanmeldnaamDe naam die is gekoppeld aan het eerste verbonden, overgaande of inkomende gesprek.
toestelnummer

Het telefoonnummer van het eerste verbonden, overgaande of inkomende gesprek. Als er meerdere gesprekken zijn, worden de gegevens verstrekt die zijn gekoppeld aan het eerste gesprek.

WEERGAVENAAMnDe inhoud van de configuratieparameter weergavenaam voor lijn n.
AUTHIDnDe inhoud van de configuratieparameter voor verificatie-id voor lijn n.