- Start
- /
- Artikel
Konfiguration av XML-program för 9800- och 8875-telefoner (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 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 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 . |
| 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 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.
|
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:
|
|
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:
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-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:
|
|
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 Auth Mode |
Standard: Lokal autentisering Alternativ: Betrodd, Lokal autentisering, Fjärrautentisering |
Anger autentiseringsläget för Cisco XML EXE.
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:
|
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 . |
| 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:
|
| 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
Exempel
Du kan också konfigurera den här parametern i konfigurationsfilen (cfg.xml). Ange en sträng i detta format:
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 . |
| 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
Exempel
Du kan också konfigurera den här parametern i konfigurationsfilen (cfg.xml). Ange en sträng i detta format:
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
| Makronamn | Makroexpansion |
|---|---|
| $ | Formuläret $$ expanderar till ett enda $ tecken. |
| A till och med P | Ersätts av allmänna parametrar GPP_A till GPP_P. |
| SA genom SD | Ersä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. |
| MA | MAC-adress med små hexsiffror (000e08aabbcc). |
| MAU | MAC-adress med stora hexsiffror (000E08AABBCC). |
| MAC | MAC-adress med små hexsiffror med kolon för att separera hexsifferpar (00:0 e: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 | Status för SSL-klientcertifikat, installerat eller ej installerat. |
| IP | Telefonens IP-adress inom dess lokala delnät; till exempel 192.168.1.100. |
| EXTIP | Extern 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. |
| INCOMINGNAME | Namn 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. |
| DisplayNamn | Innehållet i konfigurationsparametern Line N Visningsnamn. |
| AuthenticIDN | Innehållet i konfigurationsparametern Line N auth ID. |