- Hjem
- /
- Artikkel
XML-programkonfigurasjon for telefoner på BroadWorks
Denne hjelpeartikkelen gjelder for Cisco bordtelefon 9800-serien og Cisco videotelefon 8875 som er registrert for Cisco BroadWorks. Les denne artikkelen for de støttede XML-objektene, URIene og trinnene for å konfigurere XSI-tjenestene på telefonens webside.
Oversikt
XML Services Interface (XSI) er en protokoll som tillater kommunikasjon mellom applikasjoner og telefonsystemet. Du kan legge til dine egne XSI-tjenester på telefonen ved å bruke de støttede XML objektene og URI-ene.
Når brukerne har abonnert på tjenestene, kan de få tilgang til alle konfigurerte tjenester på telefonen ved å gå til
. Cisco XML services er standardnavnet. Du kan også endre navnet. For å gi brukerne enkel tilgang kan du legge til de XML programmene i funksjonstaster eller linjetaster.De støttede funksjonene er:
- Meldinger (bilder og tekst)
- Personsøking
Støttede XML objekter
-
CiscoIPPhoneMenu
-
CiscoIPPhoneText
-
CiscoIPPhoneInput
-
CiscoIPPhoneDirectory
-
CiscoIPPhoneImage
-
CiscoIPPhoneImageFile
-
CiscoIPPhoneIconMenu
-
CiscoIPPhoneIconFileMenu
-
CiscoIPPhoneStatus (unntatt 9841)
-
CiscoIPPhoneStatusFile (unntatt 9841)
-
CiscoIPPhoneExecute
Støttede URIer
-
Enhet
-
Urskive
-
EditDail
-
Init
-
Nøkkel
-
Spill av (bare ringetoner)
-
Funksjonstast
Hvis du vil ha mer informasjon om XSI-tjenestekonfigurasjonen, kan du se Cisco Unified IP Phone Merknader om programutvikling for tjenester.
Konfigurere en telefon til å koble til en XML-tjeneste
1 |
Åpne telefonens administrasjonsnettside. |
2 |
Velg . |
3 |
I delen XML Service konfigurerer du XML Application Service Name og XML URL-adresseparametere for programtjeneste som definert i Parametere for XML tjenester. |
4 |
(Valgfritt) Hvis du vil legge til godkjenning for tilgang til programtjenesten, konfigurerer du disse feltene: XML User Name,XML Password,CISCO XML EXE Enable og CISCO XML EXE Auth Mode. |
5 |
Klikk Lagre alle endringer. |
Parametere for XML tjenester
Tabellen nedenfor definerer funksjonen og bruken av XML programparameterne i delen XML Service under i telefonens webgrensesnitt. Den definerer også syntaks for strengen som er lagt til i telefonens konfigurasjonsfil (cfg.xml) med XML-kode for å konfigurere en parameter.
Parameter |
Standard og alternativer |
Beskrivelse |
---|---|---|
XML Navn på programtjeneste |
Standard: tom |
Navnet på XML programmet. Navnet vises på telefonen som et webprogramvalg. Du kan også konfigurere denne parameteren i XML cfg.xml filen for telefonkonfigurasjon () ved å angi en streng i dette formatet:
|
XML URL-adresse for programtjeneste |
Standard: tom |
URL-adressen til det XML programmet ligger. Du kan også konfigurere denne parameteren i XML cfg.xml filen for telefonkonfigurasjon () ved å angi en streng i dette formatet:
Makrovariabler støttes i XML URL-adresser. Hvis du vil se informasjon om gyldige makrovariabler, kan du se Makrovariabler som støttes i XML URL-adresser. Bare HTTP- eller HTTP-protokoller støttes i URL-adressen. |
XML-brukernavn |
Standard: tom |
XML tjenestebrukernavn for godkjenningsformål. Du kan også konfigurere denne parameteren i XML cfg.xml filen for telefonkonfigurasjon () ved å angi en streng i dette formatet:
|
XML-passord |
Standard: tom |
XML tjenestepassordet for det angitte XML brukernavnet. Passordet du skrev inn i dette feltet, vises i konfigurasjonsfilen (cfg.xml) som følgende:
|
CISCO XML EXE Aktiver |
Standard: Ingen Alternativer: Ja, Nei |
Angir om godkjenning er nødvendig for å få tilgang til XML programserveren. Du kan også konfigurere denne parameteren i XML cfg.xml filen for telefonkonfigurasjon () ved å angi en streng i dette formatet:
|
Godkjenningsmodus for CISCO XML EXE |
Standard: Lokal legitimasjon Alternativer: Klarert, Lokal legitimasjon, Ekstern legitimasjon |
Angir godkjenningsmodus for Cisco XML EXE.
Du kan også konfigurere denne parameteren i XML cfg.xml filen for telefonkonfigurasjon () ved å angi en streng i dette formatet:
|
Legge til et XML program i en funksjonstast
Legg til de ofte brukte applikasjonene til funksjonstaster for brukere å få tilgang til tjenesten enkelt.
Før du begynner
XML Application Service er riktig konfigurert.
1 |
Åpne telefonens administrasjonsnettside. |
2 |
Velg . |
3 |
I delen Programmerbare funksjonstaster setter du Aktiver programmerbar funksjonstast til Ja. Du kan også konfigurere denne parameteren i konfigurasjonsfilen (cfg.xml). Skriv inn en streng i dette formatet:
|
4 |
I delen Programmerbare funksjonstaster redigerer du de tilgjengelige feltene fra PSK1 til PSK16 i dette formatet: fnc=xml;url=<xml_app_path>; nme=<app_name>
der
Eksempel Du kan også konfigurere denne parameteren i konfigurasjonsfilen (cfg.xml). Skriv inn en streng i dette formatet:
der n er funksjonstastnummeret. |
5 |
Klikk Lagre alle endringer. |
Legge til et XML-program på en linjetast
Legg til de ofte brukte programmene i linjetastene slik at brukerne enkelt kan få tilgang til tjenestene.
Før du begynner
XML Application Service er riktig konfigurert.
1 |
Åpne telefonens administrasjonsnettside. |
2 |
Velg . |
3 |
Velg en linjetast. |
4 |
Sett Extension-parameteren til Disabled for å deaktivere utvidelsen. Hvis funksjonen Direct PLK Configuration (Konfigurasjon av direkte PLK) er deaktivert, må du deaktivere internnummeret for å legge til en utvidet funksjon på linjetasten. Hvis funksjonen er aktivert, kan du hoppe over dette trinnet. Hvis du vil ha mer informasjon, kan du se Aktivere konfigurasjon av direkte PLK. |
5 |
I parameteren Utvidet funksjon angir du en streng i dette formatet: fnc=xml;url=<xml_app_path>; nme=<app_name>
der
Eksempel Du kan også konfigurere denne parameteren i konfigurasjonsfilen (cfg.xml). Skriv inn en streng i dette formatet:
hvor n er internnummeret. |
6 |
Klikk Lagre alle endringer. |
Makrovariabler som støttes i XML URL-adresser
Du kan bruke makrovariabler i XML URL-adresser. Følgende makrovariabler støttes:
-
Bruker-ID – UID1, UID2 til UIDn
-
Visningsnavn – DISPLAYNAME1, DISPLAYNAME2 til DISPLAYNAMEn
-
Auth ID—AUTHID1, AUTHID2 til AUTHIDn
-
Proxy – PROXY1, PROXY2 til PROXYn
-
MAC Adresse med små hekskantsifre – MA
-
Produktnavn – PN
-
Produktserienummer – PSN
-
Serienummer – SERIAL_NUMBER
Makronavn | Makroutvidelse |
---|---|
$ | Skjemaet $$ utvides til et enkelt $-tegn. |
A til P | Erstattet av generelle parametere GPP_A til GPP_P. |
SA til SD | Erstattes med spesialparametrene GPP_SA til GPP_SD. Disse parametrene inneholder nøkler eller passord som brukes i klargjøringen. $SA til $SD gjenkjennes som argumenter til den valgfrie kvalifikatoren for resynkroniserings-URL-en, --nøkkel. |
MA | MAC adresse med små hex-sifre (000e08aabbcc). |
MAU | MAC adressen med sekskantsifre med store bokstaver (000E08AABBCC). |
MAC | MAC adresse med små hex-sifre med kolon for å skille hex-sifferpar (00:0e:08:aa:bb:cc). |
PN | Produktnavn; for eksempel Videotelefon 8875, Bordtelefon 9851. |
PSN | produktserienummer; For eksempel 8875, 9841, 9861 |
SN | Serienummer streng; for eksempel 88012BA01234. |
CCERT | SSL Klientsertifikatstatus, installert eller ikke installert. |
IP | IP adressen til telefonen i det lokale delnettet, for eksempel 192.168.1.100. |
EXTIP | Eksterne IP på telefonen, sett på Internett, for eksempel 66.43.16.52. |
SWVER |
Programvareversjonsstreng. Eksempel: PHONEOS.3-2-1-0104-37 |
HWVER |
Maskinvareversjonsstreng. For eksempel 2.0.1 |
PRVST |
Klargjøringstilstand (numerisk streng): -1 = eksplisitt resynkroniseringsforespørsel 0 = resynkronisering ved oppstart 1 = regelmessig resynkronisering 2 = mislykket synkronisering, nytt forsøk |
UPGST |
Oppgraderingstilstand (numerisk streng): 1 = første oppgraderingsforsøk 2 = mislykket oppgradering, nytt forsøk |
UPGERR |
Resultatmelding (ERR) for forrige oppgraderingsforsøk; for eksempel http_get mislyktes. |
PRVTMR |
Sekunder siden forrige resynkroniseringsforsøk. |
UPGTMR |
Sekunder siden forrige oppgraderingsforsøk. |
REGTMR1 |
Sekunder siden linje 1 mistet registrering med SIP-server. |
REGTMR2 |
Sekunder siden linje 2 mistet registrering med SIP-server. |
UPGCOND |
Eldre makronavn. |
SKJEMA |
Filtilgangsskjema, enten TFTP, HTTP eller HTTPS, som hentes etter analyse av resynkroniserings- eller oppgraderings-URL-en. |
SERV |
Vertsnavnet til målserver for forespørsler, som hentes etter analyse av resynkroniserings- eller oppgraderings-URL-en. |
SERVIP |
IP-adressen til målserver for forespørsler, som hentes etter analyse av resynkroniserings- eller oppgraderings-URL-en, muligens etter DNS-oppslag. |
PORT |
UDP/TCP-porten til målserver for forespørsler, som hentes etter analyse av resynkroniserings- eller oppgraderings-URL-en. |
PATH |
Filbanen til målserver for forespørsler, som hentes etter analyse av resynkroniserings- eller oppgraderings-URL-en. |
ERR |
Resultatmelding for resynkroniserings- eller oppgraderingsforsøk. Benyttes bare til å generere syslog-meldinger. Verdien beholdes i variabelen UPGERR til bruk ved oppgraderingsforsøk. |
UIDn |
Innholdet i konfigurasjonsparameteren Line n UserID. |
ISCUST |
Hvis enheten er tilpasset, verdi = 1, ellers 0. Tilpassingsstatusen kan vises på siden Web UI Info. |
INNKOMMENDE navn | Navn tilknyttet første tilkoblet, ringende eller innkommende anrop. |
REMOTENUMBER |
Telefonnummeret til første tilkoblede, ringende eller innkommende anrop. Hvis det er flere anrop, oppgis dataene som er knyttet til det første anropet som blir funnet. |
DISPLAYNAMEn | Innholdet i konfigurasjonsparameteren Linje N visningsnavn. |
AUTHIDn | Innholdet i konfigurasjonsparameteren Linje N autentiserings-ID. |