Översikt

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

När du har prenumererat på telefonen på tjänsterna kan användare 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 även ändra namnet. För att ge användarna enkel åtkomst kan du lägga till XML-program på programstyrda knappar eller linjeknappar.

De funktioner som stöds är:

  • Meddelanden (bilder och text)
  • Personsökning

XML-objekt som stöds

  • Cisco IP-telefonmeny

  • CiscoIPhoneText

  • Cisco IPPhoneInput

  • CiscoIPhoneDirectory

  • CiscoIP-telefonbild

  • Cisco IP- bildfil

  • Cisco IP-telefonIconMenu

  • CiscoIPhoneIconFileMenu

  • CiscoIPhoneStatus (utom 9841)

  • CiscoIPPhoneStatusFile (utom 9841)

  • Cisco IP-telefonKör

URI:er som stöds

  • Enhet

  • Ring

  • RedigeraDail

  • Inledning

  • Nyckel

  • Spela upp (endast ringsignaler)

  • Programstyrd knapp

Mer information om konfigurationen av XSI-tjänsten finns i Information om programutveckling för Cisco Unified IP-telefontjänster.

Konfigurera en telefon för att ansluta 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 för XML-programtjänstens namn och XML-programtjänstens 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 följande fält: XML-användarnamn, XML-lösenord, CISCO XML EXE-aktivering och CISCO XML EXE-autentiseringsläge.

5

Klicka på Spara alla ändringar.

Parametrar för XML-tjänster

Följande tabell definierar hur parametrarna för XML-programmet i avsnittet XML-tjänst på fliken Röst > Telefon i telefonens webbgränssnitt fungerar och används. Den definierar även syntaxen 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änst

Standard: Tom

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-appens namn</XML_Application_Service_Name>

URL för XML-programtjänst

Standard: Tom

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. För giltiga makrovariabler, se Makrovariabler som stöds i XML-URL:er.

Endast HTTP- eller HTTPs-protokoll stöds i URL:en.

XML-användarnamn

Standard: Tom

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

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: Tom

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

Lösenordet som du angav i det här fältet visas i konfigurationsfilen (cfg.xml) som 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 behörighet, fjärrbehörighet

