- Domov
- /
- Článok
Konfigurácia aplikácií XML pre telefóny 9800 a 8875 (BroadWorks)
Tento článok pomocníka sa vzťahuje na Cisco Desk Phone 9800 Series a Cisco Video Phone 8875, ktoré sú zaregistrované v Cisco BroadWorks. Prečítajte si tento článok pre podporované objekty XML, URI a kroky na konfiguráciu služieb XSI na webovej stránke telefónu.
Prehľad
XML Services Interface (XSI) je protokol, ktorý umožňuje komunikáciu medzi aplikáciami a telefónnym systémom. Do telefónu môžete pridať vlastné služby XSI pomocou podporovaných objektov XML a URI.
Po predplatení telefónu na služby môžu používatelia pristupovať ku všetkým nakonfigurovaným službám v telefóne prejdením na položky . Služby Cisco XML sú predvoleným názvom. Môžete tiež zmeniť názov. Ak chcete používateľom poskytnúť jednoduchý prístup, môžete pridať aplikácie XML do softklávesov alebo riadkových klávesov.
Podporované funkcie sú:
- Správy (obrázky a text)
- Stránkovanie
Podporované objekty XML
-
CiscoipPhoneMenu
-
CiscoipphoneText
-
CiscoipPhoneInput
-
CISCOIPPhoneDirectory
-
CiscoipphoneObrázok
-
CiscoipphoneImageFile
-
CiscoipPhoneIconMenu
-
CiscoipPhoneIconMenu súboru
-
CiscoipPhoneStatus (okrem 9811 a 9841)
-
CISCOIPPhonEstatusFile (okrem 9811 a 9841)
-
CiscoipPhoneVykonať
Podporované URI
-
Zariadenie
-
Vytočte
-
UpraviťDail
-
Init
-
Kľúč
-
Prehrávanie (iba vyzváňacie tóny)
-
Softkey
Ďalšie informácie o konfigurácii služby XSI nájdete v časti Poznámky k vývoju aplikácií Cisco Unified IP Phone Services.
Konfigurácia telefónu na pripojenie k službe XML
| 1 |
Vstúpte na webovú stránku správy telefónu. |
| 2 |
Vyberte polož . |
| 3 |
V časti Služba XML nakonfigurujte parametre XML Application Service Name a XML Application Service URL parametre definované v časti Parametre pre služby XML. |
| 4 |
(Voliteľné) Ak chcete pridať autentifikáciu pre prístup k aplikačnej službe, nakonfigurujte tieto polia: XML User Name, XML Password, CISCO XML EXE En able a CISCO XML EXE Auth Mo de. |
| 5 |
Kliknite na polož ku Uložiť všetky zmeny. |
Parametre pre služby XML
Nasledujúca tabuľka definuje funkciu a použitie parametrov aplikácie XML v sekcii Služba XML na karte H ón vo webovom rozhraní telefónu. Definuje tiež syntax reťazca, ktorý je pridaný do konfiguračného súboru telefónu (cfg.xml) s kódom XML na konfiguráciu parametra.
|
Parameter |
Predvolené a možnosti |
Popis |
|---|---|---|
|
Názov služby aplikácie XML |
Predvolené: Prázdne |
Názov aplikácie XML. Názov sa zobrazí v telefóne ako voľba webovej aplikácie. Tento parameter môžete nakonfigurovať aj v súbore XML konfigurácie telefónu (cfg.xml) zadaním reťazca v tomto formáte:
|
|
URL služby aplikácie XML |
Predvolené: Prázdne |
URL, kde sa nachádza aplikácia XML. Tento parameter môžete nakonfigurovať aj v súbore XML konfigurácie telefónu (cfg.xml) zadaním reťazca v tomto formáte:
Makro premenné sú podporované v URL XML. Platné makro premenné nájdete v téme Premenné makra podporované v URL XML. V adrese URL sú podporované iba protokoly HTTP alebo HTTPS. |
|
XML meno používateľa |
Predvolené: Prázdne |
Používateľské meno služby XML na účely autentifikácie. Tento parameter môžete nakonfigurovať aj v súbore XML konfigurácie telefónu (cfg.xml) zadaním reťazca v tomto formáte:
|
|
XML heslo |
Predvolené: Prázdne |
Heslo služby XML pre zadané meno používateľa XML. Heslo, ktoré ste zadali do tohto poľa, sa v konfiguračnom súbore (cfg.xml) zobrazuje nasledovne:
|
|
CISCO XML EXE Povoliť |
Predvolené: Nie Možnosti: Áno, Nie |
Určuje, či je na prístup k aplikačnému serveru XML potrebná autentifikácia. Tento parameter môžete nakonfigurovať aj v súbore XML konfigurácie telefónu (cfg.xml) zadaním reťazca v tomto formáte:
|
|
Režim autorizácie CISCO XML EXE |
Predvolené: Miestne poverenie Možnosti: Dôveryhodné, Lokálne poverenie, Vzdialené poverenie |
Určuje režim autentifikácie pre Cisco XML EXE.
Tento parameter môžete nakonfigurovať aj v súbore XML konfigurácie telefónu (cfg.xml) zadaním reťazca v tomto formáte:
|
Pridanie aplikácie XML do softkey
Pridajte často používané aplikácie do softklávesov, aby používatelia mohli ľahko pristupovať k službe.
Skôr ako začnete
Aplikačná služba XML bola správne nakonfigurovaná.
| 1 |
Vstúpte na webovú stránku správy telefónu. |
| 2 |
Vyberte polož . |
| 3 |
V sekcii Programovateľné softklá vesy nastavte možnosť Programmable Softkey Enable na Áno. Tento parameter môžete nakonfigurovať aj v konfiguračnom súbore (cfg.xml). Zadajte reťazec v tomto formáte:
|
| 4 |
V sekcii Programovateľné softklá vesy upravte dostupné polia PSK1 až PSK 16 v tomto formáte: fnc=xml;url=<xml_app_path>;nme=<app_name>
kde
Príklad
Tento parameter môžete nakonfigurovať aj v konfiguračnom súbore (cfg.xml). Zadajte reťazec v tomto formáte:
kde n je číslo softkey. |
| 5 |
Kliknite na polož ku Uložiť všetky zmeny. |
Pridanie aplikácie XML do riadkového kľúča
Pridajte často používané aplikácie do riadkových klávesov, aby používatelia mohli ľahko pristupovať k službám.
Skôr ako začnete
Aplikačná služba XML bola správne nakonfigurovaná.
| 1 |
Vstúpte na webovú stránku správy telefónu. |
| 2 |
Vyberte polož . |
| 3 |
Vyberte riadkový kľúč. |
| 4 |
Ak chcete rozší renie zakázať, nastavte parameter Roz šírenie na možnosť Zakázané. Ak je funkcia Direct PLK Configuration zakázaná, musíte rozšírenie zakázať, aby ste k riadkovému klávesu pridali rozšírenú funkciu. Ak je funkcia povolená, môžete tento krok preskočiť. Podrobnosti nájdete v téme Povoli ť priamu konfiguráciu PLK. |
| 5 |
V parametri Extended Fun ction zadajte reťazec v tomto formáte: fnc=xml;url=<xml_app_path>;nme=<app_name>
kde
Príklad
Tento parameter môžete nakonfigurovať aj v konfiguračnom súbore (cfg.xml). Zadajte reťazec v tomto formáte:
kde n je číslo rozšírenia. |
| 6 |
Kliknite na polož ku Uložiť všetky zmeny. |
Makro premenné podporované v URL XML
Premenné makra môžete použiť v URL XML. Podporované sú nasledujúce makro premenné:
-
ID používateľa — UID1, UID2 až UiDn
-
DisplayName—DisplayName1, DISPLAYNAME2 až DisplayNamen
-
Identifikačné číslo — AUTHID1, AUTHID2 do AuthIDN
-
Proxy — Proxy1, PROXY2 do ProxyN
-
MAC adresa pomocou malých šesťhranných číslic — MA
-
Názov výrobku—PN
-
Číslo série produktov — PSN
-
Sériové číslo — sériové číslo
| Názov makra | Rozšírenie makra |
|---|---|
| $ | Forma $$ sa rozširuje na jeden znak $. |
| A až P | Nahradené všeobecnými parametrami GPP_A cez GPP_P. |
| SA cez SD | Nahradené špeciálnymi účelovými parametrami GPP_SA cez GPP_SD. Tieto parametre obsahujú
kľúče alebo heslá používané pri poskytovaní. $SA až $SD sú rozpoznané ako argumenty k voliteľnému kvalifikátoru resync URL --key. |
| MA | MAC adresa pomocou malých šesťhranných číslic (000e08aabbcc). |
| MAU | MAC adresa pomocou veľkých šesťhranných číslic (000E08AABBCC). |
| MAC | MAC adresa pomocou malých šesťhranných číslic s dvojbodkou na oddelenie párov šesťhranných číslic (00:0 e:08:aa:bb:cc). |
| PN | Názov produktu; napríklad Video Phone 8875, Stolný telefón 9851. |
| PSN | Číslo série produktov; napríklad 8875, 9841, 9861 |
| SN | Reťazec sériového čísla; napríklad 88012BA01234. |
| CCERT | Stav certifikátu klienta SSL, nainštalovaný alebo nenainštalovaný. |
| IP | IP adresa telefónu v jeho lokálnej podsieti; napríklad 192.168.1.100. |
| EXTIP | Externá IP telefónu, ako je vidieť na internete; napríklad 66.43.16.52. |
|
SWVER |
Reťazec verzie softvéru. Napríklad PHONEOS.3-2-1-0104-37 |
|
HWVER |
Reťazec hardvérovej verzie. Napríklad 2.0.1 |
|
PRVST |
Stav poskytovania (číselný reťazec): -1 = explicitná požiadavka na resynchronizáciu 0 = opätovná synchronizácia zapnutia 1 = periodická resynchronizácia 2 = opätovná synchronizácia zlyhala, opätovný pokus |
|
UPGST |
Stav aktualizácie (číselný reťazec): 1 = prvý pokus o aktualizáciu 2 = aktualizácia zlyhala, opätovný pokus |
|
UPGERR |
Výsledok správy (ERR) predchádzajúceho pokusu o aktualizáciu; napríklad http_get zlyhal. |
|
PRVTMR |
Sekundy od posledného pokusu o opätovnú synchronizáciu. |
|
UPGTMR |
Sekúnd od posledného pokusu o aktualizáciu. |
|
REGTMR1 |
Sekúnd odkedy riadok 1 stratil registráciu na SIP serveri. |
|
REGTMR2 |
Sekúnd odkedy Line 2 stratil registráciu na SIP serveri. |
|
UPGCOND |
Starší názov makra. |
|
SCHEME |
Schéma prístupu k súborom, jedna z TFTP, HTTP alebo HTTPS, získaná po analýze opätovnej synchronizácie alebo aktualizácie URL. |
|
SERV |
Vyžiadajte si názov hostiteľa cieľového servera získaný po analýze opätovnej synchronizácie alebo aktualizácie URL. |
|
SERVIP |
Vyžiadajte si IP adresu cieľového servera získanú po analýze opätovnej synchronizácie alebo aktualizácie URL, prípadne po vyhľadaní DNS. |
|
PORT |
Vyžiadajte cieľový port UDP/TCP získaný po analýze opätovnej synchronizácie alebo aktualizácie URL. |
|
PATH |
Požiadajte o cestu cieľového súboru získanú po analýze opätovnej synchronizácie alebo aktualizácie URL. |
|
ERR |
Výsledná správa o opätovnej synchronizácii alebo pokuse o inováciu. Užitočné iba pri generovaní výsledkových syslog správ. Hodnota sa zachováva v premennej UPGERR v prípade pokusov o aktualizáciu. |
|
UIDn |
Obsah konfiguračného parametra Line n userId. |
| ISCUST |
Ak je jednotka prispôsobená, hodnoť:1, inak 0. Stav prispôsobenia je možné vidieť na stránke Info o používateľskom rozhraní webu. |
| INCOMINGNAME | Názov priradený k prvému pripojenému, zvoneniu alebo prichádzajúcemu hovoru. |
| REMOTENUMBER |
Telefónne číslo prvého pripojeného, zvoneného alebo prichádzajúceho hovoru. Ak existuje viacero hovorov, poskytnú sa údaje spojené s prvým nájdeným hovorom. |
| DisplejaNázvy | Obsah konfiguračného parametra Line N Display Name. |
| AuthidN | Obsah konfiguračného parametra Line N auth ID. |