- Start
- /
- Artikel
XML för telefoner på BroadWorks
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 de XML objekt, URI:er som stöds och stegen för att konfigurera XSI-tjänsterna på telefonens webbsida.
Ö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
. 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 . |
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 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.
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:
|
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:
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-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:
|
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 autentiseringsuppgift, Fjärrautentiseringsuppgifter |
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ä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 . |
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:
|
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
Exempel Du kan även konfigurera parametern i konfigurationsfilen (cfg.xml). Ange en sträng i detta format:
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 . |
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
Exempel Du kan även konfigurera parametern i konfigurationsfilen (cfg.xml). Ange en sträng i detta format:
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
Makronamn | Makroexpandering |
---|---|
$ | Formen $$ expanderas till ett enda $-tecken. |
A till och med P | Ersätts med de generella parametrarna GPP_A till och med GPP_P. |
SA till och med SD | Ersä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. |
MA | MAC-adress med gemena hexadecimala tecken (000e08aabbcc). |
MAU | MAC-adress med versala hexadecimala tecken (000E08AABBCC). |
MAC | MAC-adress med gemena hexadecimala tecken med kolonavgränsade hexadecimala sifferpar (00:0e:08:aa:bb:cc). |
PN | Produktnamn; till exempel Videotelefon 8875, Skrivbordstelefon 9851. |
PSN | Produktserienummer; Till exempel 8875, 9841, 9861 |
SN | Serienummersträng, till exempel 88012BA01234. |
CCERT | SSL-klientcertifikatstatus, installerat eller inte installerat. |
IP | IP-adress för telefonen inom dess lokala subnät, till exempel 192.168.1.100. |
EXTIP | Externt 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. |
INCOMINGNAME | Namnet 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. |
DISPLAYNAMEn | Innehållet i konfigurationsparametern Line N Display Name. |
AUTHIDn | Innehållet i konfigurationsparametern Line N auth ID. |