- Start
- /
- Artikel
XML toepassingen configureren voor telefoons op BroadWorks
Dit Help-artikel is van toepassing op de Cisco bureautelefoon 9800 Series en Cisco Videotelefoon 8875 die zijn geregistreerd bij Cisco BroadWorks. Lees dit artikel over de ondersteunde XML objecten, URI's en de stappen voor het configureren van de XSI-services op de webpagina telefoon.
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
gaan. 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 . |
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 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.
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:
|
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:
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-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:
|
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-verificatiemodus |
Standaard: Lokale referentie Opties: Vertrouwd, Lokale referentie, Externe referentie |
Hiermee specificeert u de verificatiemodus voor Cisco XML EXE.
U kunt deze parameter ook configureren in het XML-bestand met de telefoonconfiguratie (cfg.xml) door een tekenreeks met deze notatie in te voeren:
|
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 . |
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:
|
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
Voorbeeld U kunt deze parameter ook configureren in het configuratiebestand (cfg.xml). Voer een tekenreeks in met deze indeling:
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 . |
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
Voorbeeld U kunt deze parameter ook configureren in het configuratiebestand (cfg.xml). Voer een tekenreeks in met deze indeling:
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
Macronaam | Uitbreiding van macro |
---|---|
$ | De vorm $$ wordt uitgebreid tot één teken $. |
A tot en met P | Wordt vervangen door de algemene parameters GPP_A tot en met GPP_P. |
SA tot SD | Wordt 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. |
MA | MAC-adres met kleine letters hexadecimale tekens (000e08aabbcc). |
MAU | MAC-adres met hoofdletters hexadecimale tekens (000E08AABBCC). |
MAC | MAC-adres met kleine hexadecimale cijfers met een dubbele punt om hexadecimale cijferparen van elkaar te scheiden (00:0e:08:aa:bb:cc). |
PN | Productnaam; bijvoorbeeld, videotelefoon 8875, bureautelefoon 9851. |
PSN | Nummer productreeks; bijvoorbeeld 8875, 9841, 9861 |
SN | Tekenreeks voor serienummer: bijvoorbeeld 88012BA01234. |
CCERT | Status SSL-clientcertificaat, al dan 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, 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. |
INCOMINGNAME | De 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. |
DISPLAYNAMEn | De inhoud van weergavenaam configuratieparameter voor lijn n. |
AUTHIDn | De inhoud van verificatie-id configuratieparameter voor lijn n. |