- Start
- /
- Artikel
Configuratie van XML-toepassingen voor 9800- en 8875-telefoons (BroadWorks)
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 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 . |
| 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 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.
|
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:
|
|
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:
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-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:
|
|
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 Auth-modus |
Standaard: Local Credential Opties: Vertrouwd, lokale inloggegevens, inloggegevens op afstand |
Specificeert de verificatiemodus voor Cisco XML EXE.
U kunt deze parameter ook configureren in het XML-bestand voor de telefoonconfiguratie (cfg.xml) door een tekenreeks in dit formaat in te voeren:
|
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 . |
| 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:
|
| 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
Voorbeeld
U kunt deze parameter ook configureren in het configuratiebestand (cfg.xml). Voer een tekenreeks in dit formaat in:
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 . |
| 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
Voorbeeld
U kunt deze parameter ook configureren in het configuratiebestand (cfg.xml). Voer een tekenreeks in dit formaat in:
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
| Macro-naam | Macro-uitbreiding |
|---|---|
| $ | Het formulier $$ kan worden uitgebreid tot één $-teken. |
| A tot en met P | Vervangen door algemene parameters GPP_A tot en met GPP_P. |
| SA tot en met SD | Vervangen 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. |
| MA | MAC-adres met hexadecimale cijfers in kleine letters (000e08aabbcc). |
| MAU | MAC-adres met hexadecimale hoofdletters (000E08AABBCC). |
| MAC | MAC-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). |
| PN | Productnaam; bijvoorbeeld videofoon 8875, bureautelefoon 9851. |
| PSN | Serienummer van het product; bijvoorbeeld 8875, 9841, 9861 |
| SN | Serienummerreeks; bijvoorbeeld 88012BA01234. |
| CCERT | Status van het SSL-clientcertificaat, geïnstalleerd of niet geïnstalleerd. |
| IP | IP-adres van de telefoon binnen het lokale subnet; bijvoorbeeld 192.168.1.100. |
| EXTIP | Extern 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. |
| INCOMINGNAME | Naam 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. |
| DisplayNaam | De inhoud van de configuratieparameter Line N Display Name. |
| AuthID | De inhoud van de Line N Auth ID-configuratieparameter. |