- Hjem
- /
- Artikkel
XML-applikasjonskonfigurasjon for telefoner på BroadWorks
Denne hjelpeartikkelen gjelder for Cisco Desk Phone 9800-serien og Cisco Video Phone 8875 som er registrert hos Cisco BroadWorks. Les denne artikkelen for støttede XML-objekter, URI-er og fremgangsmåten for å konfigurere XSI-tjenestene på telefonnettsiden.
Oversikt
XML Services Interface (XSI) er en protokoll som tillater kommunikasjon mellom programmer og telefonsystemet. Du kan legge til dine egne XSI-tjenester på telefonen ved hjelp av de støttede XML-objektene og URI-ene.
Når du har abonnert på telefonen til tjenestene, kan brukerne få tilgang til alle de konfigurerte tjenestene på telefonen ved å gå til
. Cisco XML-tjenester er standardnavnet. Du kan også endre navnet. For å gi brukeren enkel tilgang kan du legge til XML-programmene i funksjonstaster eller linjetaster.De støttede funksjonene er:
- Meldinger (bilder og tekst)
- Oppkall
Støttede XML-objekter
-
Cisco IP-telefonMeny
-
Cisco IP-telefonTekst
-
Cisco IPhoneInput
-
Cisco IPhoneDirectory
-
Cisco IP-telefonBilde
-
Cisco IPPhoneImageFile
-
Cisco IPhoneIconMenu
-
Cisco IPPhoneIconFileMenu
-
Cisco IPPhone-status (unntatt 9841)
-
Cisco IPPhoneStatusFile (unntatt 9841)
-
CiscoIPhoneExecute
Støttede URI-er
-
Enhet
-
Ring
-
RedigerDail
-
Innspill
-
Nøkkel
-
Spill av (kun ringetoner)
-
Funksjonstast
Hvis du vil ha mer informasjon om konfigurasjonen av XSI-tjenesten, kan du se Programutviklingsmerknader for Cisco Unified IP Phone Services.
Konfigurere en telefon for å koble til en XML-tjeneste
1 |
Gå inn på telefonens administrasjonsnettside. |
2 |
Velg . |
3 |
I delen XML-tjeneste konfigurerer du parametrene XML-programtjenestens navn og URL-adresse for XML-programtjeneste slik de er definert i Parametere for XML-tjenester. |
4 |
(Valgfritt) Hvis du vil legge til godkjenning for tilgang til programtjenesten, konfigurerer du avdelingsfeltene: XML-brukernavn, XML-passord, CISCO XML EXE Enable og CISCO XML EXE Auth Mode. |
5 |
Klikk på Lagre alle endringer. |
Parametre for XML-tjenester
Tabellen nedenfor definerer funksjonen og bruken av XML-programparameterne i delen XML-tjeneste under fanen i telefonens webgrensesnitt. Den definerer også syntaksen til strengen som legges til i telefonkonfigurasjonsfilen (cfg.xml) med XML-kode for å konfigurere en parameter.
Parameter |
Standard og alternativer |
Beskrivelse |
---|---|---|
Navn på XML-programtjeneste |
Standard: Tomt |
Navn på XML-programmet. Navnet vises på telefonen som et webprogram. Du kan også konfigurere denne parameteren i XML-filen for telefonkonfigurasjon (cfg.xml) ved å skrive inn en streng i dette formatet:
|
URL for XML-programtjeneste |
Standard: Tomt |
URL-adressen der XML-programmet befinner seg. Du kan også konfigurere denne parameteren i XML-filen for telefonkonfigurasjon (cfg.xml) ved å skrive inn en streng i dette formatet:
Makrovariabler støttes i XML-URL-er. For gyldige makrovariabler, se Makrovariabler som støttes i XML-URL-er. Bare HTTP- eller HTTP-protokoller støttes i URL-adressen. |
XML-brukernavn |
Standard: Tomt |
XML-tjenestens brukernavn for godkjenningsformål. Du kan også konfigurere denne parameteren i XML-filen for telefonkonfigurasjon (cfg.xml) ved å skrive inn en streng i dette formatet:
|
XML-passord |
Standard: Tomt |
XML-tjenestepassord for det angitte XML-brukernavnet. Passordet du skrev inn i dette feltet, vises i konfigurasjonsfilen (cfg.xml) som følger:
|
Aktiver CISCO XML EXE |
Standard: Nei Alternativer: Ja, nei |
Angir om godkjenning kreves for å få tilgang til XML-programserveren. Du kan også konfigurere denne parameteren i XML-filen for telefonkonfigurasjon (cfg.xml) ved å skrive inn en streng i dette formatet:
|
CISCO XML EXE Auth-modus |
Standard: Lokal legitimasjon Alternativer: Klarert, lokal legitimasjon, ekstern legitimasjon |
Angir godkjenningsmodus for Cisco XML EXE.
Du kan også konfigurere denne parameteren i XML-filen for telefonkonfigurasjon (cfg.xml) ved å skrive inn en streng i dette formatet:
|
Legge til et XML-program i en funksjonstast
Legg til de ofte brukte programmene i funksjonstastene slik at brukerne enkelt får tilgang til tjenesten.
Før du starter
XML-applikasjonstjenesten er riktig konfigurert.
1 |
Gå inn på telefonens administrasjonsnettside. |
2 |
Velg . |
3 |
I delen Programmerbare funksjonstaster angir du Programmerbare funksjonstaster Aktiver 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 url er koblingen der XML-programmet lagres; nme er visningsnavnet på programmet på telefonskjermen.
Eksempel
Du kan også konfigurere denne parameteren i konfigurasjonsfilen (cfg.xml). Skriv inn en streng i dette formatet:
hvor n er funksjonstastnummeret. |
5 |
Klikk på Lagre alle endringer. |
Legge til et XML-program i en linjetast
Legg til de ofte brukte programmene til linjetastene slik at brukerne enkelt får tilgang til tjenestene.
Før du starter
XML-applikasjonstjenesten er riktig konfigurert.
1 |
Gå inn på telefonens administrasjonsnettside. |
2 |
Velg . |
3 |
Velg en linjetast. |
4 |
Sett parameteren Internnummer til Deaktivert for å deaktivere internnummeret. Hvis funksjonen Direct PLK Configuration er deaktivert, må du deaktivere utvidelsen for å legge til en utvidet funksjon i 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 skriver du inn en streng i dette formatet: fnc=xml;url=<xml_app_path>;nme=<app_name>
der url er koblingen der XML-programmet lagres; nme er visningsnavnet på programmet på telefonskjermen.
Eksempel
Du kan også konfigurere denne parameteren i konfigurasjonsfilen (cfg.xml). Skriv inn en streng i dette formatet:
hvor n er internnummeret. |
6 |
Klikk på Lagre alle endringer. |
Makrovariabler som støttes i XML-URL-er
Du kan bruke makrovariabler i XML URL-er. Følgende makrovariabler støttes:
-
Bruker-ID – UID1, UID2 til UIDn
-
Visningsnavn – VISNINGSNAVN1, VISNINGSNAVN2 til VISNINGSNAVNn
-
Auth ID – AUTHID1, AUTHID2 til AUTHIDn
-
Proxy – PROXY1, PROXY2 til PROXYn
-
MAC-adresse med små heksadesimale sifre – MA
-
Produktnavn – PN
-
Produktserienummer – PSN
-
Serienummer – SERIENUMMER
Makronavn | Makroutvidelse |
---|---|
$ | Skjemaet $$ utvides til et enkelt $-tegn. |
A til P | Erstattet med generelle parametere fra GPP_A til GPP_P. |
SA til SD | Erstattet med spesialparametere GPP_SA til GPP_SD. Disse parametrene inneholder nøkler eller passord som brukes ved klargjøring. $SA til $SD gjenkjennes som argumenter til den valgfrie resynkroniserings-URL-kvalifikatoren, --nøkkelen. |
ma | MAC-adresse med små heksadesimale sifre (000e08aabbcc). |
MAU | MAC-adresse som bruker heksadesimale sifre med store bokstaver (000E08AABBCC). |
mac | MAC-adresse som bruker små heksadesimale sifre med kolon for å skille heksadesimale sifferpar (00:0e:08:aa:bb:cc). |
PN | Produktnavn, for eksempel Videotelefon 8875, Bordtelefon 9851. |
PSN | Produktserienummer; for eksempel 8875, 9841, 9861 |
sn | Serienummerstreng; for eksempel 88012BA01234. |
Svinghjul | SSL-klientsertifikatstatus, installert eller ikke installert. |
IP | IP-adressen til telefonen i det lokale subnettet; for eksempel 192.168.1.100. |
extip | Telefonens eksterne IP, som vist på Internett; for eksempel 66.43.16.52. |
swinger |
Programvareversjonsstreng. For eksempel: telefonnummer 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 = periodisk resynkronisering 2 = mislykket resynkronisering, forsøk på nytt |
oppgst |
Oppgraderingstilstand (numerisk streng): 1 = første oppgraderingsforsøk 2 = mislykket oppgradering, forsøk på nytt |
oppgjørr |
Resultatmelding (ERR) fra forrige oppgraderingsforsøk; for eksempel http_get mislyktes. |
prvtmr |
Sekunder siden forrige resynkroniseringsforsøk. |
oppgtmr |
Sekunder siden forrige oppgraderingsforsøk. |
forsterkning1 |
Sekunder siden linje 1 mistet registrering med SIP-server. |
foring2 |
Sekunder siden linje 2 mistet registrering med SIP-server. |
oppgcond |
Eldre makronavn. |
oppsett |
Filtilgangsskjema, en av TFTP, HTTP eller HTTPS, som hentes etter analyse av resynkroniserings- eller oppgraderings-URL-en. |
serv |
Vertsnavn på målserver for forespørsel, som hentes etter analyse av resynkroniserings- eller oppgraderings-URL-adressen. |
servise |
IP-adresse for målserver for forespørsel, som hentes etter analyse av resynkroniserings- eller oppgraderings-URL-en, muligens etter DNS-oppslag. |
port |
UDP/TCP-porten til forespørselsmål, som hentes etter analyse av resynkroniserings- eller oppgraderings-URL-adressen. |
bane |
Filbane for forespørselsmål, som hentes etter analyse av resynkroniserings- eller oppgraderings-URL-en. |
err |
Resultatmelding for forsøk på resynkronisering eller oppgradering. Kun nyttig i å generere resultatsyslog-meldinger. Verdien beholdes i UPGERR-variabelen ved oppgraderingsforsøk. |
UIDn |
Innholdet i konfigurasjonsparameteren Line n UserID. |
iscust |
Hvis enheten er tilpasset, verdi = 1, ellers 0. Tilpasningsstatus vises på informasjonssiden for Web-brukergrensesnitt. |
innringingsnavn | Navn knyttet til første tilkoblede, ringende eller innkommende anrop. |
fjernbetjeningsnummer |
Telefonnummeret til første tilkoblede, ringende eller innkommende anrop. Hvis det er flere samtaler, blir dataene knyttet til det første anropet som ble funnet, oppgitt. |
VISNINGSNAVNn | Innholdet i konfigurasjonsparameteren for linje N-visningsnavn. |
AUTHIDn | Innholdet i konfigurasjonsparameteren for linje N auth ID. |