Anger autentiseringsläget för Cisco XML EXE.

  • Betrodd – ingen autentisering utförs oavsett lokala autentiseringsuppgifter.

  • Lokal autentisering – autentisering baseras på sammanfattningsautentisering med lokal autentisering, om detta är inställt. Om den lokala autentiseringsuppgiften inte har ställts in utförs ingen autentisering.

  • Fjärråtkomst – Autentiseringen baseras på sammanfattningsautentiseringen med fjärråtkomst som anges i XML-programmet på webbsidan (för att komma åt en 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 behörighet</CISCO_XML_EXE_Auth_Mode>

Lägg till ett XML-program i en programstyrd knapp

Lägg till de program som ofta används på programstyrda knappar så att användare enkelt kan komma åt tjänsten.

Innan du börjar

XML-programtjänsten har konfigurerats korrekt.

1

Öppna webbsidan för telefonadministration.

2

Välj Röst > Telefon.

3

I avsnittet Programmerbara funktionsknappar ställer du in Aktivera programmerbara funktionsknappar som Ja.

Du kan även konfigurera den här parametern i konfigurationsfilen (cfg.xml). Ange en sträng i det här formatet:

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

I avsnittet Programmerbara funktionsknappar redigerar du de tillgängliga fälten från PSK1 till PSK16 i detta format:

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

där url är länken där XML-programmet lagras. nme är programmets visningsnamn på telefonskärmen.

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

Du kan även konfigurera den här parametern i konfigurationsfilen (cfg.xml). Ange en sträng i det här formatet:

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

där n är numret för programstyrda knappar.

5

Klicka på Spara alla ändringar.

Lägg till ett XML-program i en linjeknapp

Lägg till de ofta använda programmen på linjeknapparna så att användare enkelt kan komma åt tjänsterna.

Innan du börjar

XML-programtjänsten 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 Anknytning på Inaktiverad för att inaktivera anknytningen.

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

I parametern Utökad funktion anger du 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-programmet lagras. nme är programmets visningsnamn på telefonskärmen.

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

Du kan även konfigurera den här parametern i konfigurationsfilen (cfg.xml). Ange en sträng i det här formatet:

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

  • Autentiserings-ID – AUTHID1, AUTHID2 till AUTHIDn

  • Proxy – PROXY1, PROXY2 till PROXYn

  • MAC-adress med gemena hexadecimala tecken – MA

  • Produktnamn – PN

  • Produktserienummer – PSN

  • Serienummer – SERIENUMMER

Tabell 2. Makron som stöds
MakronamnMakroexpandering
$Formuläret $$ expanderas till ett enda $-tecken.
A till och med PErsätts av de allmänna parametrarna GPP_A till och med GPP_P.
SA till SDErsätts av specialparametrarna GPP_SA till och med GPP_SD. Dessa parametrar innehåller nycklar eller lösenord som används vid reserveringen.
$SA till och med $SD känns igen som argument för den valfria URL-kvalificeraren för omsynkronisering, --nyckel.
SverigeMAC-adress med gemena hexadecimala tecken (000e08aabbcc).
MAUMAC-adress med versala hexadecimala tecken (000E08AABBCC).
mac-datorMAC-adress med gemena hexadecimala tecken med kolon för att separera hexadecimala sifferpar (00:0e:08:aa:bb:cc).
PåfågelProduktnamn, till exempel videotelefon 8875, skrivbordstelefon 9851.
psn (kommun, CH-GR)Produktserienummer, till exempel 8875, 9841, 9861
sn.Serienummersträng, till exempel 88012BA01234.
ccertStatus för SSL-klientcertifikat, installerat eller inte installerat.
IPIP-adress för telefonen i dess lokala subnät, till exempel 192.168.1.100.
extip-kodExtern IP för telefonen, som den visas på internet, till exempel 66.43.16.52.

swver

Sträng för programvaruversion. Exempel:

telefon.3-2-1-0104-37

hwver-liknande

Sträng för maskinvaruversion. Till exempel 2.0.1

Nybyggnation

Etableringsstatus (en numerisk sträng):

-1 = uttrycklig omsynkroniseringsbegäran

0 = omsynkronisering vid start

1 = periodisk omsynkronisering

2 = omsynkronisering misslyckades, nytt försök

topp

Uppgraderingsstatus (en numerisk sträng):

1 = första uppgraderingsförsöket

2 = uppgradering misslyckades, nytt försök

uppgerr

Resultatmeddelande (ERR) från tidigare uppgraderingsförsök, till exempel http_get misslyckades.

Kategori: Personer med funktionsnedsättning

Sekunder sedan senaste omsynkroniseringsförsök.

uppgtmr

Sekunder sedan senaste uppgraderingsförsöket.

regtmr1

Sekunder sedan linje 1 förlorade registreringen med SIP-servern.

regtmr2

Sekunder sedan linje 2 förlorade registreringen med SIP-servern.

uppgcond

Äldre makronamn.

schema

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

serv

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

servip

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

port

Begär målport för UDP/TCP, så som den erhålls efter parsning av omsynkroniserings- eller uppgraderings-URL:en.

sökväg

Begär målfilsökvägen, så som den erhålls efter parsning av omsynkroniserings- eller uppgraderings-URL:en.

fel

Resultatmeddelande för omsynkroniserings- eller uppgraderingsförsök. Endast användbart vid generering av resultatsyslog-meddelanden. Värdet bevaras i UPGERR-variabeln vid uppgraderingsförsök.

UID:n

Innehållet i konfigurationsparametern Line n UserID.

iscust

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

Anpassningsstatus kan visas på sidan Web UI Info.

insatsnamnNamn som associeras med det första anslutna, ringande eller inkommande samtalet.
fjärrnummer

Telefonnummer till det första anslutna, ringande eller inkommande samtalet. Om det finns flera samtal tillhandahålls data som är associerade med det första samtalet.

VISNINGSNAMNInnehållet i konfigurationsparametern Line N Display Name.
AUTHIDnInnehållet i konfigurationsparametern för Line N auth-ID.