Översikt

XML Services Interface (XSI) är ett protokoll som möjliggör kommunikation mellan applikationer och telefonsystemet. Du kan lägga till egna XSI-tjänster på telefonen med de XML objekt och URI:er som stöds.

När du har abonnerat på tjänsterna kan användarna komma åt alla konfigurerade tjänster på telefonen genom att gå till Inställningar > nätverk och tjänst > Cisco XML tjänster. Cisco XML tjänster är standardnamnet. Du kan också ändra namnet. Om du vill ge användarna enkel åtkomst kan du lägga till de XML programmen i programstyrda knappar eller linjetangenter.

De funktioner som stöds är:

  • Meddelanden (bilder och text)
  • Personsökning

Objekt som stöds XML

  • CiscoIPPhoneMenu

  • CiscoIPPhoneText

  • CiscoIPPhoneInput

  • CiscoIPPhoneDirectory

  • CiscoIPPhoneImage

  • CiscoIPPhoneImageFile

  • CiscoIPPhoneIconMenu

  • CiscoIPPhoneIconFileMenu

  • CiscoIPPhoneStatus (utom 9841)

  • CiscoIPPhoneStatusFile (utom 9841)

  • CiscoIPPhoneExecute

URI:er som stöds

  • Enhet

  • Slå

  • EditDail

  • Init

  • Nyckel

  • Spela upp (endast ringsignaler)

  • Programstyrd knapp

Mer information om XSI-tjänstkonfigurationen finns i Cisco Unified IP Phone Anteckningar om utveckling av tjänsteprogram.

Konfigurera en telefon för anslutning till en XML tjänst

1

Öppna webbsidan för telefonadministration.

2

Välj Röst > Telefon.

3

I avsnittet XML tjänst konfigurerar du parametrarna XML Application Service Name och XML Application Service URL enligt definitionen i Parametrar för XML tjänster.

4

(Valfritt) Om du vill lägga till autentisering för åtkomst till programtjänsten konfigurerar du dessa fält: XML användarnamn,XML lösenord,CISCO XML EXE Aktivera och CISCO XML EXE-autentiseringsläge.

5

Klicka på Spara alla ändringar.

Parametrar för XML tjänster

I följande tabell definieras funktionen och användningen av XML programparametrar i avsnittet XML Service under fliken Röst> telefon i telefonens webbgränssnitt. Den definierar även syntax för strängen som läggs till i telefonens konfigurationsfil (cfg.xml) med XML-kod för att konfigurera en parameter.

Tabell 1. Parametrar för XML tjänster

Parameter

Standard och alternativ

Beskrivning

Namn på XML-programtjänsten

Standard: tomt

Namn på XML-programmet. Namnet visas på telefonen som ett webbprogramval.

Du kan även konfigurera den här parametern i telefonens konfigurationsfil (cfg.xml) genom att ange en sträng i det här formatet:

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

URL till XML-programtjänsten

Standard: tomt

URL där XML-programmet finns.

Du kan även konfigurera den här parametern i telefonens konfigurationsfil (cfg.xml) genom att ange en sträng i det här formatet:

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

Makrovariabler stöds i XML-URL:er. Information om giltiga makrovariabler finns i Makrovariabler som stöds i XML URL:er.

Endast HTTP- eller HTTPs-protokoll stöds i webbadressen.

XML-användarnamn

Standard: tomt

XML-tjänstens användarnamn för autentiseringsbehov.

Du kan även konfigurera den här parametern i telefonens konfigurationsfil (cfg.xml) genom att ange en sträng i det här formatet:

<XML_User_Name ua="na">användarnamn</XML_User_Name>

XML-lösenord

Standard: tomt

XML-tjänstens lösenord för det angivna XML-användarnamnet.

Lösenordet du angav i det här fältet visas i konfigurationsfilen (cfg.xml) enligt följande:

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

Aktivera CISCO XML-EXE

Standard: Nej

Alternativ: Ja, Nej

