- Hjem
- /
- Artikel
Tak for din feedback.
XML programkonfiguration til 9800- og 8875-telefoner (BroadWorks)
I denne artikel
Har du feedback?Denne Hjælp-artikel gælder for Cisco Desk Phone 9800 Series og Cisco Video Phone 8875, der er registreret til Cisco BroadWorks. Læs denne artikel om de understøttede XML objekter, URI'er og trinnene til konfiguration af XSI-tjenester på telefonwebsiden.
Oversigt
XML Services Interface (XSI) er en protokol, der tillader kommunikation mellem applikationer og telefonsystemet. Du kan føje dine egne XSI-tjenester til telefonen ved hjælp af de understøttede XML objekter og URI'er.
Når brugerne abonnerer på telefonen på tjenesterne, kan de få adgang til alle de konfigurerede tjenester på telefonen ved at gå til . Cisco XML tjenester er standardnavnet. Du kan også ændre navnet. For at give brugerne nem adgang kan du føje XML programmerne til programtaster eller linjetaster.
De understøttede funktioner er:
- Beskeder (billeder og tekst)
- Søger
Understøttede XML objekter
-
CiscoIPPhoneMenu
-
CiscoIPPhoneText
-
CiscoIPPhoneInput
-
CiscoIPPhoneDirectory
-
CiscoIPPhoneImage
-
CiscoIPPhoneImageFile
-
CiscoIPPhoneIconMenu
-
CiscoIPPhoneIconFileMenu
-
CiscoIPPhoneStatus (undtagen 9811 og 9841)
-
CiscoIPPhoneStatusFile (undtagen 9811 og 9841)
-
CiscoIPPhoneExecute
Understøttede URI'er
-
Enhed
-
Urskive
-
RedigerDail
-
Init
-
Nøgle
-
Afspil (kun ringetoner)
-
Programtast
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 |
Gå til websiden til telefonadministration |
| 2 |
Vælg . |
| 3 |
I afsnittet XML Tjeneste skal du konfigurere parametrene XML Applikationstjenestenavn og XML URL-adresse til programtjeneste som defineret i Parametre for XML-tjenester. |
| 4 |
(Valgfrit) Hvis du vil tilføje godkendelse for at få adgang til programtjenesten, skal du konfigurere disse felter: XML Brugernavn, XML adgangskode, Cisco XML EXE Aktivér og Cisco XML EXE-godkendelsestilstand. |
| 5 |
Klik på Gem alle ændringer. |
Parametre for XML-tjenester
Følgende tabel definerer funktionen og brugen af programparametrene XML i afsnittet XML tjeneste under Tab i telefonens webgrænseflade. Den definerer også syntaksen for den streng, der tilføjes i telefonkonfigurationsfilen (cfg.xml) med XML-kode, for at konfigurere en parameter.
|
Parameter |
Standard og indstillinger |
Beskrivelse |
|---|---|---|
|
XML Navn på programtjeneste |
Standard: tom |
Navnet på programmet XML. Navnet vises på telefonen som et webprogramvalg. Du kan også konfigurere denne parameter i telefonkonfigurationsfilen XML (cfg.XML) ved at angive en streng i dette format: |
|
XML URL-adresse til programtjeneste |
Standard: tom |
Den URL-adresse, hvor XML programmet er placeret. Du kan også konfigurere denne parameter i telefonkonfigurationsfilen XML (cfg.XML) ved at angive en streng i dette format: Makrovariabler understøttes i XML URL-adresser. Du kan finde gyldige makrovariabler under Makrovariabler, der understøttes i XML URL-adresser. Det er kun HTTP- eller HTTP-protokoller, der understøttes i URL-adressen. |
|
XML-brugernavn |
Standard: tom |
XML tjenestebrugernavn til godkendelsesformål. Du kan også konfigurere denne parameter i telefonkonfigurationsfilen XML (cfg.XML) ved at angive en streng i dette format: |
|
XML-adgangskode |
Standard: tom |
XML tjenesteadgangskode for det angivne XML brugernavn. Den adgangskode, du indtastede i dette felt, vises i konfigurationsfilen (cfg.XML) som følgende: |
|
Cisco XML EXE Enable (Aktivér EXE) |
Standard: nej Indstillinger: Ja, Nej |
Angiver om godkendelse er påkrævet for at få adgang til XML-programserveren. Du kan også konfigurere denne parameter i telefonkonfigurationsfilen XML (cfg.XML) ved at angive en streng i dette format: |
|
Cisco XML EXE-godkendelsestilstand |
Standard: Lokale legitimationsoplysninger Indstillinger: Betroet, Lokale legitimationsoplysninger, Fjernlegitimationsoplysninger |
Angiver godkendelsestilstanden for Cisco XML EXE.
Du kan også konfigurere denne parameter i telefonkonfigurationsfilen XML (cfg.XML) ved at angive en streng i dette format: |
Føj et XML-program til en programtast
Føj de ofte anvendte programmer til programtaster, så brugerne nemt kan få adgang til tjenesten.
Før du begynder
Programtjenesten XML er konfigureret korrekt.
| 1 |
Gå til websiden til telefonadministration |
| 2 |
Vælg . |
| 3 |
I sektionen Programmerbare programtaster skal du indstille Programmable Softkey Enable (Aktivér programmerbare programtaster ) til Ja. Du kan også konfigurere denne parameter i konfigurationsfilen (cfg.XML). Angiv en streng i dette format: |
| 4 |
I sektionen Programmerbare programtaster skal du redigere de tilgængelige felter i PSK1 til PSK16 i dette format: fnc=XML; url = <xml_app_path>; nme=<app_name>
hvor
Eksempel Du kan også konfigurere denne parameter i konfigurationsfilen (cfg.XML). Angiv en streng i dette format:
hvor n er programtastnummeret. |
| 5 |
Klik på Gem alle ændringer. |
Føj et XML-program til en linjetast
Føj de ofte anvendte programmer til linjetasterne, så brugerne nemt kan få adgang til tjenesterne.
Før du begynder
Programtjenesten XML er konfigureret korrekt.
| 1 |
Gå til websiden til telefonadministration |
| 2 |
Vælg . |
| 3 |
Vælg en linjetast. |
| 4 |
Indstil udvidelsesparameteren til Deaktiveret for at deaktivere udvidelsen. Hvis funktionen Direct PLK Configuration (Direkte PLK-konfiguration) er deaktiveret, skal du deaktivere lokalnummeret for at føje en udvidet funktion til linjetasten. Hvis funktionen er aktiveret, kan du springe dette trin over. Få flere oplysninger under Aktivér konfiguration af Direct PLK. |
| 5 |
I parameteren Udvidet funktion skal du angive en streng i dette format: fnc=XML; url = <xml_app_path>; nme=<app_name>
hvor
Eksempel Du kan også konfigurere denne parameter i konfigurationsfilen (cfg.XML). Angiv en streng i dette format:
hvor n er lokalnummeret. |
| 6 |
Klik på Gem alle ændringer. |
Makrovariabler, der understøttes i XML URL-adresser
Du kan bruge makrovariabler i XML URL-adresser. Følgende makrovariabler understøttes:
-
Bruger-id – UID1, UID2 til UIDn
-
Vist navn – DISPLAYNAME1, DISPLAYNAME2 til DISPLAYNAMEn
-
Auth ID – AUTHID1, AUTHID2 to AUTHIDn
-
Proxy – PROXY1, PROXY2 til PROXYn
-
MAC Adresse med små hex-cifre—MA
-
Produktnavn – PN
-
Produktserienummer – PSN
-
Serienummer – SERIAL_NUMBER
| Makronavn | Makroudvidelse |
|---|---|
| $ | Formen $$ udvides til et enkelt $-tegn. |
| A til og med P | Erstattet af parametre til generelle formål GPP_A til GPP_P. |
| SA til og med SD | Erstattes af parametrene GPP_SA til og med GPP_SD til særlige formål. Disse parametre opbevarer nøgler eller adgangskoder, der bruges ved klargøring. $SA til og med $SD genkendes som argumenter til den valgfri URL-kvalifikationer til gensynkronisering, --key. |
| MA | MAC-adresse med små hex-cifre (000e08ABBCC). |
| MAU | MAC adresse med store hex-cifre (000E08AABBCC). |
| MAC | MAC-adresse ved hjælp af små hex-cifre med et kolon til at adskille hex-cifferpar (00:0e:08:AA:bb:cc). |
| PN | Produktnavn; f.eks. Videotelefon 8875, Skrivebordstelefon 9851. |
| PSN | produktserienummer; F.eks. 8875, 9841, 9861 |
| SN | Serienummerstreng; f.eks. 88012BA01234. |
| CCERT | SSL Klientcertifikatstatus, installeret eller ikke installeret. |
| IP | IP adresse på telefonen på dens lokale undernet, f.eks. 192.168.1.100. |
| EXTIP | Telefonens eksterne IP, som den ses på internettet, f.eks. 66.43.16.52. |
|
SWVER |
Softwareversionsstreng. F.eks. PHONEOS.3-2-1-0104-37 |
|
HWVER |
Hardwareversionsstreng. For eksempel 2.0.1 |
|
PRVST |
Klargøringstilstand (en numerisk streng): -1 = eksplicit anmodning om gensynkronisering 0 = gensynkronisering ved start 1 = periodisk gensynkronisering 2 = gensynkronisering er mislykket, antal nye forsøg |
|
UPGST |
Opgraderingstilstand (en numerisk streng): 1 = første opgraderingsforsøg 2 = opgradering er mislykket, antal nye forsøg |
|
UPGERR |
Resulterende meddelelse (ERR) om tidligere opgraderingsforsøg; f.eks. http_get er mislykket. |
|
PRVTMR |
Sekunder siden sidste forsøg gensynkronisering. |
|
UPGTMR |
Sekunder siden sidste forsøg opgradering |
|
REGTMR1 |
Sekunder siden linje 1 mistede registrering med SIP-server. |
|
REGTMR2 |
Sekunder siden linje 2 mistede registrering med SIP-server. |
|
UPGCOND |
Tidligere makronavn. |
|
SCHEME |
Filadgangsskema, en af TFTP, HTTP eller HTTPS, som hentet efter parsing af URL-adresse til gensynkronisering eller opgradering. |
|
SERV |
Anmod om destinationsservers værtsnavn, som hentet efter under parsing af URL-adresse til gensynkronisering eller opgradering. |
|
SERVIP |
Anmod om destinationsservers IP-adresse, som hentet efter parsing af URL-adresse til gensynkronisering eller opgradering, muligvis efter DNS-opslag. |
|
PORT |
Anmod om destinations-UDP/TCP-port, som hentet efter parsing af URL-adresse til gensynkronisering eller opgradering. |
|
PATH |
Anmod om filsti, som hentet efter under parsing af URL-adresse til gensynkronisering eller opgradering. |
|
ERR |
Resulterende meddelelse om forsøg på gensynkronisering eller opgradering. Kun nyttig ved generering af resulterende syslog-meddelelser. Værdien bevares i variablen UPGERR i tilfælde af forsøg på opgradering. |
|
UIDn |
Indholdet af linje UserID-konfigurationsparameteren for linje n. |
| ISCUST |
Hvis enheden tilpasses, værdi = 1, ellers 0. Tilpasningsstatus kan ses på siden Web UI Info. |
| INCOMINGNAME | Navn, der er knyttet til først forbundne, ringende eller indgående opkald. |
| FJERNNUMMER |
Telefonnummer for første tilsluttede, ringende eller indgående opkald. Hvis der er flere opkald, leveres de data, der er tilknyttet det første opkald, der blev fundet. |
| DISPLAYNAMEn | Indholdet af konfigurationsparameteren Line N Display Name. |
| AUTHIDn | Indholdet af konfigurationsparameteren Line N-godkendelses-id. |
