Oversikt

XML Services Interface (XSI) er en protokoll som tillater kommunikasjon mellom programmer og telefonsystemet. Du kan legge til dine egne XSI-tjenester på telefonen ved hjelp av de støttede XML-objektene og URI-ene.

Når du har abonnert på telefonen til tjenestene, kan brukerne få tilgang til alle de konfigurerte tjenestene på telefonen ved å gå til Innstillinger > Nettverk og tjeneste > Cisco XML-tjenester. Cisco XML-tjenester er standardnavnet. Du kan også endre navnet. For å gi brukeren enkel tilgang kan du legge til XML-programmene i funksjonstaster eller linjetaster.

De støttede funksjonene er:

  • Meldinger (bilder og tekst)
  • Oppkall

Støttede XML-objekter

  • Cisco IP-telefonMeny

  • Cisco IP-telefonTekst

  • Cisco IPhoneInput

  • Cisco IPhoneDirectory

  • Cisco IP-telefonBilde

  • Cisco IPPhoneImageFile

  • Cisco IPhoneIconMenu

  • Cisco IPPhoneIconFileMenu

  • Cisco IPPhone-status (unntatt 9841)

  • Cisco IPPhoneStatusFile (unntatt 9841)

  • CiscoIPhoneExecute

Støttede URI-er

  • Enhet

  • Ring

  • RedigerDail

  • Innspill

  • Nøkkel

  • Spill av (kun ringetoner)

  • Funksjonstast

Hvis du vil ha mer informasjon om konfigurasjonen av XSI-tjenesten, kan du se Programutviklingsmerknader for Cisco Unified IP Phone Services.

Konfigurere en telefon for å koble til en XML-tjeneste

1

Gå inn på telefonens administrasjonsnettside.

2

Velg Tale > Telefon.

3

I delen XML-tjeneste konfigurerer du parametrene XML-programtjenestens navn og URL-adresse for XML-programtjeneste slik de er definert i Parametere for XML-tjenester.

4

(Valgfritt) Hvis du vil legge til godkjenning for tilgang til programtjenesten, konfigurerer du avdelingsfeltene: XML-brukernavn, XML-passord, CISCO XML EXE Enable og CISCO XML EXE Auth Mode.

5

Klikk på Lagre alle endringer.

Parametre for XML-tjenester

Tabellen nedenfor definerer funksjonen og bruken av XML-programparameterne i delen XML-tjeneste under fanen Tale > Telefon i telefonens webgrensesnitt. Den definerer også syntaksen til strengen som legges til i telefonkonfigurasjonsfilen (cfg.xml) med XML-kode for å konfigurere en parameter.

Tabell 1. Parametre for XML-tjenester

Parameter

Standard og alternativer

Beskrivelse

Navn på XML-programtjeneste

Standard: Tomt

Navn på XML-programmet. Navnet vises på telefonen som et webprogram.

Du kan også konfigurere denne parameteren i XML-filen for telefonkonfigurasjon (cfg.xml) ved å skrive inn en streng i dette formatet:

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

URL for XML-programtjeneste

Standard: Tomt

URL-adressen der XML-programmet befinner seg.

Du kan også konfigurere denne parameteren i XML-filen for telefonkonfigurasjon (cfg.xml) ved å skrive inn en streng i dette formatet:

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

Makrovariabler støttes i XML-URL-er. For gyldige makrovariabler, se Makrovariabler som støttes i XML-URL-er.

Bare HTTP- eller HTTP-protokoller støttes i URL-adressen.

XML-brukernavn

Standard: Tomt

XML-tjenestens brukernavn for godkjenningsformål.

Du kan også konfigurere denne parameteren i XML-filen for telefonkonfigurasjon (cfg.xml) ved å skrive inn en streng i dette formatet:

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

XML-passord

Standard: Tomt

XML-tjenestepassord for det angitte XML-brukernavnet.

Passordet du skrev inn i dette feltet, vises i konfigurasjonsfilen (cfg.xml) som følger:

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

