- Hjem
- /
- Artikel
XML programkonfiguration til telefoner på BroadWorks
Denne Hjælp-artikel gælder for Cisco Desk Phone 9800-serien og Cisco Video Phone 8875, der er tilmeldt Cisco BroadWorks. Læs denne artikel om understøttede XML objekter, URI'er og trinnene til konfiguration af XSI-tjenester på telefonens webside.
Oversigt
XML Services Interface (XSI) er en protokol, der tillader kommunikation mellem programmer og telefonsystemet. Du kan føje dine egne XSI-tjenester til telefonen ved hjælp af de understøttede XML objekter og URI'er.
Når brugerne abonnerer på telefonen på tjenesterne, kan de få adgang til alle de konfigurerede tjenester på telefonen ved at gå til
. Standardnavnet er Cisco XML tjenester. Du kan også ændre navnet. For at give brugerne nem adgang kan du føje de XML programmer til programtaster eller linjetaster.De understøttede funktioner er:
- Beskeder (billeder og tekst)
- Søger
Understøttede XML objekter
-
CiscoIPPhoneMenu
-
CiscoIPPhoneText
-
CiscoIPPhoneInput
-
CiscoIPPhoneDirectory
-
CiscoIPPhoneImage
-
CiscoIPPhoneImageFile
-
CiscoIPPhoneIconMenu
-
CiscoIPPhoneIconFileMenu
-
CiscoIPPhoneStatus (undtagen 9841)
-
CiscoIPPhoneStatusFile (undtagen 9841)
-
CiscoIPPhoneExecute
Understøttede URI'er
-
Enhed
-
Urskive
-
RedigerDail
-
Init
-
Nøgle
-
Afspil (kun ringetoner)
-
Programtast
Du kan finde flere oplysninger om konfigurationen af XSI-tjenesten under Cisco Unified IP Phone Services Application Development Notes.
Konfigurere en telefon til at oprette forbindelse til en XML tjeneste
1 |
Gå til websiden til telefonadministration |
2 |
Vælg . |
3 |
Konfigurer parametrene XML Application Service Name og XML Application Service URL (Applikationstjeneste) i afsnittet XML Service (Tjeneste ), som defineret i Parametre for XML tjenester . |
4 |
(Valgfrit) Hvis du vil tilføje godkendelse for adgang til programtjenesten, skal du konfigurere disse felter: XML Brugernavn,XML adgangskode,CISCO XML EXE Enable og CISCO XML EXE Auth Mode. |
5 |
Klik på Gem alle ændringer. |
Parametre for XML tjenester
Følgende tabel definerer funktionen og brugen af de XML programparametre i afsnittet XML tjeneste under i telefonens webgrænseflade. Den definerer også syntaksen for den streng, der tilføjes i telefonkonfigurationsfilen (cfg.xml) med XML-kode, for at konfigurere en parameter.
Parameter |
Standard og indstillinger |
Beskrivelse |
---|---|---|
XML Application Service Name (Navn på XML-programtjeneste) |
Standard: tom |
Navn på XML-programmet. Navnet vises på telefonen som en webprogramindstilling. Du kan også konfigurere denne parameter i telefonkonfigurations-XML-filen (cfg.xml) ved at indtaste en streng i dette format:
|
XML Application Service URL (URL-adresse til XML-programtjeneste) |
Standard: tom |
Den URL-adresse, hvor XML-programmet er placeret. Du kan også konfigurere denne parameter i telefonkonfigurations-XML-filen (cfg.xml) ved at indtaste en streng i dette format:
Makrovariabler understøttes i XML-URL-adresser. Du kan finde oplysninger om gyldige makrovariabler under Makrovariabler, der understøttes i XML URL-adresser. Det er kun HTTP- eller HTTP-protokoller, der understøttes i URL-adressen. |
XML User Name (XML-brugernavn) |
Standard: tom |
Brugernavn til XML-tjeneste til godkendelsesformål. Du kan også konfigurere denne parameter i telefonkonfigurations-XML-filen (cfg.xml) ved at indtaste en streng i dette format:
|
XML Password (XML-adgangskode) |
Standard: tom |
Adgangskode til XML-tjeneste for det angivne XML-Brugernavn. Den adgangskode, du angav i dette felt, vises i konfigurationsfilen (cfg.xml) som følgende:
|
Aktivér CISCO XML EXE |
Standard: nej Indstillinger: Ja, Nej |
Angiver, om godkendelse kræves for at få adgang til XML-programserveren. Du kan også konfigurere denne parameter i telefonkonfigurations-XML-filen (cfg.xml) ved at indtaste en streng i dette format:
|
CISCO XML EXE-godkendelsestilstand |
Standard: lokale legitimationsoplysninger Indstillinger: Betroet, Lokale legitimationsoplysninger, Fjernlegitimationsoplysninger |
Angiver godkendelsestilstanden for Cisco XML EXE.
Du kan også konfigurere denne parameter i telefonkonfigurations-XML-filen (cfg.xml) ved at indtaste en streng i dette format:
|
Føje et XML program til en programtast
Føj de ofte anvendte programmer til programtaster, så brugerne nemt kan få adgang til tjenesten.
Før du begynder
XML Application Service er konfigureret korrekt.
1 |
Gå til websiden til telefonadministration |
2 |
Vælg . |
3 |
I sektionen Programmable Softkeys (Programmerbare programtaster) skal du indstille Programmable Softkey Enable (Aktivér programmerbare programtaster) til Ja. Du kan også konfigurere denne parameter i konfigurationsfilen (cfg.xml). Angiv en streng i dette format:
|
4 |
I sektionen Programmerbare programtaster skal du redigere de tilgængelige felter i PSK1 til PSK16 i dette format: fnc=xml;url=<xml_app_path>; nme=<app_name>
hvor
Eksempel Du kan også konfigurere denne parameter i konfigurationsfilen (cfg.xml). Angiv en streng i dette format:
hvor n er programtastnummeret. |
5 |
Klik på Gem alle ændringer. |
Føje et XML program til en linjetast
Føj de ofte anvendte programmer til linjetasterne, så brugerne nemt kan få adgang til tjenesterne.
Før du begynder
XML Application Service er konfigureret korrekt.
1 |
Gå til websiden til telefonadministration |
2 |
Vælg . |
3 |
Vælg en linjetast. |
4 |
Indstil udvidelsesparameteren til Deaktiveret for at deaktivere udvidelsen. Hvis funktionen Direct PLK Configuration (Direkte PLK-konfiguration) er deaktiveret, skal du deaktivere lokalnummeret for at føje en udvidet funktion til linjetasten. Hvis funktionen er aktiveret, kan du springe dette trin over. Få flere oplysninger under Aktivér konfiguration af Direct PLK. |
5 |
I parameteren Udvidet funktion skal du angive en streng i dette format: fnc=xml;url=<xml_app_path>; nme=<app_name>
hvor
Eksempel Du kan også konfigurere denne parameter i konfigurationsfilen (cfg.xml). Angiv en streng i dette format:
hvor n er lokalnummeret. |
6 |
Klik på Gem alle ændringer. |
Makrovariabler, der understøttes i XML URL-adresser
Du kan bruge makrovariabler i XML-URL-adresser. Følgende makrovariabler understøttes:
-
Bruger-id – UID1, UID2 til UIDn
-
Visningsnavn – DISPLAYNAME1, DISPLAYNAME2 til DISPLAYNAMEn
-
Godkendelses-id – AUTHID1, AUTHID2 til AUTHIDn
-
Proxy – PROXY1, PROXY2 til PROXYn
-
MAC-adresse, der bruger hexcifre med små bogstaver – MA
-
Produktnavn – PN
-
Produktserienummer – PSN.
-
Serienummer – SERIAL_NUMBER
Makronavn | Makroudvidelse |
---|---|
$ | Formen $$ udvides til et enkelt $-tegn. |
A til og med P | Erstattes af parametrene GPP_A til og med GPP_P til generelle formål. |
SA til og med SD | Erstattes af parametrene GPP_SA til og med GPP_SD til særlige formål. Disse parametre opbevarer nøgler eller adgangskoder, der bruges ved klargøring. $SA til og med $SD genkendes som argumenter til den valgfri URL-kvalifikationer til gensynkronisering, --key. |
MA | MAC-adresse, der bruger hexcifre med små bogstaver (000e08aabbcc). |
MAU | MAC-adresse, der bruger hexcifre med store bogstaver (000E08AABBCC). |
MAC | MAC-adresse, der bruger hexcifre med små bogstaver med kolon for at adskille par af hexcifre (00:0e:08:aa:bb:cc). |
PN | Produktnavn; f.eks. Videotelefon 8875, Skrivebordstelefon 9851. |
PSN | produktserienummer; F.eks. 8875, 9841, 9861 |
SN | Serienummerstreng, f.eks. 88012BA01234. |
CCERT | Status for SSL-klientcertifikat, installeret eller ikke installeret. |
IP | IP-adresse for telefonen med dens lokale undernet, f.eks. 192.168.1.100. |
EXTIP | Ekstern IP for telefonen som set på internettet, f.eks. 66.43.16.52. |
SWVER |
Softwareversionsstreng. F.eks. PHONEOS.3-2-1-0104-37 |
HWVER |
Hardwareversionsstreng. For eksempel 2.0.1 |
PRVST |
Klargøringstilstand (en numerisk streng): -1 = eksplicit anmodning om gensynkronisering 0 = gensynkronisering ved start 1 = periodisk gensynkronisering 2 = gensynkronisering er mislykket, antal nye forsøg |
UPGST |
Opgraderingstilstand (en numerisk streng): 1 = første opgraderingsforsøg 2 = opgradering er mislykket, antal nye forsøg |
UPGERR |
Resulterende meddelelse (ERR) om tidligere opgraderingsforsøg; f.eks. http_get er mislykket. |
PRVTMR |
Sekunder siden sidste forsøg gensynkronisering. |
UPGTMR |
Sekunder siden sidste forsøg opgradering |
REGTMR1 |
Sekunder siden linje 1 mistede registrering med SIP-server. |
REGTMR2 |
Sekunder siden linje 2 mistede registrering med SIP-server. |
UPGCOND |
Tidligere makronavn. |
SCHEME |
Filadgangsskema, en af TFTP, HTTP eller HTTPS, som hentet efter parsing af URL-adresse til gensynkronisering eller opgradering. |
SERV |
Anmod om destinationsservers værtsnavn, som hentet efter under parsing af URL-adresse til gensynkronisering eller opgradering. |
SERVIP |
Anmod om destinationsservers IP-adresse, som hentet efter parsing af URL-adresse til gensynkronisering eller opgradering, muligvis efter DNS-opslag. |
PORT |
Anmod om destinations-UDP/TCP-port, som hentet efter parsing af URL-adresse til gensynkronisering eller opgradering. |
PATH |
Anmod om filsti, som hentet efter under parsing af URL-adresse til gensynkronisering eller opgradering. |
ERR |
Resulterende meddelelse om forsøg på gensynkronisering eller opgradering. Kun nyttig ved generering af resulterende syslog-meddelelser. Værdien bevares i variablen UPGERR i tilfælde af forsøg på opgradering. |
UIDn |
Indholdet af linje UserID-konfigurationsparameteren for linje n. |
ISCUST |
Hvis enhed er tilpasset, er værdi = 1 og ellers 0. Tilpasningsstatus kan ses på siden Web UI Info. |
INCOMINGNAME | Navn, der er knyttet til det første forbundne, ringende eller indgående opkald. |
REMOTENUMBER |
Telefonnummeret på første forbundne, ringende eller indgående opkald. Hvis der er flere opkald, bliver de data, der er knyttet til det første fundne opkald, leveret. |
DISPLAYNAMEn | Indholdet af konfigurationsparameteren for visningsnavn for linje n. |
AUTHIDn | Indholdet af godkendelses-id-konfigurationsparameteren for linje N. |