- Hjem
- /
- Artikkel
Takk for tilbakemeldingen.
XML-applikasjonskonfigurasjon for 9800 og 8875 telefoner (BroadWorks)
I denne artikkelen
Tilbakemelding?Denne hjelpeartikkelen gjelder Cisco Desk Phone 9800-serien og Cisco Video Phone 8875 som er registrert i Cisco BroadWorks. Les denne artikkelen for støttede XML-objekter, URIer 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 hjelp av de støttede XML-objektene og URIene.
Etter å ha abonnert telefonen på tjenestene, kan brukerne få tilgang til alle de konfigurerte tjenestene på telefonen ved å navigere til Inn tjenester. Cisco XML-tjenester er standardnavnet. Du kan også endre navnet. For å gi brukerne enkel tilgang, kan du legge XML-programmene til funksjonstaster eller linjetaster.
De støttede funksjonene er:
- Meldinger (bilder og tekst)
- Personsøking
Støttede XML-objekter
-
CiscoIpPhoneMenu
-
CiscoIPPhoneTekst
-
CiscoIPPhone-inngang
-
CiscoIPPhone-katalog
-
CiscoIPPhoneBilde
-
ciscoIPPhoneImageFil
-
CiscoIPPhoneIconMenu
-
CiscoIPPhoneIconFileMenu
-
CiscoIPPhoneStatus (unntatt 9811 og 9841)
-
CiscoIPPhoneStatusFile (unntatt 9811 og 9841)
-
CiscoIPPhoneExecute
Støttede URIer
-
Enhet
-
Urskive
-
Rediger Dail
-
Init
-
Nøkkel
-
Spill av (kun ringetoner)
-
Funksjonstast
Hvis du vil ha mer informasjon om konfigurasjonen av XSI-tjenesten, kan du se Cisco Unified IP Phone Services Application Development Notes.
Konfigurere en telefon for å koble til en XML-tjeneste
| 1 |
Gå til telefonadministrasjonens webside. |
| 2 |
Velg . |
| 3 |
I XML-tjeneste- delen konfigurerer du parametrene for XML-applikasjonstjenestenavn og URL for XML-applik asjonstjeneste som definert i Parametre for XML-tjenester. |
| 4 |
(Valgfritt) Hvis du vil legge til godkjenning for tilgang til applikasjonstjenesten, konfigurerer du disse feltene: X ML-brukernavn, XML-passord, CISCO XML EXE Enable og CISCO XML EXE Auth Mode. |
| 5 |
Klikk Lagre alle endringer. |
Parametre for XML-tjenester
Tabellen nedenfor definerer funksjonen og bruken av XML-programparametrene i XML-tjeneste- delen under kategorien 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 |
|---|---|---|
|
XML-applikasjonstjenestenavn |
Standard: Tom |
Navnet på XML-programmet. Navnet vises på telefonen som et valg av webapplikasjon. Du kan også konfigurere denne parameteren i XML-filen for telefonkonfigurasjon (cfg.xml) ved å skrive inn en streng i dette formatet: |
|
URL for XML-applikasjonstjeneste |
Standard: Tom |
URL-adressen der XML-applikasjonen er plassert. 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-adresser. For gyldige makrovariabler, se Mak rovariabler som støttes i XML-URL-adresser. Bare HTTP- eller HTTPS-protokoller støttes i URL-en. |
|
XML-brukernavn |
Standard: Tom |
XML-tjenestens brukernavn for autentiseringsformå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: Tom |
XML-tjenestepassord for det angitte XML-brukernavnet. Passordet du skrev inn i dette feltet vises i konfigurasjonsfilen (cfg.xml) som følger: |
|
CISCO XML EXE Aktiver |
Standard: Nei Alternativer: Ja, Nei |
Angir om godkjenning er nødvendig 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 Mode |
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 applikasjonene i funksjonstaster slik at brukerne enkelt kan få tilgang til tjenesten.
Før du begynner
XML-applikasjonstjenesten er riktig konfigurert.
| 1 |
Gå til telefonadministrasjonens webside. |
| 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 i PSK1 til PSK 16 i dette formatet: fnc=xml;url=<xml_app_path>;nme=<app_name>
hvor
Eksempel
Du kan også konfigurere denne parameteren i konfigurasjonsfilen (cfg.xml). Skriv inn en streng i dette formatet:
hvor n er softkey tallet. |
| 5 |
Klikk Lagre alle endringer. |
Legge til et XML-program i en linjetast
Legg til de ofte brukte applikasjonene til linjetastene slik at brukerne enkelt kan få tilgang til tjenestene.
Før du begynner
XML-applikasjonstjenesten er riktig konfigurert.
| 1 |
Gå til telefonadministrasjonens webside. |
| 2 |
Velg . |
| 3 |
Velg en linjetast. |
| 4 |
Sett ut videlses parameteren til De aktivert for å deaktivere utvidelsen. Hvis funksjonen Direkte PLK-konfigurasjon 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 direkte PLK-konfigurasjon. |
| 5 |
I parameteren Utvidet funksjon skriver du inn en streng i dette formatet: fnc=xml;url=<xml_app_path>;nme=<app_name>
hvor
Eksempel
Du kan også konfigurere denne parameteren i konfigurasjonsfilen (cfg.xml). Skriv inn en streng i dette formatet:
hvor n er utvidelsesnummeret. |
| 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 ved bruk av små heksagaltall — MA
-
Produktnavn — PN
-
Produktserienummer—PSN
-
Serienummer — Serienummer
| Makronavn | Makroutvidelse |
|---|---|
| $ | Skjemaet $$ utvides til et enkelt $ tegn. |
| A til og med P | Erstatt av generelle parametere GPP_A gjennom GPP_P. |
| SA gjennom SD | Erstatt av spesielle formålsparametere GPP_SA gjennom GPP_SD. Disse parametrene
inneholder nøkler eller passord som brukes i klargjøring. $SA til $SD gjenkjennes som argumenter for den valgfrie resync-URL- kvalifiseringen, --key. |
| MA | MAC-adresse ved hjelp av små bokstaver sekskantsifre (000e08aabbcc). |
| MAU | MAC-adresse med store bokstaver med sekskantsifre (000E08AABBCC). |
| MAC | MAC-adresse som bruker små sekskantsifre med et kolon for å skille sekskantsifrepar (00:0 e:08:aa:bb: cc). |
| PN | Produktnavn; for eksempel videotelefon 8875, skrivebordstelefon 9851. |
| PSN | Produktserienummer; for eksempel 8875, 9841, 9861 |
| SN | Serienummerstreng; 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 | Ekstern IP på telefonen, som sett på internett; for eksempel 66.43.16.52. |
|
SWVER |
Programvareversjonsstreng. For eksempel, PHONEOS.3-2-1-0104-37 |
|
HWVER |
Maskinvareversjonsstreng. For eksempel 2.0.1 |
|
PRVST |
Klargjøringstilstand (en numerisk streng): -1 = eksplisitt forespørsel om synkronisering 0 = oppstart på nytt synkronisering 1 = periodisk resynk 2 = resynkronisering mislyktes, prøv på nytt |
|
UPGST |
Oppgraderingstilstand (en numerisk streng): 1 = første oppgraderingsforsøk 2 = oppgradering mislyktes, prøv på nytt |
|
UPGERR |
Resultatmelding (ERR) fra tidligere oppgraderingsforsøk; for eksempel http_get mislyktes. |
|
PRVTMR |
Sekunder siden siste synkroniseringsforsøk. |
|
UPGTMR |
Sekunder siden siste oppgraderingsforsøk. |
|
REGTMR1 |
Sekunder siden Linje 1 mistet registreringen med SIP-serveren. |
|
REGTMR2 |
Sekunder siden Line 2 mistet registreringen med SIP-serveren. |
|
UPGCOND |
Eldre makronavn. |
|
SCHEME |
Filtilgangsskjema, en av TFTP, HTTP eller HTTPS, som oppnådd etter analyse av resynkronisering eller oppgradering av URL. |
|
SERV |
Be om vertsnavn for målserveren, som oppnådd etter analyse av resynkronisering eller oppgraderingsnettadresse. |
|
SERVIP |
Be om IP-adressen til målserveren, som oppnådd etter analyse av resynkronisering eller oppgradering av URL, muligens etter DNS-oppslag. |
|
PORT |
Be om mål-UDP/TCP-port, som oppnådd etter analyse av resynkronisering eller oppgraderingsnettadresse. |
|
PATH |
Be om målfilbane, som oppnådd etter analyse av resynkronisering eller oppgraderingsnettadresse. |
|
ERR |
Resultatmelding om resynkronisering eller oppgraderingsforsøk. Bare nyttig for å generere resultatsyslog-meldinger. Verdien bevares i UPGERR-variabelen i tilfelle oppgraderingsforsøk. |
|
UIDn |
Innholdet i konfigurasjonsparameteren Line n UserID. |
| ISCUST |
Hvis enheten er tilpasset, verdi=1, ellers 0. Tilpasningsstatus er synlig på Web UI Info-siden. |
| INCOMINGNAME | Navn knyttet til første tilkoblede, ringende eller innkommende anrop. |
| REMOTENUMBER |
Telefonnummeret til det første tilkoblede, ringende eller innkommende anropet. Hvis det er flere anrop, blir dataene knyttet til det første anropet som er funnet, gitt. |
| Visningsnavn | Innholdet i konfigurasjonsparameteren Line N Display Name. |
| AuthenticIDN | Innholdet i konfigurasjonsparameteren Line N autentiserings-ID. |