Aktiver CISCO XML EXE

Standard: Nei

Alternativer: Ja, nei

Angir om godkjenning kreves for å få tilgang til XML-programserveren.

Du kan også konfigurere denne parameteren i XML-filen for telefonkonfigurasjon (cfg.xml) ved å skrive inn en streng i dette formatet:

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

CISCO XML EXE Auth-modus

Standard: Lokal legitimasjon

Alternativer: Klarert, lokal legitimasjon, ekstern legitimasjon

Angir godkjenningsmodus for Cisco XML EXE.

  • Klarert – Ingen godkjenning utføres uavhengig av den lokale legitimasjonen.

  • Lokal legitimasjon – Godkjenning er basert på sammendragsgodkjenning ved hjelp av lokal legitimasjon, hvis angitt. Hvis den lokale legitimasjonen ikke er angitt, utføres ingen godkjenning.

  • Ekstern legitimasjon – Autentisering er basert på sammendragsgodkjenning ved hjelp av ekstern legitimasjon som angitt i XML-programmet på nettsiden (for å få tilgang til en XML-programserver).

Du kan også konfigurere denne parameteren i XML-filen for telefonkonfigurasjon (cfg.xml) ved å skrive inn en streng i dette formatet:

<CISCO_XML_EXE_Auth_Mode ua="na">Lokal legitimasjon</CISCO_XML_EXE_Auth_Mode>

Legge til et XML-program i en funksjonstast

Legg til de ofte brukte programmene i funksjonstastene slik at brukerne enkelt får tilgang til tjenesten.

Før du starter

XML-applikasjonstjenesten er riktig konfigurert.

1

Gå inn på telefonens administrasjonsnettside.

2

Velg Tale > Telefon.

3

I delen Programmerbare funksjonstaster angir du Programmerbare funksjonstaster Aktiver til Ja.

Du kan også konfigurere denne parameteren i konfigurasjonsfilen (cfg.xml). Skriv inn en streng i dette formatet:

<Programmable_Softkey_Enable ua="na">Ja</Programmable_Softkey_Enable>
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 url er koblingen der XML-programmet lagres; nme er visningsnavnet på programmet på telefonskjermen.

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

Du kan også konfigurere denne parameteren i konfigurasjonsfilen (cfg.xml). Skriv inn en streng i dette formatet:

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

hvor n er funksjonstastnummeret.

5

Klikk på Lagre alle endringer.

Legge til et XML-program i en linjetast

Legg til de ofte brukte programmene til linjetastene slik at brukerne enkelt får tilgang til tjenestene.

Før du starter

XML-applikasjonstjenesten er riktig konfigurert.

1

Gå inn på telefonens administrasjonsnettside.

2

Velg Tale > Telefon.

3

Velg en linjetast.

4

Sett parameteren Internnummer til Deaktivert for å deaktivere internnummeret.

Hvis funksjonen Direct PLK Configuration er deaktivert, må du deaktivere utvidelsen for å legge til en utvidet funksjon i 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 skriver du inn en streng i dette formatet:

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

der url er koblingen der XML-programmet lagres; nme er visningsnavnet på programmet på telefonskjermen.

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

Du kan også konfigurere denne parameteren i konfigurasjonsfilen (cfg.xml). Skriv inn en streng i dette formatet:

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

hvor n er internnummeret.

6

Klikk på Lagre alle endringer.

Makrovariabler som støttes i XML-URL-er

Du kan bruke makrovariabler i XML URL-er. Følgende makrovariabler støttes:

  • Bruker-ID – UID1, UID2 til UIDn

  • Visningsnavn – VISNINGSNAVN1, VISNINGSNAVN2 til VISNINGSNAVNn

  • Auth ID – AUTHID1, AUTHID2 til AUTHIDn

  • Proxy – PROXY1, PROXY2 til PROXYn

  • MAC-adresse med små heksadesimale sifre – MA

  • Produktnavn – PN

  • Produktserienummer – PSN

  • Serienummer – SERIENUMMER

