- Hjem
- /
- Artikel
Tak for din feedback.
Konfiguration af XML-applikationer til 9800 og 8875 telefoner (BroadWorks)
I denne artikel
Har du feedback?Denne hjælpeartikel gælder for Cisco Desk Phone 9800-serien og Cisco Video Phone 8875, der er registreret i Cisco BroadWorks. Læs denne artikel for de understøttede XML-objekter, URI'er og trinene til konfiguration af XSI-tjenesterne på telefonens webside.
Oversigt
XML Services Interface (XSI) er en protokol, der tillader kommunikation mellem applikationer og telefonsystemet. Du kan føje dine egne XSI-tjenester til din telefon ved hjælp af de understøttede XML-objekter og URI'er.
Efter at have abonneret telefonen på tjenesterne, kan brugerne få adgang til alle de konfigurerede tjenester på telefonen ved at navigere til Inds tjenester. Cisco XML-tjenester er standardnavnet. Du kan også ændre navnet. For at give brugerne nem adgang kan du føje XML-programmerne til softkeys eller linjetaster.
De understøttede funktioner er:
- Beskeder (billeder og tekst)
- Personsøgning
Understøttede XML-objekter
-
CiscoIpPhoneMenu
-
CiscoIPPhoneTekst
-
CiscoIPPhone-indgang
-
CiscoIPPhoneDirectory
-
CiscoIPPhonebillede
-
CiscoIPPhoneImageFil
-
CiscoIPPhoneIconMenu
-
CiscoIPPhoneIconFileMenu
-
CiscoIPPhoneStatus (undtagen 9811 og 9841)
-
CiscoIPPhoneStatusFile (undtagen 9811 og 9841)
-
CiscoIPPhoneExecute
Understøttede URI'er
-
Enhed
-
Urskive
-
EditDail
-
Init
-
Nøgle
-
Afspil (kun ringetoner)
-
Funktionstast
Du kan finde flere oplysninger om XSI-tjenestekonfigurationen under Cisco Unified IP Phone Services Application Development Notes.
Konfigurere en telefon til at oprette forbindelse til en XML-tjeneste
| 1 |
Få adgang til telefonadministrationswebsiden. |
| 2 |
Vælg . |
| 3 |
I afsnittet XML-tjeneste skal du konfigurere parametrene XML Application Service Name og XML Application Service URL som defineret i Parametre for XML-tjenester. |
| 4 |
(Valgfrit) Hvis du vil tilføje godkendelse til adgang til programtjenesten, skal du konfigurere disse felter: XML-brugernavn, XML-adgangskode, CISCO XML EXE Akti ver og CISCO XML EXE Auth Mode. |
| 5 |
Klik på Gem alle ændringer. |
Parametre for XML-tjenester
Følgende tabel definerer funktionen og brugen af XML-programparametrene i afsnittet XML-tjeneste under fanen T i telefonens webgrænseflade. Det definerer også syntaksen for strengen, der tilføjes i telefonkonfigurationsfilen (cfg.xml) med XML-kode for at konfigurere en parameter.
|
Parameter |
Standard og indstillinger |
Beskrivelse |
|---|---|---|
|
Navn på XML-applikationstjeneste |
Standard: Tom |
Navnet på XML-programmet. Navnet vises på telefonen som et webapplikationsvalg. Du kan også konfigurere denne parameter i telefonkonfigurationens XML-fil (cfg.xml) ved at indtaste en streng i dette format: |
|
URL til XML-applikationstjeneste |
Standard: Tom |
URL-adressen, hvor XML-applikationen er placeret. Du kan også konfigurere denne parameter i telefonkonfigurationens XML-fil (cfg.xml) ved at indtaste en streng i dette format: Makrovariabler understøttes i XML-URL'er. For de gyldige makrovariabler, se Makrovariabler, der understøttes i XML-URL'er. Kun HTTP- eller HTTPS-protokoller understøttes i URL'en. |
|
XML-brugernavn |
Standard: Tom |
XML-tjenestens brugernavn til godkendelsesformål. Du kan også konfigurere denne parameter i telefonkonfigurationens XML-fil (cfg.xml) ved at indtaste en streng i dette format: |
|
XML-adgangskode |
Standard: Tom |
Adgangskode til XML-tjeneste for det angivne XML-brugernavn. Den adgangskode, du indtastede i dette felt, vises i konfigurationsfilen (cfg.xml) som følger: |
|
CISCO XML EXE Aktiver |
Standard: Nej Valgmuligheder: Ja, Nej |
Angiver, om godkendelse er påkrævet for at få adgang til XML-programserveren. Du kan også konfigurere denne parameter i telefonkonfigurationens XML-fil (cfg.xml) ved at indtaste en streng i dette format: |
|
CISCO XML EXE godkendelsestilstand |
Standard: Lokale legitimationsoplysninger Indstillinger: Pålidelig, Lokal legitimationsoplysninger, Fjernlegitimationsoplysninger |
Angiver godkendelsestilstand for Cisco XML EXE.
Du kan også konfigurere denne parameter i telefonkonfigurationens XML-fil (cfg.xml) ved at indtaste en streng i dette format: |
Føj et XML-program til en softkey
Tilføj de ofte anvendte applikationer til softkeys, så brugerne nemt kan få adgang til tjenesten.
Før du begynder
XML Application Service er konfigureret korrekt.
| 1 |
Få adgang til telefonadministrationswebsiden. |
| 2 |
Vælg . |
| 3 |
I afsnittet Programmerbare funktionstaster skal du indstille Aktiver programmerbare funktionstaster til Ja. Du kan også konfigurere denne parameter i konfigurationsfilen (cfg.xml). Indtast en streng i dette format: |
| 4 |
I afsnittet Programmerbare programtaster skal du redigere de tilgængelige felter i PSK1 til PSK 16 i dette format: fnc=xml;url=<xml_app_path>;nme=<app_name>
hvor
Eksempel
Du kan også konfigurere denne parameter i konfigurationsfilen (cfg.xml). Indtast en streng i dette format:
hvor n er softkeynummeret. |
| 5 |
Klik på Gem alle ændringer. |
Føj et XML-program til en linjetast
Tilføj de ofte anvendte applikationer til linjetaster, så brugerne nemt kan få adgang til tjenesterne.
Før du begynder
XML Application Service er konfigureret korrekt.
| 1 |
Få adgang til telefonadministrationswebsiden. |
| 2 |
Vælg . |
| 3 |
Vælg en linjetast. |
| 4 |
Indstil Extension parameter til De aktiveret for at deaktivere udvidelsen. Hvis funktionen Direkte PLK-konfiguration er deaktiveret, skal du deaktivere udvidelsen for at tilføje en udvidet funktion til linjetasten. Hvis funktionen er aktiveret, kan du springe dette trin over. Du kan finde flere oplysninger under Aktiver direkte PLK-konfiguration. |
| 5 |
Indtast en streng i dette format i parameteren Udvidet funktion: fnc=xml;url=<xml_app_path>;nme=<app_name>
hvor
Eksempel
Du kan også konfigurere denne parameter i konfigurationsfilen (cfg.xml). Indtast en streng i dette format:
hvor n er udvidelsesnummeret. |
| 6 |
Klik på Gem alle ændringer. |
Makrovariabler understøttet i XML-URL'er
Du kan bruge makrovariabler i XML-URL'er. Følgende makrovariabler understøttes:
-
Bruger-id — UID1, UID2 til UIDn
-
Visningsnavn—DisplayName1, DISPLAYNAME2 til DisplayNamen
-
Auth ID — AUTHID1, AUTHID2 til AuthIDN
-
Proxy—Proxy1, PROXY2 til ProxyN
-
MAC-adresse ved hjælp af små hex-tal — MA
-
Produktnavn—PN
-
Produktserienummer—PSN
-
Serienummer—Serienummer
| Makronavn | Makroudvidelse |
|---|---|
| $ | Formularen $$ udvides til et enkelt $ tegn. |
| A til P | Erstattet af generelle parametre GPP_A gennem GPP_P. |
| SA gennem SD | Erstattet af specielle formålsparametre GPP_SA gennem GPP_SD. Disse parametre indeholder nø
gler eller adgangskoder, der bruges til klargøring. $SA til $SD genkendes som argumenter til den valgfri resync-URL- kvalifikator, --key. |
| MA | MAC-adresse ved hjælp af små hex-cifre (000e08aabbcc). |
| MAU | MAC-adresse ved hjælp af store hex-cifre (000E08AABBCC). |
| MAC | MAC-adresse ved hjælp af små hex-cifre med et kolon til at adskille hexcifferpar (00:0 e:08:aa:bb:cc). |
| PN | Produktnavn; for eksempel Video Phone 8875, Desk Phone 9851. |
| PSN | Produktserienummer; for eksempel 8875, 9841, 9861 |
| SN | Serienummerstreng; f.eks. 88012BA01234. |
| CCERT | SSL-klientcertifikatstatus, installeret eller ikke installeret. |
| IP | Telefonens IP-adresse inden for dets lokale undernet; for eksempel 192.168.1.100. |
| EXTIP | Ekstern IP af telefonen, som det ses på internettet; for eksempel 66.43.16.52. |
|
SWVER |
Softwareversionsstreng. For eksempel PHONEOS.3-2-1-0104-37 |
|
HWVER |
Hardwareversionsstreng. For eksempel 2.0.1 |
|
PRVST |
Tilvejebringelsestilstand (en numerisk streng): -1 = eksplicit gensynkroniseringsanmodning 0 = gensynkronisering af opstart 1 = periodisk resync 2 = gensynkronisering mislykkedes, prøv igen |
|
UPGST |
Opgraderingstilstand (en numerisk streng): 1 = første opgraderingsforsøg 2 = opgradering mislykkedes, prøv igen |
|
UPGERR |
Resultatmeddelelse (ERR) fra tidligere opgraderingsforsøg; for eksempel http_get mislykkedes. |
|
PRVTMR |
Sekunder siden sidste gensynkroniseringsforsøg. |
|
UPGTMR |
Sekunder siden sidste opgraderingsforsøg. |
|
REGTMR1 |
Sekunder siden linje 1 mistede registrering med SIP-server. |
|
REGTMR2 |
Sekunder siden Line 2 mistede registreringen med SIP-serveren. |
|
UPGCOND |
Ældre makronavn. |
|
SCHEME |
Filadgangsskema, en af TFTP, HTTP eller HTTPS, som opnået efter analyse af resync eller opgradering af URL. |
|
SERV |
Anmod om værtsnavn på målserveren, som opnået efter analyse af resync- eller opgraderingswebadressen. |
|
SERVIP |
Anmod om målserverens IP-adresse, som opnået efter analyse af resync- eller opgraderingsURL, muligvis efter DNS-opslag. |
|
PORT |
Anmod om mål-UDP/TCP-port, som opnået efter analyse af resync- eller opgraderingsURL. |
|
PATH |
Anmod om målfilsti, som opnået efter analyse af resync- eller opgraderingswebadressen. |
|
ERR |
Resultatmeddelelse om gensynkronisering eller opgraderingsforsøg. Kun nyttigt til generering af resultatsyslog-meddelelser. Værdien bevares i UPGERR-variablen i tilfælde af opgraderingsforsøg. |
|
UIDn |
Indholdet af konfigurationsparameteren Line n UserID. |
| ISCUST |
Hvis enheden er tilpasset, værdi=1, ellers 0. Tilpasningsstatus kan ses på siden Web UI Info. |
| INCOMINGNAME | Navn, der er knyttet til det første tilsluttede, ringende eller indgående opkald. |
| REMOTENUMBER |
Telefonnummer for det første tilsluttede, ringende eller indgående opkald. Hvis der er flere opkald, leveres de data, der er knyttet til det første fundne opkald. |
| Visningsnavn | Indholdet af konfigurationsparameteren Line N Visningsnavn. |
| AuthenticIDN | Indholdet af konfigurationsparameteren Line N auth ID. |
