Oversikt

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

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

De støttede funksjonene er:

  • Meldinger (bilder og tekst)
  • Personsøking

Støttede XML objekter

  • CiscoIPPhoneMenu

  • CiscoIPPhoneText

  • CiscoIPPhoneInput

  • CiscoIPPhoneDirectory

  • CiscoIPPhoneImage

  • CiscoIPPhoneImageFile

  • CiscoIPPhoneIconMenu

  • CiscoIPPhoneIconFileMenu

  • CiscoIPPhoneStatus (unntatt 9841)

  • CiscoIPPhoneStatusFile (unntatt 9841)

  • CiscoIPPhoneExecute

Støttede URIer

  • Enhet

  • Urskive

  • EditDail

  • Init

  • Nøkkel

  • Spill av (bare ringetoner)

  • Funksjonstast

Hvis du vil ha mer informasjon om XSI-tjenestekonfigurasjonen, kan du se Cisco Unified IP Phone Merknader om programutvikling for tjenester.

Konfigurere en telefon til å koble til en XML-tjeneste

1

Åpne telefonens administrasjonsnettside.

2

Velg Stemme > Telefon.

3

I delen XML Service konfigurerer du XML Application Service Name og XML URL-adresseparametere for programtjeneste som definert i Parametere for XML tjenester.

4

(Valgfritt) Hvis du vil legge til godkjenning for tilgang til programtjenesten, konfigurerer du disse feltene: XML User Name,XML Password,CISCO XML EXE Enable og CISCO XML EXE Auth Mode.

5

Klikk Lagre alle endringer.

Parametere for XML tjenester

Tabellen nedenfor definerer funksjonen og bruken av XML programparameterne i delen XML Service under kategorien Voice > Phone i telefonens webgrensesnitt. Den definerer også syntaks for strengen som er lagt til i telefonens konfigurasjonsfil (cfg.xml) med XML-kode for å konfigurere en parameter.

Tabell 1. Parametere for XML tjenester

Parameter

Standard og alternativer

Beskrivelse

XML Navn på programtjeneste

Standard: tom

Navnet på XML programmet. Navnet vises på telefonen som et webprogramvalg.

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

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

XML URL-adresse for programtjeneste

Standard: tom

URL-adressen til det XML programmet ligger.

Du kan også konfigurere denne parameteren i XML cfg.xml filen for telefonkonfigurasjon () ved å angi 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-adresser. Hvis du vil se informasjon om gyldige makrovariabler, kan du se Makrovariabler som støttes i XML URL-adresser.

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

XML-brukernavn

Standard: tom

XML tjenestebrukernavn for godkjenningsformål.

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

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

XML-passord

Standard: tom

XML tjenestepassordet for det angitte XML brukernavnet.

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

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

CISCO XML EXE Aktiver

Standard: Ingen

Alternativer: Ja, Nei

Angir om godkjenning er nødvendig for å få tilgang til XML programserveren.

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

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

Godkjenningsmodus for CISCO XML EXE

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 den lokale legitimasjonen, hvis angitt. Hvis den lokale legitimasjonen ikke er angitt, utføres ingen godkjenning.

  • Ekstern legitimasjon – Godkjenning er basert på godkjenning av sammendrag ved hjelp av den eksterne legitimasjonen som angitt i XML programmet på websiden (for å få tilgang til en XML programserver).

Du kan også konfigurere denne parameteren i XML cfg.xml filen for telefonkonfigurasjon () ved å angi 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 applikasjonene til funksjonstaster for brukere å få tilgang til tjenesten enkelt.

Før du begynner

XML Application Service er riktig konfigurert.

1

Åpne telefonens administrasjonsnettside.

2

Velg Stemme > Telefon.

3

I delen Programmerbare funksjonstaster setter du Aktiver programmerbar funksjonstast 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 lenken der den XML applikasjonen er lagret; NME er visningsnavnet til programmet på telefonskjermen.

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

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=Menu<konfigurasjonskode></PSK_n>

der n er funksjonstastnummeret.

5

Klikk Lagre alle endringer.

Legge til et XML-program på en linjetast

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

Før du begynner

XML Application Service er riktig konfigurert.

1

Åpne telefonens administrasjonsnettside.

2

Velg Stemme > Telefon.

3

Velg en linjetast.

4

