- Hjem
- /
- Artikkel
Takk for tilbakemeldingen.
XML programkonfigurasjon for 9800- og 8875-telefoner (BroadWorks)
I denne artikkelen
Tilbakemelding?Denne hjelpeartikkelen gjelder for Cisco Desk Phone 9800-serien og Cisco Video Phone 8875 som er registrert i Cisco BroadWorks. Les denne artikkelen for de støttede XML-objektene, URI-ene 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.
Etter å ha abonnert telefonen på tjenestene, kan brukere få tilgang til alle konfigurerte tjenester på telefonen ved å navigere til . Cisco XML services er standardnavnet. Du kan også endre navnet. For å gi brukerne enkel tilgang, kan du legge til XML-applikasjonene til 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 9811 og 9841)
-
CiscoIPPhoneStatusFile (unntatt 9811 og 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 Services Application Development Notes.
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 Brukernavn, XML Passord, Cisco XML EXE-aktivering og Cisco XML EXE-godkjenningsmodus. |
| 5 |
Klikk Lagre alle endringer. |
Parametere for XML-tjenester
Tabellen nedenfor definerer funksjonen og bruken av XML-programparameterne i delen XML Service under Tab 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å applikasjonstjeneste |
Standard: tom |
Navnet på XML programmet. Navnet vises på telefonen som et webprogramvalg. Du kan også konfigurere denne parameteren i filen XML telefonkonfigurasjon (cfg.XML) ved å angi en streng i dette formatet: |
|
XML URL for applikasjonstjeneste |
Standard: tom |
URL-adressen til XML programmet ligger. Du kan også konfigurere denne parameteren i filen XML telefonkonfigurasjon (cfg.XML) ved å angi en streng i dette formatet: Makrovariabler støttes i URL-adresser XML. Hvis du vil ha informasjon om gyldige makrovariabler, kan du se Makrovariabler som støttes i URL-adresser for XML. Bare HTTP- eller HTTP-protokoller støttes i URL-adressen. |
|
XML-brukernavn |
Standard: tom |
XML tjenestebrukernavn for autentiseringsformål. Du kan også konfigurere denne parameteren i filen XML telefonkonfigurasjon (cfg.XML) ved å angi 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ø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 filen XML telefonkonfigurasjon (cfg.XML) ved å angi en streng i dette formatet: |
|
Cisco XML EXE autentiseringsmodus |
Standard: Lokal legitimasjon Alternativer: Klarert, Lokal legitimasjon, Ekstern legitimasjon |
Angir godkjenningsmodus for Cisco XML EXE.
Du kan også konfigurere denne parameteren i filen XML telefonkonfigurasjon (cfg.XML) ved å angi en streng i dette formatet: |
Legg til et XML program til 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 URL-adresser XML
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å hex-sifre-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 adresse 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. |
