Oversigt

XML Services Interface (XSI) er en protokol, der giver mulighed for kommunikation mellem programmer 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.

Når du har abonneret på telefonen til tjenesterne, kan brugere få adgang til alle de konfigurerede tjenester på telefonen ved at navigere til Indstillinger > Netværk og tjeneste > Cisco XML-tjenester. 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:

  • Meddelelser (billeder og tekst)
  • Personsøgning

Understøttede XML-objekter

  • CiscoIP-telefonMenu

  • CiscoIPhoneText

  • CiscoIPhoneInput

  • Cisco IPhoneDirectory

  • Cisco IPhoneImage

  • CiscoIPhoneImageFile

  • CiscoIP-telefonIconMenu

  • CiscoIPhoneIconFileMenu

  • CiscoIPhoneStatus (undtagen 9841)

  • CiscoIPhoneStatusFile (undtagen 9841)

  • CiscoIPhoneExecute

Understøttede URI'er

  • Enhed

  • Ring op

  • RedigerDail

  • Igangsætning

  • Nøgle

  • Afspil (kun ringetoner)

  • Programtast

Få flere oplysninger om konfigurationen af XSI-tjenesten i Programudviklingsnoter til Cisco Unified IP-telefontjenester.

Konfigurer en telefon til at oprette forbindelse til en XML-tjeneste

1

Gå til telefonens administrationswebside.

2

Vælg Stemme > Telefon.

3

I afsnittet XML-tjeneste skal du konfigurere parametrene for XML-programtjeneste og URL-adresse for XML-programtjeneste som defineret i Parametre for XML-tjenester.

4

(Valgfri) Hvis du vil tilføje godkendelse for at få adgang til applikationstjenesten, skal du konfigurere tesefelter: 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 XML-programparametrene i afsnittet XML-tjeneste under fanen Stemme > Telefon 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.

Tabel 1. Parametre for XML-tjenester

Parameter

Standard og valgmuligheder

Beskrivelse

Navn på XML-programtjeneste

Standard: Tom

Navn på XML-programmet. Navnet vises på telefonen som en webprogramvalgmulighed.

Du kan også konfigurere denne parameter i telefonkonfigurations-XML-filen (cfg.xml) ved at angive en streng i dette format:

<XML_Application_Service_Name ua="na">XML-APPNAVN</XML_Application_Service_Name>

URL-adresse til XML-programtjeneste

Standard: Tom

Den URL-adresse, hvor XML-programmet er placeret.

Du kan også konfigurere denne parameter i telefonkonfigurations-XML-filen (cfg.xml) ved at angive en streng i dette format:

<XML_Application_Service_URL ua="na">https://server.com/path/app.xml</XML_Application_Service_URL>

Makrovariabler understøttes i XML-URL-adresser. Se Makrovariabler, der understøttes i XML-URL-adresser for de gyldige makrovariabler.

Det er kun HTTP- eller HTTP-protokoller, der understøttes i URL-adressen.

XML-brugernavn

Standard: Tom

Brugernavn til XML-tjeneste til godkendelsesformål.

Du kan også konfigurere denne parameter i telefonkonfigurations-XML-filen (cfg.xml) ved at angive en streng i dette format:

<XML_User_Name ua="na">brugernavn</XML_User_Name>

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:

<!-- <XML_Password ua="na">;*************</XML_Password> -->

Aktivér CISCO XML EXE

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 telefonkonfigurations-XML-filen (cfg.xml) ved at angive en streng i dette format:

<CISCO_XML_EXE_Enable ua="na">Ja</CISCO_XML_EXE_Enable>

CISCO XML EXE-godkendelsestilstand

Standard: Lokale legitimationsoplysninger

Valgmuligheder: Pålidelige, lokale legitimationsoplysninger, eksterne legitimationsoplysninger

Angiver godkendelsestilstanden for Cisco XML EXE.

  • Pålidelig – der udføres ingen godkendelse uanset de lokale legitimationsoplysninger.

  • Lokale legitimationsoplysninger – godkendelse er baseret på digest-godkendelse ved hjælp af de lokale legitimationsoplysninger, hvis de er angivet. Hvis de lokale legitimationsoplysninger ikke er angivet, udføres der ingen godkendelse.

  • Eksterne legitimationsoplysninger – godkendelse er baseret på digest-godkendelse ved hjælp af de eksterne legitimationsoplysninger som angivet i XML-programmet på websiden (for at få adgang til en XML-programserver).

Du kan også konfigurere denne parameter i telefonkonfigurations-XML-filen (cfg.xml) ved at angive en streng i dette format:

<CISCO_XML_EXE_Auth_Mode ua="na">Lokale legitimationsoplysninger</CISCO_XML_EXE_Auth_Mode>

Føj et XML-program til en programtast

Føj de hyppigt anvendte programmer til programtaster, så brugere nemt kan få adgang til tjenesten.

Før du begynder

XML-programtjenesten er blevet konfigureret korrekt.

1

Gå til telefonens administrationswebside.

2

Vælg Stemme > Telefon.

3

I afsnittet Programmerbare programtaster skal du indstille Aktivér programmerbar programtast til Ja.

Du kan også konfigurere denne parameter i konfigurationsfilen (cfg.xml). Indtast en streng i dette format:

<Programmable_Softkey_Enable ua="na">Ja</Programmable_Softkey_Enable>
4

I afsnittet Programmerbare programtaster skal du redigere de tilgængelige felter for PSK1 til PSK16 i dette format:

fnc=xml;url=<xml_app_path>;nme=<app_name>

hvor URL-adresse er linket, hvor XML-programmet er gemt; nme er programmets viste navn på telefonskærmen.

Eksempel fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu

Du kan også konfigurere denne parameter i konfigurationsfilen (cfg.xml). Indtast en streng i dette format:

<PSK_n ua="na">fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu<configuration code></PSK_n>

hvor n er programtastnummeret.

5

Klik på Gem alle ændringer.

Føj et XML-program til en linjetast

Føj de hyppigt anvendte programmer til linjetaster, så brugere nemt kan få adgang til tjenesterne.

Før du begynder

XML-programtjenesten er blevet konfigureret korrekt.

1

Gå til telefonens administrationswebside.

2

Vælg Stemme > Telefon.

3

Vælg en linjetast.

4

Indstil parameteren Lokalnummer til Deaktiveret for at deaktivere lokalnummeret.

Hvis funktionen 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. Se Aktivér direkte PLK-konfiguration for detaljer.
5

I parameteren Udvidet funktion skal du indtaste en streng i dette format:

fnc=xml;url=<xml_app_path>;nme=<app_name>

hvor URL-adresse er linket, hvor XML-programmet er gemt; nme er programmets viste navn på telefonskærmen.

Eksempel fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu

Du kan også konfigurere denne parameter i konfigurationsfilen (cfg.xml). Indtast en streng i dette format:

<Extended_Function_n_ ua="na">fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu<configuration code></Extended_Function_n_>

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

  • Godkendelses-id – AUTHID1, AUTHID2 til AUTHIDn

  • Proxy – PROXY1, PROXY2 til PROXYn

  • MAC-adresse, der bruger hexcifre med små bogstaver – MA

  • Produktnavn – PN

  • Produktserienummer – PSN

  • Serienummer – SERIENUMMER

Tabel 2. Understøttede makroer
MakronavnMakroudvidelse
$Formen $$ udvides til et enkelt $-tegn.
A til og med PErstattes af parametrene GPP_A til og med GPP_P til generelle formål.
SA til og med SDErstattet af parametrene GPP_SA til og med GPP_SD til specielle formål. Disse parametre indeholder nøgler eller adgangskoder, der bruges ved klargøring.
$SA til og med $SD genkendes som argumenter til den valgfri URL-kvalifikation til gensynkronisering, --key.
maMAC-adresse, der bruger hexcifre med små bogstaver (000e08aabbcc).
MAUMAC-adresse, der bruger hexcifre med store bogstaver (000E08AABBCC).
macMAC-adresse, der bruger hexcifre med små bogstaver med et kolon for at adskille par af hexcifre (00:0e:08:aa:bb:cc).
PNProduktnavn; f.eks. videotelefon 8875, bordtelefon 9851.
PSNProduktserienummer; f.eks. 8875, 9841, 9861
snSerienummer streng; f.eks. 88012BA01234.
ccert (flertydig)Status for SSL-klientcertifikat, installeret eller ikke installeret.
IPIP-adresse på telefonen inden for dens lokale undernet; f.eks. 192.168.1.100.
extipTelefonens eksterne IP, som set på internettet, f.eks. 66.43.16.52.

svæver

Streng til softwareversion. Eksempel:

telefoner.3-2-1-0104-37

hwver

Streng til hardwareversion. F.eks. 2.0.1

prvst

Klargøringstilstand (en numerisk streng):

-1 = eksplicit anmodning om gensynkronisering

0 = gensynkronisering af tænding

1 = periodisk gensynkronisering

2 = gensynkronisering mislykkedes, forsøg igen

opgst

Opgraderingstilstand (en numerisk streng):

1 = første opgraderingsforsøg

2 = opgradering mislykkedes, forsøg igen

upgerr

Resultatmeddelelse (ERR) for tidligere opgraderingsforsøg; f.eks. http_get mislykkedes.

prvtmr

Sekunder siden sidste forsøg på gensynkronisering.

upgtmr

Sekunder siden sidste forsøg på opgradering.

rækkmr1

Sekunder siden linje 1 mistede registreringen med SIP-server.

tænd/sluk2

Sekunder siden linje 2 mistede registrering med SIP-server.

upgcond

Ældre makronavn.

ordning

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 parsing af URL-adresse til gensynkronisering eller opgradering.

Servip-bevægelsen

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.

søgesti

Anmod om destinationsfilsti, som hentet efter parsing af URL-adresse til gensynkronisering eller opgradering.

fejl

Resultatmeddelelse om forsøg på gensynkronisering eller opgradering. Kun nyttig ved generering af resultatsyslog-meddelelser. Værdien bevares i variablen UPGERR i tilfælde af opgraderingsforsøg.

UIDn

Indholdet af linje n UserID-konfigurationsparameter.

islænding

Hvis enheden er brugertilpasset, er værdien = 1, ellers 0.

Tilpasningsstatus kan ses på websiden med oplysninger om brugergrænsefladen.

indtastningsnavnNavn, der er knyttet til det første forbundne, ringende eller indgående opkald.
fjernnummer

Telefonnummeret på det første forbundne, ringende eller indgående opkald. Hvis der er flere opkald, angives de data, der er knyttet til det første fundne opkald.

DISPLAYNAMEnIndholdet af konfigurationsparameteren for linje N-visningsnavn.
Godkendelses-idIndholdet af konfigurationsparameteren for linje N-godkendelses-id.