Anger om autentisering krävs för åtkomst till XML-programservern.

Du kan även konfigurera den här parametern i telefonens konfigurationsfil (cfg.xml) genom att ange en sträng i det här formatet:

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

CISCO XML-EXE-autentiseringsläge

Standard: Lokal behörighet

Alternativ: Betrodd, Lokal autentiseringsuppgift, Fjärrautentiseringsuppgifter

Anger autentiseringsläget för Cisco XML EXE.

  • Betrodd – Ingen autentisering utförs oavsett vilken lokal behörighet du har.

  • Lokal behörighet – Autentisering baseras på autentisering för sammanfattning med lokal behörighet om inställt. Om lokal behörighet inte är angett utförs ingen autentisering.

  • Fjärrbehörighet – Autentiseringen är baserad på autentisering för sammanfattning med fjärrautentiseringsuppgifter enligt inställningen i XML-programmet på webbsidan (för åtkomst till XML-programserver).

Du kan även konfigurera den här parametern i telefonens konfigurationsfil (cfg.xml) genom att ange en sträng i det här formatet:

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

Lägga till ett XML program i en programstyrd knapp

Lägg till de ofta använda applikationerna i programstyrda knappar så att användarna enkelt kan komma åt tjänsten.

Innan du börjar

Tjänsten XML Application har konfigurerats korrekt.

1

Öppna webbsidan för telefonadministration.

2

Välj Röst > Telefon.

3

Gå till Programmerbara funktionsknappar och ange Programmable Softkey Enable som Ja.

Du kan även konfigurera parametern i konfigurationsfilen (cfg.xml). Ange en sträng i detta format:

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

I avsnittet Programmerbara programstyrda knappar redigerar du de tillgängliga fälten för PSK1 till PSK16 i det här formatet:

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

där URL är länken där XML-applikationen lagras; NME är programmets visningsnamn på telefonskärmen.

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

Du kan även konfigurera parametern i konfigurationsfilen (cfg.xml). Ange en sträng i detta format:

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

där n är numret för den programstyrda knappen.

5

Klicka på Spara alla ändringar.

Lägga till ett XML program i en linjenyckel

Lägg till de ofta använda applikationerna i linjetangenter så att användarna enkelt kan komma åt tjänsterna.

Innan du börjar

Tjänsten XML Application har konfigurerats korrekt.

1

Öppna webbsidan för telefonadministration.

2

Välj Röst > Telefon.

3

Välj en linjeknapp.

4

Ställ in parametern Anslutning som Inaktiverat för att inaktivera anslutningen.

Om funktionen för konfiguration av direkt PLK är inaktiverad måste du inaktivera anslutningen för att lägga till en utökad funktion för linjeknappen. Om funktionen är aktiverad kan du hoppa över det här steget. Mer information finns i Aktivera direkt PLK-konfiguration.
5

Gå till parametern Utökad funktion och ange en sträng i det här formatet:

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

där URL är länken där XML-applikationen lagras; NME är programmets visningsnamn på telefonskärmen.

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

Du kan även konfigurera parametern i konfigurationsfilen (cfg.xml). Ange en sträng i detta format:

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

Där n är anknytningsnumret.

6

Klicka på Spara alla ändringar.

Makrovariabler som stöds i XML URL:er

Du kan använda makrovariabler i XML-URL:er. Följande makrovariabler stöds:

  • Användar-ID – UID1, UID2 till UIDn

  • Visningsnamn – DISPLAYNAME1, DISPLAYNAME2 till DISPLAYNAMEn

  • Autentisering-ID – AUTHID1, AUTHID2 till AUTHIDn

  • Proxy – PROXY1, PROXY2 till PROXYn

  • MAC-adress med gemena hexadecimala tecken – MA

  • Produktnamn – PN

  • Produktserienummer – PSN

  • Serienummer – SERIAL_NUMBER