Sett Extension-parameteren til Disabled for å deaktivere utvidelsen.

Hvis funksjonen Direct PLK Configuration (Konfigurasjon av direkte PLK) er deaktivert, må du deaktivere internnummeret for å legge til en utvidet funksjon på 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 angir du en streng i dette formatet:

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

der url er lenken der den XML applikasjonen er lagret; NME er visningsnavnet til programmet på telefonskjermen.

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

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=Menu<konfigurasjonskode></Extended_Function_n_>

hvor n er internnummeret.

6

Klikk Lagre alle endringer.

Makrovariabler som støttes i XML URL-adresser

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

  • Bruker-ID – UID1, UID2 til UIDn

  • Visningsnavn – DISPLAYNAME1, DISPLAYNAME2 til DISPLAYNAMEn

  • Auth ID—AUTHID1, AUTHID2 til AUTHIDn

  • Proxy – PROXY1, PROXY2 til PROXYn

  • MAC Adresse med små hekskantsifre – MA

  • Produktnavn – PN

  • Produktserienummer – PSN

  • Serienummer – SERIAL_NUMBER

Tabell 2. Makroer som støttes
MakronavnMakroutvidelse
$Skjemaet $$ utvides til et enkelt $-tegn.
A til PErstattet av generelle parametere GPP_A til GPP_P.
SA til SDErstattes med spesialparametrene GPP_SA til GPP_SD. Disse parametrene inneholder nøkler eller passord som brukes i klargjøringen.
$SA til $SD gjenkjennes som argumenter til den valgfrie kvalifikatoren for resynkroniserings-URL-en, --nøkkel.
MAMAC adresse med små hex-sifre (000e08aabbcc).
MAUMAC adressen med sekskantsifre med store bokstaver (000E08AABBCC).
MACMAC adresse med små hex-sifre med kolon for å skille hex-sifferpar (00:0e:08:aa:bb:cc).
PNProduktnavn; for eksempel Videotelefon 8875, Bordtelefon 9851.
PSNproduktserienummer; For eksempel 8875, 9841, 9861
SNSerienummer streng; for eksempel 88012BA01234.
CCERTSSL Klientsertifikatstatus, installert eller ikke installert.
IPIP adressen til telefonen i det lokale delnettet, for eksempel 192.168.1.100.
EXTIPEksterne IP på telefonen, sett på Internett, for eksempel 66.43.16.52.

SWVER

Programvareversjonsstreng. Eksempel:

PHONEOS.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 = regelmessig resynkronisering

2 = mislykket synkronisering, nytt forsøk

UPGST

Oppgraderingstilstand (numerisk streng):

1 = første oppgraderingsforsøk

2 = mislykket oppgradering, nytt forsøk

UPGERR

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

PRVTMR

Sekunder siden forrige resynkroniseringsforsøk.

UPGTMR

Sekunder siden forrige oppgraderingsforsøk.

REGTMR1

Sekunder siden linje 1 mistet registrering med SIP-server.

REGTMR2

Sekunder siden linje 2 mistet registrering med SIP-server.

UPGCOND

Eldre makronavn.

SKJEMA

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

SERV

Vertsnavnet til målserver for forespørsler, som hentes etter analyse av resynkroniserings- eller oppgraderings-URL-en.

SERVIP

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

PORT

UDP/TCP-porten til målserver for forespørsler, som hentes etter analyse av resynkroniserings- eller oppgraderings-URL-en.

PATH

Filbanen til målserver for forespørsler, som hentes etter analyse av resynkroniserings- eller oppgraderings-URL-en.

ERR

Resultatmelding for resynkroniserings- eller oppgraderingsforsøk. Benyttes bare til å generere syslog-meldinger. Verdien beholdes i variabelen UPGERR til bruk ved oppgraderingsforsøk.

UIDn

Innholdet i konfigurasjonsparameteren Line n UserID.

ISCUST

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

Tilpassingsstatusen kan vises på siden Web UI Info.

INNKOMMENDE navnNavn tilknyttet første tilkoblet, ringende eller innkommende anrop.
REMOTENUMBER

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

DISPLAYNAMEnInnholdet i konfigurasjonsparameteren Linje N visningsnavn.
AUTHIDnInnholdet i konfigurasjonsparameteren Linje N autentiserings-ID.