Oversigt

XML Services Interface (XSI) er en protokol, der tillader kommunikation mellem programmer 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 Indstillinger > Netværk og tjeneste > Cisco XML tjenester. Standardnavnet er Cisco XML tjenester. Du kan også ændre navnet. For at give brugerne nem adgang kan du føje de XML programmer 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 9841)

  • CiscoIPPhoneStatusFile (undtagen 9841)

  • CiscoIPPhoneExecute

Understøttede URI'er

  • Enhed

  • Urskive

  • RedigerDail

  • Init

  • Nøgle

  • Afspil (kun ringetoner)

  • Programtast

Du kan finde flere oplysninger om konfigurationen af XSI-tjenesten 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 Tale > Telefon.

3

Konfigurer parametrene XML Application Service Name og XML Application Service URL (Applikationstjeneste) i afsnittet XML Service (Tjeneste ), som defineret i Parametre for XML tjenester .

4

(Valgfrit) Hvis du vil tilføje godkendelse for adgang til programtjenesten, skal du konfigurere disse felter: XML Brugernavn,XML adgangskode,CISCO XML EXE Enable og CISCO XML EXE Auth Mode.

5

Klik på Gem alle ændringer.

Parametre for XML tjenester

Følgende tabel definerer funktionen og brugen af de XML programparametre i afsnittet XML tjeneste under fanen Tale > 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 indstillinger

Beskrivelse

XML Application Service Name (Navn på XML-programtjeneste)

Standard: tom

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

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

<XML_Application_Service_Name ua="na">XML APP-navn</XML_Application_Service_Name>

XML Application Service URL (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 indtaste 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. Du kan finde oplysninger om 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 User Name (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 indtaste en streng i dette format:

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

XML Password (XML-adgangskode)

Standard: tom

Adgangskode til XML-tjeneste for det angivne XML-Brugernavn.

Den adgangskode, du angav i dette felt, vises i konfigurationsfilen (cfg.xml) som følgende:

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

Aktivér CISCO XML EXE

Standard: nej

Indstillinger: Ja, Nej

Angiver, om godkendelse kræves for at få adgang til XML-programserveren.

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

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

CISCO XML EXE-godkendelsestilstand

Standard: lokale legitimationsoplysninger

Indstillinger: Betroet, Lokale legitimationsoplysninger, Fjernlegitimationsoplysninger

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 sådanne er indstillet. Hvis lokale legitimationsoplysninger ikke er indstillet, sker der ingen godkendelse.

  • Eksterne legitimationsoplysninger – godkendelse baseres på digest-godkendelse ved hjælp af de eksterne legitimationsoplysninger, som er 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 indtaste en streng i dette format:

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

Føje 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

XML Application Service er konfigureret korrekt.

1

Gå til websiden til telefonadministration

2

Vælg Tale > Telefon.

3

I sektionen Programmable Softkeys (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:

<Programmable_Softkey_Enable ua="na">Ja</Programmable_Softkey_Enable>
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 URL er linket, hvor den XML applikation er gemt; NME er programmets visningsnavn 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). Angiv en streng i dette format:

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

hvor n er programtastnummeret.

5

Klik på Gem alle ændringer.

Føje 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

XML Application Service er konfigureret korrekt.

1

Gå til websiden til telefonadministration

2

Vælg Tale > Telefon.

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 URL er linket, hvor den XML applikation er gemt; NME er programmets visningsnavn 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). Angiv en streng i dette format:

<Extended_Function_n_ ua="na">fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu<konfigurationskode></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

  • Visningsnavn – 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 – SERIAL_NUMBER

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 SDErstattes 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.
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 kolon for at adskille par af hexcifre (00:0e:08:aa:bb:cc).
PNProduktnavn; f.eks. Videotelefon 8875, Skrivebordstelefon 9851.
PSNproduktserienummer; F.eks. 8875, 9841, 9861
SNSerienummerstreng, f.eks. 88012BA01234.
CCERTStatus for SSL-klientcertifikat, installeret eller ikke installeret.
IPIP-adresse for telefonen med dens lokale undernet, f.eks. 192.168.1.100.
EXTIPEkstern IP for telefonen som set 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 enhed er tilpasset, er værdi = 1 og ellers 0.

Tilpasningsstatus kan ses på siden Web UI Info.

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

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

DISPLAYNAMEnIndholdet af konfigurationsparameteren for visningsnavn for linje n.
AUTHIDnIndholdet af godkendelses-id-konfigurationsparameteren for linje N.