In dit artikel
dropdown icon
Overzicht
    Ondersteunde XML-objecten
    Ondersteunde URI's
Een telefoon configureren om verbinding te maken met een XML-service
Parameters voor XML-services
Een XML-toepassing aan een softkey toevoegen
Een XML-toepassing aan een lijnsleutel toevoegen
Macrovariabelen die worden ondersteund in XML-URL's

Configuratie van XML-toepassingen voor 9800- en 8875-telefoons (BroadWorks)

list-menuIn dit artikel
list-menuFeedback?

Dit Help-artikel is van toepassing op Cisco Desk Phone 9800 Series en Cisco Video Phone 8875 die geregistreerd zijn bij Cisco BroadWorks. Lees dit artikel voor de ondersteunde XML-objecten, URI's en de stappen voor het configureren van de XSI-services op de webpagina van de telefoon.

Overzicht

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

Nadat de telefoon is geabonneerd op de services, hebben gebruikers 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 ook de naam wijzigen. Om gebruikers gemakkelijk toegang te bieden, kunt u de XML-toepassingen toevoegen aan softkeys of lijntoetsen.

De ondersteunde functies zijn:

  • Berichten (afbeeldingen en tekst)
  • Paging

Ondersteunde XML-objecten

  • Cisco IPhone-menu

  • Cisco IP-telefoontekst

  • Cisco IP-telefooningang

  • Cisco IP-telefoongids

  • Cisco IPhone-afbeelding

  • Cisco IPhone-afbeeldingsbestand

  • Cisco IPhone-pictogrammenu

  • Cisco IPphone Icon-bestandsmenu

  • Cisco IPhonestatus (behalve 9811 en 9841)

  • Cisco IPhone-statusbestand (behalve 9811 en 9841)

  • Cisco IPphone EXECUTE

Ondersteunde URI's

  • Apparaat

  • Dial

  • Edit Dail

  • Init

  • Sleutel

  • Afspelen (alleen beltonen)

  • Softkey

Zie Cisco Unified IP Phone Services Application Development Notes voor meer informatie over de XSI-serviceconfiguratie.

Een telefoon configureren om verbinding te maken met een XML-service

1

Ga naar de webpagina voor telefoonadministratie.

2

Selecteer Spraak > Telefoon.

3

Configureer in de sectie XML-service de naam van de XML-toepassingsservice en de URL-parameters van de XML-toepassingsservice zoals gedefinieerd in Parameters voor XML-services.

4

(Optioneel) Om authenticatie toe te voegen voor toegang tot de toepassingsservice, moet u de volgende velden configureren: XML-gebruikersnaam, XML-wachtwoord, CISCO XML EXE Enable en CISCO XML EXE Auth Mode.

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 onder het tabblad Spraak > Telefoon in de webinterface van de telefoon. Het definieert ook de syntaxis van de tekenreeks die wordt toegevoegd aan het telefoonconfiguratiebestand (cfg.xml) met XML-code om een parameter te configureren.

Tabel 1. Parameters voor XML-services

Parameter

Standaardinstellingen en opties

Beschrijving

Naam van de XML-toepassingsservice

Standaard: Leeg

Naam van de XML-toepassing. De naam wordt op de telefoon weergegeven als keuze voor een webtoepassing.

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

<XML_Application_Service_Name
ua="na">XML APP Name</XML_Application_Service_Name>

URL van de XML-toepassingsservice

Standaard: Leeg

De URL waar de XML-toepassing zich bevindt.

U kunt deze parameter ook configureren in het XML-bestand voor de telefoonconfiguratie (cfg.xml) door een tekenreeks in dit formaat 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. Voor de geldige macrovariabelen, zie Macrovariabelen die worden ondersteund in XML-URL's.

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

XML-gebruikersnaam

Standaard: Leeg

Gebruikersnaam voor de XML-service voor authenticatiedoeleinden.

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

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

XML-wachtwoord

Standaard: Leeg

XML-servicewachtwoord 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">*************</XML_Password>
-->

CISCO XML EXE inschakelen

Standaard: Nee

Opties: Ja, Nee

Specificeert of authenticatie vereist is voor toegang tot de XML-toepassingsserver.

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

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

CISCO XML EXE Auth-modus

Standaard: Local Credential

Opties: Vertrouwd, lokale inloggegevens, inloggegevens op afstand

Specificeert de verificatiemodus voor Cisco XML EXE.

  • Vertrouwd: er wordt geen authenticatie uitgevoerd, ongeacht de lokale inloggegevens.

  • Lokale inloggegevens — Authenticatie is gebaseerd op de digest-authenticatie met behulp van de lokale inloggegevens, indien ingesteld. Als de lokale inloggegevens niet zijn ingesteld, wordt er geen authenticatie uitgevoerd.

  • Identificatie op afstand — Authenticatie is gebaseerd op de samenvattingsverificatie met behulp van de externe inloggegevens zoals ingesteld in de XML-toepassing op de webpagina (voor toegang tot een XML-toepassingsserver).

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

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

Een XML-toepassing aan een softkey toevoegen

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

Voordat u begint

De XML-toepassingsservice is correct geconfigureerd.

1

Ga naar de webpagina voor telefoonadministratie.

2

Selecteer Spraak > Telefoon.

3

Stel in het gedeelte Programmeerbare softkeys de programmeerbare softkey Enable in op Yes.

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

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

Bewerk in de sectie Programmeerbare softkeys de beschikbare velden van PSK1 tot PSK16 in dit formaat:

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

