I den här artikeln
dropdown icon
Översikt
    XML-objekt som stöds
    URI:er som stöds
Konfigurera en telefon för att ansluta till en XML-tjänst
Parametrar för XML-tjänster
Lägga till ett XML-program i en funktionstangent
Lägga till ett XML-program i en radnyckel
Makrovariabler som stöds i XML-URL:er

Konfiguration av XML-program för 9800- och 8875-telefoner (BroadWorks)

list-menuI den här artikeln
list-menuHar du feedback?

Den här hjälpartikeln gäller Cisco Desk Phone 9800-serien och Cisco Video Phone 8875 som är registrerade på Cisco BroadWorks. Läs den här artikeln för XML-objekt som stöds, URI:er och stegen för att konfigurera XSI-tjänsterna på telefonens webbsida.

Översikt

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

Efter att ha prenumererat telefonen på tjänsterna kan användare komma åt alla konfigurerade tjänster på telefonen genom att navigera till Inställningar > N ätverk och tjänst > Cisco XML- tjänster. Cisco XML-tjänster är standardnamnet. Du kan också ändra namnet. För att ge användarna enkel åtkomst kan du lägga till XML-program till funktionstangenter eller linjetangenter.

De funktioner som stöds är:

  • Meddelanden (bilder och text)
  • Personsökning

XML-objekt som stöds

  • CiscoIpPhoneMenu

  • CiscoIPPhoneText

  • CiscoIPPhone-ingång

  • CiscoIPPhone-katalog

  • CiscoIPPhoneBild

  • CiscoIPPhoneImageFil

  • CiscoIPPhoneIconMeny

  • CiscoIPPhoneIconFileMenu

  • CiscoIPPhoneStatus (utom 9811 och 9841)

  • CiscoIPPhoneStatusFile (utom 9811 och 9841)

  • CiscoIPPhoneExecute

URI:er som stöds

  • Enhet

  • Urtavla

  • Redigera Dail

  • Init

  • Nyckel

  • Spela upp (endast ringsignaler)

  • Funktionsknapp

Mer information om XSI-tjänstkonfigurationen finns i Cisco Unified IP Phone Services Application Development Notes.

Konfigurera en telefon för att ansluta till en XML-tjänst

1

Gå till 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 som definieras 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 Enable och CISCO XML EXE Auth Mode.

5

Klicka på Spara alla ändringar.

Parametrar för XML-tjänster

