- Domov
- /
- Článok
Konfigurácia XML aplikácií pre telefóny na BroadWorks
Tento článok pomocníka sa vzťahuje na Cisco Desk Phone 9800 Series a Cisco Video Phone 8875, ktoré sú registrované v Cisco BroadWorks. V tomto článku nájdete podporované objekty XML, identifikátory 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ť svoje vlastné služby XSI pomocou podporovaných objektov XML a URI.
Po prihlásení telefónu na odber služieb môžu používatelia pristupovať ku všetkým nakonfigurovaným službám v telefóne tak, že prejdú do časti
. Služby Cisco XML sú predvoleným názvom. Môžete tiež zmeniť názov. Aby ste používateľom poskytli jednoduchý prístup, môžete pridať aplikácie XML k softvérovým tlačidlám alebo tlačidlám linky.Podporované funkcie sú:
- Správy (obrázky a text)
- Stránkovanie
Podporované XML objekty
-
Ponuka CiscoIPPhone
-
CiscoIPPhoneText
-
Vstup CiscoIPPhone
-
CiscoIPPhone Directory
-
CiscoIPPhoneImage
-
CiscoIPPhoneImageFile
-
Ponuka ikon CiscoIPPhone
-
Ponuka CiscoIPPhoneIconFile
-
CiscoIPPhoneStatus (okrem 9841)
-
CiscoIPPhoneStatusFile (okrem 9841)
-
CiscoIPPhoneExecute
Podporované identifikátory URI
-
Zariadenie
-
Vytáčať
-
EditDail
-
Init
-
kľúč
-
Prehrať (iba vyzváňacie tóny)
-
Softkey
Ďalšie podrobnosti o konfigurácii služby XSI nájdete v časti Poznámky k vývoju aplikácií služieb Cisco Unified IP Phone.
Nakonfigurujte telefón na pripojenie k službe XML
1 |
Prejdite na webovú stránku správy telefónu. |
2 |
Vyberte položku . |
3 |
V sekcii Služba XML nakonfigurujte parametre Názov aplikačnej služby XML a Adresa URL aplikačnej služby XML podľa definície 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: Používateľské meno XML, Heslo XML, Povoliť CISCO XML EXE a Režim autorizácie CISCO XML EXE. |
5 |
Kliknite na tlačidlo 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 vo webovom rozhraní telefónu. Definuje tiež syntax reťazca, ktorý sa pridáva do konfiguračného súboru telefónu (cfg.xml) s kódom XML na konfiguráciu parametra.
Parameter |
Predvolené a možnosti |
Opis |
---|---|---|
Názov aplikačnej služby XML |
Predvolená hodnota: Prázdny |
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 aplikačnej služby XML |
Predvolená hodnota: Prázdny |
Adresa URL, na ktorej 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:
Premenné makier sú podporované v URL XML. Platné premenné makra nájdete v časti Premenné makra podporované v adresách URL XML. V adrese URL sú podporované iba protokoly HTTP alebo HTTPs. |
Používateľské meno XML |
Predvolená hodnota: Prázdny |
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á hodnota: Prázdny |
Heslo služby XML pre zadané používateľské meno XML. Heslo, ktoré ste zadali do tohto poľa, sa v konfiguračnom súbore (cfg.xml) zobrazí takto:
|
CISCO XML EXE Povoliť |
Predvolená hodnota: Nie Možnosti: Áno, Nie |
Určuje, či sa na prístup k aplikačnému serveru XML vyžaduje 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á hodnota: Miestne poverenie Možnosti: Trusted, Local Credential, Remote Credential |
Určuje režim overenia 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:
|
Pridajte aplikáciu XML k softvérovému tlačidlu
Pridajte často používané aplikácie k softvérovým tlačidlám, aby používatelia mali jednoduchý prístup k službe.
Skôr ako začnete
Služba XML Application Service bola správne nakonfigurovaná.
1 |
Prejdite na webovú stránku správy telefónu. |
2 |
Vyberte položku . |
3 |
V sekcii Programovateľné funkčné klávesy nastavte možnosť Povoliť programovateľné funkčné klávesy 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é funkčné klávesy upravte dostupné polia PSK1 až PSK16 v tomto formáte: fnc=xml;url=<xml_app_path>;nme=<app_name>
kde url je odkaz, kde je uložená aplikácia XML; nme je zobrazovaný názov aplikácie na obrazovke telefónu.
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 softvérového tlačidla. |
5 |
Kliknite na tlačidlo Uložiť všetky zmeny. |
Pridajte aplikáciu XML do kľúča riadku
Pridajte často používané aplikácie do tlačidiel linky, aby používatelia mali jednoduchý prístup k službám.
Skôr ako začnete
Služba XML Application Service bola správne nakonfigurovaná.
1 |
Prejdite na webovú stránku správy telefónu. |
2 |
Vyberte položku . |
3 |
Vyberte tlačidlo linky. |
4 |
Ak chcete rozšírenie zakázať, nastavte parameter Rozšírenie na hodnotu Zakázané. Ak je funkcia priamej konfigurácie PLK zakázaná, musíte vypnúť rozšírenie, aby ste pridali rozšírenú funkciu na tlačidlo linky. Ak je funkcia povolená, môžete tento krok preskočiť. Podrobnosti nájdete v časti Povolenie konfigurácie Direct PLK. |
5 |
Do parametra Rozšírená funkcia zadajte reťazec v tomto formáte: fnc=xml;url=<xml_app_path>;nme=<app_name>
kde url je odkaz, kde je uložená aplikácia XML; nme je zobrazovaný názov aplikácie na obrazovke telefónu.
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 tlačidlo Uložiť všetky zmeny. |
Makro premenné podporované v URL XML
V URL XML môžete použiť premenné makier. Podporované sú nasledujúce premenné makier:
-
ID používateľa — UID1, UID2 až UIDn
-
Zobrazovaný názov — DISPLAYNAME1, DISPLAYNAME2 až DISPLAYNAMEn
-
Auth ID—AUTHID1, AUTHID2 až AUTHIDn
-
Proxy—PROXY1, PROXY2 až PROXYn
-
Adresa MAC s použitím malých hexadecimálnych číslic – MA
-
Názov produktu – PN
-
Číslo série produktu – PSN
-
Sériové číslo – SERIAL_NUMBER
Názov makra | Rozšírenie makra |
---|---|
$ | Formulár $$ sa rozšíri na jeden znak $. |
A až P | Nahradené všeobecnými parametrami GPP_A až GPP_P. |
SA cez SD | Nahradené parametrami špeciálneho účelu GPP_SA až GPP_SD. Tieto parametre obsahujú kľúče alebo heslá používané pri poskytovaní. $SA až $SD sú rozpoznané ako argumenty pre voliteľný kvalifikátor opätovnej synchronizácie URL, --key. |
MA | Adresa MAC s použitím malých hexadecimálnych číslic (000e08aabbcc). |
MAU | Adresa MAC s použitím veľkých hexadecimálnych číslic (000E08AABBCC). |
MAC | MAC adresa používa malé hexadecimálne číslice s dvojbodkou na oddelenie hexadecimálnych párov (00:0e:08:aa:bb:cc). |
PN | Názov produktu; napríklad videotelefón 8875, stolný telefón 9851. |
PSN | Číslo série produktu; napríklad 8875, 9841, 9861 |
SN | Reťazec sériového čísla; napríklad 88012BA01234. |
CCERT | Stav klientskeho certifikátu SSL, nainštalovaný alebo nenainštalovaný. |
IP | IP adresa telefónu v rámci jeho lokálnej podsiete; 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. PHONEOS.3-2-1-0104-37 |
HWVER |
Reťazec verzie hardvéru. Napríklad 2.0.1 |
PRVST |
Stav poskytovania (číselný reťazec): -1 = explicitná požiadavka na opätovnú synchronizáciu 0 = opätovná synchronizácia pri zapnutí 1 = periodická opätovná synchronizácia 2 = opätovná synchronizácia zlyhala, skúste to znova |
UPGST |
Stav inovácie (číselný reťazec): 1 = prvý pokus o aktualizáciu 2 = aktualizácia zlyhala, skúste to znova |
UPGERR |
Správa o výsledku (ERR) predchádzajúceho pokusu o aktualizáciu; napríklad http_get zlyhal. |
PRVTMR |
Sekundy od posledného pokusu o opätovnú synchronizáciu. |
UPTGMR |
Sekundy od posledného pokusu o inováciu. |
REGTMR1 |
Sekundy odvtedy, čo linka 1 stratila registráciu na serveri SIP. |
REGTMR2 |
Sekundy odvtedy, čo linka 2 stratila registráciu na serveri SIP. |
UPGCOND |
Názov staršieho makra. |
SCHÉMA |
Schéma prístupu k súboru, jedna z TFTP, HTTP alebo HTTPS, získaná po analýze opätovnej synchronizácie alebo inovácii URL. |
SERV |
Požiadajte o názov hostiteľa cieľového servera, ktorý ste získali po analýze webovej adresy na opätovnú synchronizáciu alebo inováciu. |
SERVIS |
Požiadajte o adresu IP cieľového servera, ktorá sa získa po analýze adresy URL opätovnej synchronizácie alebo inovácie, prípadne po vyhľadaní DNS. |
PORT |
Požiadajte o cieľový port UDP/TCP, ktorý ste získali po analýze opätovnej synchronizácie alebo inovácie webovej adresy. |
PATH |
Požiadajte o cestu k cieľovému súboru, ktorá sa získa po analýze webovej adresy na opätovnú synchronizáciu alebo inováciu. |
ERR |
Správa o výsledku pokusu o opätovnú synchronizáciu alebo aktualizáciu. Užitočné len pri generovaní výsledkových správ syslog. Hodnota sa zachová 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á, hodnota = 1, inak 0. Stav prispôsobenia je možné zobraziť na informačnej stránke webového používateľského rozhrania. |
PRICHÁDZAJÚCE NÁZOV | Meno spojené s prvým pripojeným, zvoniacim alebo prichádzajúcim hovorom. |
REMOTENUMBER |
Telefónne číslo prvého pripojeného, zvoniaceho alebo prichádzajúceho hovoru. Ak existuje viacero hovorov, poskytnú sa údaje súvisiace s prvým nájdeným hovorom. |
DISPLAYNAMEn | Obsah konfiguračného parametra riadka N Display Name. |
AUTHIDn | Obsah konfiguračného parametra Line N auth ID. |