waarbij url de link 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 dit formaat in:

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

waarbij n het softkey-nummer is.

5

Klik op Alle wijzigingen opslaan.

Een XML-toepassing aan een lijnsleutel toevoegen

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

Voordat u begint

De XML-toepassingsservice is correct geconfigureerd.

1

Ga naar de webpagina voor telefoonadministratie.

2

Selecteer Spraak > Telefoon.

3

Selecteer een lijntoets.

4

Stel de parameter Extension in op Disabled om de extensie uit te schakelen.

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

Voer in de parameter Extended Function een tekenreeks in dit formaat in:

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

waarbij url de link 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 dit formaat in:

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

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 macrovariabelen worden ondersteund:

  • Gebruikers-ID: UID1, UID2 naar UIDn

  • Schermnaam — DisplayName1, DISPLAYNAME2 naar DisplayName

  • Auth-ID — AUTHID1, AUTHID2 naar AuthIDN

  • Proxy — Proxy1, PROXY2 naar ProxyN

  • MAC-adres met hexadecimale cijfers in kleine letters: MA

  • Naam van het product: PN

  • Nummer van de productreeks: PSN

  • Serienummer—Serienummer

Tabel 2. Ondersteunde macro's
Macro-naamMacro-uitbreiding
$Het formulier $$ kan worden uitgebreid tot één $-teken.
A tot en met PVervangen door algemene parameters GPP_A tot en met GPP_P.
SA tot en met SDVervangen door speciale parameters GPP_SA tot en met GPP_SD. Deze parameters bevatten sleutels of wachtwoorden die bij de bevoorrading worden gebruikt.

$SA tot en met $SD worden herkend als argumenten voor de optionele hersynchronisatie-URL-kwalificatie, --key.

MAMAC-adres met hexadecimale cijfers in kleine letters (000e08aabbcc).
MAUMAC-adres met hexadecimale hoofdletters (000E08AABBCC).
MACMAC-adres dat hexadecimale cijfers in kleine letters en een dubbele punt gebruikt om hexadecimale cijferparen van elkaar te scheiden (00:0 e:08:aa:bb:cc).
PNProductnaam; bijvoorbeeld videofoon 8875, bureautelefoon 9851.
PSNSerienummer van het product; bijvoorbeeld 8875, 9841, 9861
SNSerienummerreeks; bijvoorbeeld 88012BA01234.
CCERTStatus van het SSL-clientcertificaat, geïnstalleerd of niet geïnstalleerd.
IPIP-adres van de telefoon binnen het lokale subnet; bijvoorbeeld 192.168.1.100.
EXTIPExtern IP-adres van de telefoon, zoals te zien op het internet; bijvoorbeeld 66.43.16.52.

SWVER

Tekenreeks voor de softwareversie. Bijvoorbeeld

PHONEOS.3-2-1-0104-37

HWVER

String van de hardwareversie. Bijvoorbeeld 2.0.1

PRVST

Provisioning State (een numerieke tekenreeks):

-1 = expliciete hersynchronisatieverzoek

0 = opstarten en opnieuw synchroniseren

1 = periodieke hersynchronisatie

2 = opnieuw synchroniseren is mislukt, probeer het opnieuw

UPGST

Upgradestatus (een numerieke tekenreeks):

1 = eerste poging tot upgrade

2 = de upgrade is mislukt, probeer het opnieuw

UPGERR

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

PRVTMR

Enkele seconden sinds de laatste poging tot hersynchronisatie.

UPGTMR

Enkele seconden sinds de laatste upgradepoging.

REGTMR1

Enkele seconden sinds Line 1 de registratie op de SIP-server verloor.

REGTMR2

Enkele seconden sinds Line 2 de registratie op de SIP-server verloor.

UPGCOND

Oude macronaam.

SCHEME

Schema voor toegang tot bestanden, een schema van TFTP, HTTP of HTTPS, zoals verkregen na het parseren, hersynchroniseren of upgraden van de URL.

SERV

De hostnaam van de doelserver aanvragen, zoals verkregen na het parseren van de URL voor hersynchronisatie of upgrade.

SERVIP

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

PORT

Verzoek de UDP/TCP-doelpoort, zoals verkregen na het parseren van de URL voor hersynchronisatie of upgrade.

PATH

Het doelbestandspad aanvragen, zoals verkregen na het parseren van de URL voor hersynchronisatie of upgrade.

ERR

Bericht over het resultaat van een hersynchronisatie of een upgradepoging. Alleen nuttig voor het genereren van syslogberichten met resultaten. De waarde blijft behouden in de variabele UPGERR in het geval van een upgradepoging.

UiDN

De inhoud van de configuratieparameter Line n UserID.

ISCUST

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

De aanpassingsstatus is zichtbaar op de informatiepagina van de webinterface.

INCOMINGNAMENaam die is gekoppeld aan het eerste gesprek dat is verbonden, gebeld of binnengekomen.
REMOTENUMBER

Telefoonnummer van het eerste gesprek dat is verbonden, gebeld of binnengekomen. Als er meerdere gesprekken zijn, worden de gegevens verstrekt die zijn gekoppeld aan de eerste gevonden oproep.

DisplayNaamDe inhoud van de configuratieparameter Line N Display Name.
AuthIDDe inhoud van de Line N Auth ID-configuratieparameter.
Vond u dit artikel nuttig?
Vond u dit artikel nuttig?