Overzicht

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

Na het aanmelden van de telefoon bij de services, hebben gebruikers toegang tot alle geconfigureerde services op de telefoon door naar Instellingen > Netwerk en service > Cisco-XML-services tegaan. Cisco XML-services is de standaardnaam. U kunt ook de naam wijzigen. Om gebruikers eenvoudig toegang te bieden, kunt u de XML-toepassingen toevoegen aan functietoetsen of lijntoetsen.

De ondersteunde functies zijn:

  • Berichten (afbeeldingen en tekst)
  • Pagen

Ondersteunde XML objecten

  • CiscoIPPhoneMenu

  • CiscoIPPhoneText

  • CiscoIPPhoneInput

  • CiscoIPPhoneDirectory

  • CiscoIPPhoneImage

  • CiscoIPPhoneImageFile

  • CiscoIPPhoneIconMenu

  • CiscoIP DieFileMenu

  • CiscoIPPhoneStatus (behalve 9841)

  • CiscoIPPhoneStatusFile (behalve 9841)

  • CiscoIPPhoneExecute

Ondersteunde URI's

  • Apparaat

  • Wijzerplaat

  • Bewerken

  • Init

  • Sleutel

  • Afspelen (alleen beltonen)

  • Schermtoets

Raadpleeg Cisco Unified IP Phone Services Application Development Notes voor meer informatie over de configuratie van de XSI-service.

Een 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 van XML toepassingsservicenaam en XML URL van toepassingsservice zoals gedefinieerd in Parameters voor XML services.

4

(Optioneel) Als u verificatie wilt toevoegen voor toegang tot de toepassingsservice, configureert u de volgende velden: XML Gebruikersnaam, XML Wachtwoord, CISCO XML EXE enable en CISCO XML EXE Auth-modus.

5

Klik op Alle wijzigingen opslaan.

Parameters voor XML-services

In de volgende tabel worden de functie en het gebruik van de parameters van de XML de toepassing beschreven in het gedeelte XML Service onder 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

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

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">XML APP-naam</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>

Macro variabelen worden ondersteund in XML Url's. Raadpleeg macrovariabelen ondersteund in XML URL's voor de geldige macrovariabelen.

Alleen protocollen MET HTTP of HTTP's worden in de URL ondersteund.

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">username</XML_User_Name>

XML-wachtwoord

Standaard: leeg

Het XML-service wachtwoord voor de opgegeven XML-gebruikers naam.

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

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

CISCO XML EXE inschakelen

Standaard: Nee

Opties: Ja, Nee

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

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">Jj</CISCO_XML_EXE_Enable>

CISCO XML EXE-verificatiemodus

Standaard: Lokale referentie

Opties: Vertrouwd, Lokale referentie, Externe referentie

Hiermee specificeert u 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 het wachtwoord van de lokale gebruiker, als dit is ingesteld. Als dit niet ingesteld, wordt er geen verificatie uitgevoerd.

  • Externe referentie: verificatie is gebaseerd op Digest-verificatie met externe gebruikersnaam/wachtwoord 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 aan een functietoets toevoegen

Voeg de veelgebruikte toepassingen toe aan functietoetsen zodat gebruikers op eenvoudige wijze 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 de sectie Programmable Softkeys (Programmeerbare schermtoetsen) de optie Programmable Softkey Enable (Programmeerbare schermtoetsen inschakelen) in op Ja.

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

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

Bewerk in het gedeelte Programmeerbare functietoetsen de beschikbare velden van PSK1 naar PSK16 in de volgende indeling:

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

waarbij url de koppeling is naar de toepassing XML; 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 indeling:

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

waarbij n het functietoetsnummer is.

5

Klik op Alle wijzigingen opslaan.

Een XML toepassing aan een lijntoets toevoegen

Voeg de veelgebruikte toepassingen toe aan lijntoetsen zodat gebruikers op eenvoudige wijze 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 toestelnummer uitschakelen om een uitgebreide functie aan de lijntoets toe te voegen. Als de functie is ingeschakeld, kunt u deze stap overslaan. Zie Direct PLK-configuratie inschakelen voor meer informatie.
5

Voer in de parameter Uitgebreide functie een tekenreeks in de volgende indeling in:

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

waarbij url de koppeling is naar de toepassing XML; 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 indeling:

<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 ondersteund in XML-URL's

U kunt macrovariabelen gebruiken in XML-URL's. De volgende macrovariabelen 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
MacronaamUitbreiding van macro
$De vorm $$ wordt uitgebreid tot één teken $.
A tot en met PWordt vervangen door de algemene parameters GPP_A tot en met GPP_P.
SA tot SDWordt vervangen door de speciale parameters GPP_SA tot en met GPP_SD. Deze parameters bevatten toetsen of wachtwoorden voor inrichting.
$SA tot en met $SD worden herkend als argumenten voor de optionele URL-kwalificatie voor opnieuw synchroniseren, --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).
PNProductnaam; bijvoorbeeld, videotelefoon 8875, bureautelefoon 9851.
PSNNummer productreeks; bijvoorbeeld 8875, 9841, 9861
SNTekenreeks voor serienummer: bijvoorbeeld 88012BA01234.
CCERTStatus SSL-clientcertificaat, al dan niet geïnstalleerd.
IPIP-adres van de telefoon binnen het lokale subnet: bijvoorbeeld 192.168.1.100.
EXTIPExtern IP-adres van de telefoon, weergegeven op het internet: bijvoorbeeld 66.43.16.52.

SWVER

Tekenreeks softwareversie. Bijvoorbeeld:

PHONEOS.3-2-1-0104-37

HWVER

Tekenreeks hardwareversie. Bijvoorbeeld 2.0.1

PRVST

Ppovisioningstatus (een reeks cijfers):

-1 = expliciete aanvraag hersynchroniseren

0 = opstarten hersynchroniseren

1 = periodiek hersynchroniseren

2 = synchroniseren is mislukt, nieuwe poging

UPGST

Status van upgrade (een reeks cijfers):

1 = eerste upgradepoging

2 = upgrade is 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

SCHEME

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.

SERVIP

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

PORT

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

PATH

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

ERR

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 upgrade-pogingen.

UIDn

De inhoud van de configuratieparameter Line n UserID (gebruikers-id voor lijn n).

ISCUST

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

De aanpassingsstatus is zichtbaar op de pagina Web UI-gegevens.

INCOMINGNAMEDe naam die is gekoppeld aan het eerste verbonden, overgaande of inkomende gesprek.
REMOTENUMBER

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

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