Tabell 2. Makron som stöds
MakronamnMakroexpandering
$Formen $$ expanderas till ett enda $-tecken.
A till och med PErsätts med de generella parametrarna GPP_A till och med GPP_P.
SA till och med SDErsätts med specialparametrarna GPP_SA till och med GPP_SD. Dessa parametrar innehåller knappar eller lösenord som används i etableringen.
$SA till och med $SD känns igen som argument för den valfria URL-kvalificeraren för omsynkronisering, --knapp.
MAMAC-adress med gemena hexadecimala tecken (000e08aabbcc).
MAUMAC-adress med versala hexadecimala tecken (000E08AABBCC).
MACMAC-adress med gemena hexadecimala tecken med kolonavgränsade hexadecimala sifferpar (00:0e:08:aa:bb:cc).
PNProduktnamn; till exempel Videotelefon 8875, Skrivbordstelefon 9851.
PSNProduktserienummer; Till exempel 8875, 9841, 9861
SNSerienummersträng, till exempel 88012BA01234.
CCERTSSL-klientcertifikatstatus, installerat eller inte installerat.
IPIP-adress för telefonen inom dess lokala subnät, till exempel 192.168.1.100.
EXTIPExternt IP för SPA-telefonen så som det visas på internet, till exempel 66.43.16.52.

SWVER

Programvaruversionssträng. Till exempel,

PHONEOS.3-2-1-0104-37

HWVER

Maskinvaruversionssträng. Till exempel 2.0.1

PRVST

Etableringsstatus (en numerisk sträng):

-1 = explicit omsynkroniseringsbegäran

0 = omsynkronisering vid start

1 = periodisk omsynkronisering

2 = omsynkronisering misslyckades, nytt försök

UPGST

Uppgraderingsstatus (en numerisk sträng):

1 = första uppgraderingsförsöket

2 = uppgradering misslyckades, nytt försök

UPGERR

Resultatmeddelande (ERR) för föregående uppgraderingsförsök, till exempel http_get misslyckades.

PRVTMR

Sekunder sedan senaste omsynkroniseringsförsök.

UPGTMR

Sekunder sedan senaste uppgraderingsförsök.

REGTMR1

Sekunder sedan linje 1 förlorade registrering hos SIP-servern.

REGTMR2

Sekunder sedan linje 2 förlorade registrering hos SIP-servern.

UPGCOND

Äldre makronamn.

SCHEME

Filåtkomstschemat (TFTP, HTTP eller HTTPS), så som det erhålls efter parsning av omsynkroniserings- eller uppgraderings-URL:en.

SERV

Begäran om målserverns värdnamn, så som det erhålls efter parsning av omsynkroniserings- eller uppgraderings-URL:en.

SERVIP

Begäran om målserverns IP-adress, så som den erhålls efter parsning av omsynkroniserings- eller uppgraderings-URL:en, möjligen efter en DNS-sökning.

PORT

Begäran om UDP-/TCP-målporten, så som den erhålls efter parsning av omsynkroniserings- eller uppgraderings-URL:en.

PATH

Begäran om målfilens sökväg, så som den erhålls efter parsning av omsynkroniserings- eller uppgraderings-URL:en.

ERR

Resultatmeddelande för omsynkroniserings- eller uppgraderingsförsök. Endast användbart vid generering av syslog-resultatmeddelanden. Värdet sparas i variabeln UPGERR vid uppgraderingsförsök.

UIDn

Innehållet i konfigurationsparametern Line n UserID.

ISCUST

Om enheten är anpassad är värdet = 1, annars 0.

Anpassningsstatus kan visas på informationssidan för webbgränssnittet.

INCOMINGNAMENamnet som associeras med det första kopplade, ringande eller inkommande samtalet.
REMOTENUMBER

Telefonnummer från det första kopplade, ringande eller inkommande samtalet. Om det finns flera samtal anges data som har associerats med det första identifierade samtalet.

DISPLAYNAMEnInnehållet i konfigurationsparametern Line N Display Name.
AUTHIDnInnehållet i konfigurationsparametern Line N auth ID.