Följande tabell definierar funktionen och användningen av XML-programparametrarna i avsnittet XML-tjänst under fliken Rö st > Telefon i telefonens webbgränssnitt. Den definierar också syntaxen för strängen som läggs till i telefonkonfigurationsfilen (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-applikationstjänst

Standard: Tom

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

Du kan också konfigurera den här parametern i XML-filen för telefonkonfiguration (cfg.xml) genom att ange en sträng i detta format:

<XML_Application_Service_Name
ua="na">XML APP Name</XML_Application_Service_Name>

URL för XML-applikationstjänst

Standard: Tom

Webbadressen där XML-programmet finns.

Du kan också konfigurera den här parametern i XML-filen för telefonkonfiguration (cfg.xml) genom att ange en sträng i detta format:

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

Makrovariabler stöds i XML-webbadresser. För giltiga makrovariabler, se Mak rovariabler som stöds i XML-URL:er.

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

XML-användarnamn

Standard: Tom

XML-tjänstens användarnamn för autentiseringsändamål.

Du kan också konfigurera den här parametern i XML-filen för telefonkonfiguration (cfg.xml) genom att ange en sträng i detta format:

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

XML-lösenord

Standard: Tom

Lösenord för XML-tjänsten för det angivna XML-användarnamnet.

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

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

CISCO XML EXE Aktivera

Standard: Nej

Alternativ: Ja, Nej

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

Du kan också konfigurera den här parametern i XML-filen för telefonkonfiguration (cfg.xml) genom att ange en sträng i detta format:

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

CISCO XML EXE Auth Mode

Standard: Lokal autentisering

Alternativ: Betrodd, Lokal autentisering, Fjärrautentisering

Anger autentiseringsläget för Cisco XML EXE.

  • Pålitlig — Ingen autentisering utförs oavsett lokal referens.

  • Lokal autentisering — Autentisering baseras på sammanfattningsautentiseringen med hjälp av den lokala referensen, om den är inställd. Om den lokala referensen inte är inställd utförs ingen autentisering.

  • Fjärrautentisering — Autentisering baseras på sammanfattningsautentiseringen med hjälp av den fjärrautentisering som anges i XML-programmet på webbsidan (för att komma åt en XML-programserver).

Du kan också konfigurera den här parametern i XML-filen för telefonkonfiguration (cfg.xml) genom att ange en sträng i detta format:

<CISCO_XML_EXE_Auth_Mode ua="na">Local Credential</CISCO_XML_EXE_Auth_Mode>

Lägga till ett XML-program i en funktionstangent

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

Innan du börjar

XML Application Service har konfigurerats korrekt.

1

Gå till webbsidan för telefonadministration.

2

Välj Röst > Telefon.

3

I avsnittet Programmerbara funktionstangenter ställer du in Programmerbar funktionstangent Aktivera till Ja.

Du kan också konfigurera den här parametern i konfigurationsfilen (cfg.xml). Ange en sträng i detta format:

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

I avsnittet Programmerbara programknappar redigerar du de tillgängliga fälten i PSK1 till PSK 16 i följande format:

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 också konfigurera den här 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</PSK_n> <configuration code>

där n är funktionstangenten.

5

Klicka på Spara alla ändringar.

Lägga till ett XML-program i en radnyckel

Lägg till de ofta använda applikationerna till radnycklar så att användare enkelt kan komma åt tjänsterna.

Innan du börjar

XML Application Service har konfigurerats korrekt.

1

Gå till webbsidan för telefonadministration.

2

Välj Röst > Telefon.

3

Välj en radnyckel.

4

Ställ in parametern Extension till In aktiverad för att inaktivera tillägget.

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

Ange en sträng i detta format i parametern Extended Func tion:

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 också konfigurera den här 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</Extended_Function_n_> <configuration code>

där n är tilläggsnumret.

6

Klicka på Spara alla ändringar.

Makrovariabler som stöds i XML-URL:er

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

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

  • Visningsnamn — DisplayName1, DISPLAYNAME2 till DisplayNamen

  • Auth ID — AUTHID1, AUTHID2 till AuthIDN

  • Proxy—Proxy1, PROXY2 till ProxyN

  • MAC-adress med små hexsiffror — MA

  • Produktnamn — PN

  • Produktserienummer — PSN

  • Serienummer — Serienummer

Tabell 2. Makron som stöds
MakronamnMakroexpansion
$Formuläret $$ expanderar till ett enda $ tecken.
A till och med PErsätts av allmänna parametrar GPP_A till GPP_P.
SA genom SDErsätts av specialparametrar GPP_SA genom GPP_SD. Dessa parametrar innehåller nycklar eller lösenord som används vid etablering.

$SA till $SD identifieras som argument för den valfria resync-URL- kvalificeraren, --key.

MAMAC-adress med små hexsiffror (000e08aabbcc).
MAUMAC-adress med stora hexsiffror (000E08AABBCC).
MACMAC-adress med små hexsiffror med kolon för att separera hexsifferpar (00:0 e:08:aa:bb:cc).
PNProduktnamn; till exempel videotelefon 8875, skrivbordstelefon 9851.
PSNProduktserienummer; till exempel 8875, 9841, 9861
SNSerienummersträng; till exempel 88012BA01234.
CCERTStatus för SSL-klientcertifikat, installerat eller ej installerat.
IPTelefonens IP-adress inom dess lokala delnät; till exempel 192.168.1.100.
EXTIPExtern IP för telefonen, som ses på internet; till exempel 66.43.16.52.

SWVER

Programversionsträng. Till exempel

PHONEOS.3-2-1-0104-37

HWVER

Hårdvaruversionsträng. Till exempel 2.0.1

PRVST

Tilldelningstillstånd (en numerisk sträng):

-1 = uttrycklig återsynkroniseringsbegäran

0 = återsynkronisering av uppstart

1 = periodisk återsynkronisering

2 = omsynkronisering misslyckades, försök igen

UPGST

Uppgraderingstillstånd (en numerisk sträng):

1 = första uppgraderingsförsöket

2 = uppgraderingen misslyckades, försök igen

UPGERR

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

PRVTMR

Sekunder sedan senaste återsynkroniseringsförsök.

UPGTMR

Sekunder sedan senaste uppgraderingsförsöket.

REGTMR1

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

REGTMR2

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

UPGCOND

Äldre makronamn.

SCHEME

Filåtkomstschema, ett av TFTP, HTTP eller HTTPS, som erhållits efter att ha analyserat resync eller uppgraderings-URL.

SERV

Begär värdnamn för målservern, som erhållits efter att ha analyserat resync- eller uppgraderings-URL.

SERVIP

Begär målserverns IP-adress, som erhållits efter att ha analyserat resync- eller uppgraderings-URL, eventuellt efter DNS-sökning.

PORT

Begär mål-UDP/TCP-port, som erhållits efter att ha analyserat resync- eller uppgraderings-URL.

PATH

Begär sökväg för målfilen, som erhållits efter att ha analyserat resync eller uppgraderings-URL.

ERR

Resultatmeddelande om återsynkronisering eller uppgraderingsförsök. Endast användbart för att generera resultatsyslog-meddelanden. Värdet bevaras i variabeln UPGERR vid uppgraderingsförsök.

UIDn

Innehållet i konfigurationsparametern Line n UserID.

ISCUST

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

Anpassningsstatus visas på sidan Web UI Info.

INCOMINGNAMENamn kopplat till det första anslutna, ringande eller inkommande samtalet.
REMOTENUMBER

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

DisplayNamnInnehållet i konfigurationsparametern Line N Visningsnamn.
AuthenticIDNInnehållet i konfigurationsparametern Line N auth ID.
Var den här artikeln användbar?
Var den här artikeln användbar?