Tabell 2. Makroer som støttes
MakronavnMakroutvidelse
$Skjemaet $$ utvides til et enkelt $-tegn.
A til PErstattet med generelle parametere fra GPP_A til GPP_P.
SA til SDErstattet med spesialparametere GPP_SA til GPP_SD. Disse parametrene inneholder nøkler eller passord som brukes ved klargjøring.
$SA til $SD gjenkjennes som argumenter til den valgfrie resynkroniserings-URL-kvalifikatoren, --nøkkelen.
maMAC-adresse med små heksadesimale sifre (000e08aabbcc).
MAUMAC-adresse som bruker heksadesimale sifre med store bokstaver (000E08AABBCC).
macMAC-adresse som bruker små heksadesimale sifre med kolon for å skille heksadesimale sifferpar (00:0e:08:aa:bb:cc).
PNProduktnavn, for eksempel Videotelefon 8875, Bordtelefon 9851.
PSNProduktserienummer; for eksempel 8875, 9841, 9861
snSerienummerstreng; for eksempel 88012BA01234.
SvinghjulSSL-klientsertifikatstatus, installert eller ikke installert.
IPIP-adressen til telefonen i det lokale subnettet; for eksempel 192.168.1.100.
extipTelefonens eksterne IP, som vist på Internett; for eksempel 66.43.16.52.

swinger

Programvareversjonsstreng. For eksempel:

telefonnummer 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 = periodisk resynkronisering

2 = mislykket resynkronisering, forsøk på nytt

oppgst

Oppgraderingstilstand (numerisk streng):

1 = første oppgraderingsforsøk

2 = mislykket oppgradering, forsøk på nytt

oppgjørr

Resultatmelding (ERR) fra forrige oppgraderingsforsøk; for eksempel http_get mislyktes.

prvtmr

Sekunder siden forrige resynkroniseringsforsøk.

oppgtmr

Sekunder siden forrige oppgraderingsforsøk.

forsterkning1

Sekunder siden linje 1 mistet registrering med SIP-server.

foring2

Sekunder siden linje 2 mistet registrering med SIP-server.

oppgcond

Eldre makronavn.

oppsett

Filtilgangsskjema, en av TFTP, HTTP eller HTTPS, som hentes etter analyse av resynkroniserings- eller oppgraderings-URL-en.

serv

Vertsnavn på målserver for forespørsel, som hentes etter analyse av resynkroniserings- eller oppgraderings-URL-adressen.

servise

IP-adresse for målserver for forespørsel, som hentes etter analyse av resynkroniserings- eller oppgraderings-URL-en, muligens etter DNS-oppslag.

port

UDP/TCP-porten til forespørselsmål, som hentes etter analyse av resynkroniserings- eller oppgraderings-URL-adressen.

bane

Filbane for forespørselsmål, som hentes etter analyse av resynkroniserings- eller oppgraderings-URL-en.

err

Resultatmelding for forsøk på resynkronisering eller oppgradering. Kun nyttig i å generere resultatsyslog-meldinger. Verdien beholdes i UPGERR-variabelen ved oppgraderingsforsøk.

UIDn

Innholdet i konfigurasjonsparameteren Line n UserID.

iscust

Hvis enheten er tilpasset, verdi = 1, ellers 0.

Tilpasningsstatus vises på informasjonssiden for Web-brukergrensesnitt.

innringingsnavnNavn knyttet til første tilkoblede, ringende eller innkommende anrop.
fjernbetjeningsnummer

Telefonnummeret til første tilkoblede, ringende eller innkommende anrop. Hvis det er flere samtaler, blir dataene knyttet til det første anropet som ble funnet, oppgitt.

VISNINGSNAVNnInnholdet i konfigurasjonsparameteren for linje N-visningsnavn.
AUTHIDnInnholdet i konfigurasjonsparameteren for linje N auth ID.