- Start
- /
- Artikel
Konfiguration av XML-program för telefoner på BroadWorks
Den här hjälpartikeln gäller för Cisco Desk Phone 9800-serien och Cisco Video Phone 8875 som är registrerade i Cisco BroadWorks. Läs den här artikeln för XML-objekt, URI:er och stegen för att konfigurera XSI-tjänster på telefonens webbsida.
Ö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
. 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 . |
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 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.
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:
|
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:
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-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:
|
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-autentiseringsläge |
Standard: Lokal behörighet Alternativ: Betrodd, lokal behörighet, fjärrbehörighet |
Anger autentiseringsläget för Cisco XML EXE.
Du kan även konfigurera den här parametern i telefonens konfigurationsfil (cfg.xml) genom att ange en sträng i det här formatet:
|
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 . |
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:
|
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
Du kan även konfigurera den här parametern i konfigurationsfilen (cfg.xml). Ange en sträng i det här formatet:
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 . |
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
Du kan även konfigurera den här parametern i konfigurationsfilen (cfg.xml). Ange en sträng i det här formatet:
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
Makronamn | Makroexpandering |
---|---|
$ | Formuläret $$ expanderas till ett enda $-tecken. |
A till och med P | Ersätts av de allmänna parametrarna GPP_A till och med GPP_P. |
SA till SD | Ersä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. |
Sverige | MAC-adress med gemena hexadecimala tecken (000e08aabbcc). |
MAU | MAC-adress med versala hexadecimala tecken (000E08AABBCC). |
mac-dator | MAC-adress med gemena hexadecimala tecken med kolon för att separera hexadecimala sifferpar (00:0e:08:aa:bb:cc). |
Påfågel | Produktnamn, till exempel videotelefon 8875, skrivbordstelefon 9851. |
psn (kommun, CH-GR) | Produktserienummer, till exempel 8875, 9841, 9861 |
sn. | Serienummersträng, till exempel 88012BA01234. |
ccert | Status för SSL-klientcertifikat, installerat eller inte installerat. |
IP | IP-adress för telefonen i dess lokala subnät, till exempel 192.168.1.100. |
extip-kod | Extern 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. |
insatsnamn | Namn 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. |
VISNINGSNAMN | Innehållet i konfigurationsparametern Line N Display Name. |
AUTHIDn | Innehållet i konfigurationsparametern för Line N auth-ID. |