- Domov
- /
- Článok
XML pre telefóny na BroadWorks
Tento článok Pomocníka sa vzťahuje na telefóny Cisco Desk Phone 9800 Series a Cisco Video Phone 8875, ktoré sú registrované v spoločnosti 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 XML objektov a URI.
Po predplatení telefónu do služieb môžu používatelia získať prístup ku všetkým nakonfigurovaným službám v telefóne tak, že prejdú do
Cisco. Služby Cisco XML Services je predvolený názov. Môžete tiež zmeniť názov. Ak chcete používateľom poskytnúť jednoduchý prístup, môžete XML aplikácie pridať k kontextovým tlačidlám alebo klávesom linky.Podporované funkcie sú:
- Správy (obrázky a text)
- Odosielanie stránok
Podporované objekty XML
-
CiscoIPPhoneMenu
-
CiscoIPPhoneText
-
CiscoIPPhoneInput
-
Adresár CiscoIPPhoneDirectory
-
CiscoIPPhoneImage
-
CiscoIPPhoneImageFile
-
CiscoIPPhoneIconMenu
-
CiscoIPPhoneIconFileMenu
-
CiscoIPPhoneStatus (okrem 9841)
-
CiscoIPPhoneStatusFile (okrem 9841)
-
CiscoIPPhoneExecute
Podporované identifikátory URI
-
Zariadenie
-
Číselník
-
EditDail
-
Init
-
Kľúč
-
Prehrať (iba vyzváňacie tóny)
-
Tlačidlo
Ďalšie podrobnosti o konfigurácii služby XSI nájdete v téme Cisco Unified IP Phone Poznámky k vývoju aplikácií služieb.
Konfigurácia telefónu na pripojenie k službe XML
1 |
Prejdite na webovú stránku správy telefónu. |
2 |
Vyberte položku ). |
3 |
V časti XML Service (Služba ) nakonfigurujte XML Názov aplikačnej služby a XML parametre URL aplikačnej služby definované v časti Parametre pre XML služby. |
4 |
(Voliteľné) Ak chcete pridať autentifikáciu pre prístup k aplikačnej službe, nakonfigurujte tieto polia:XML Meno používateľa,XML Heslo,CISCO XML EXE Enable aCISCO XML EXE Auth Mode . |
5 |
Kliknite na položku Uložiť všetky zmeny. |
Parametre pre XML služby
Nasledujúca tabuľka definuje funkciu a používanie parametrov aplikácie XML v časti XML Služba na vo webovom rozhraní telefónu. Definuje tiež syntax reťazca, ktorý sa pridá do konfiguračného súboru telefónu (cfg.xml) s XML kódom na konfiguráciu parametra.
Parameter |
Predvolené a možnosti |
Popis |
---|---|---|
XML Názov aplikačnej služby |
Predvolené: prázdne |
Názov XML aplikácie. Názov sa zobrazí v telefóne ako voľba webovej aplikácie. Tento parameter môžete nakonfigurovať aj v súbore konfigurácie telefónu XML (cfg.xml) zadaním reťazca v tomto formáte:
|
XML adresa URL aplikačnej služby |
Predvolené: prázdne |
Adresa URL, na ktorej sa nachádza aplikácia XML. Tento parameter môžete nakonfigurovať aj v súbore konfigurácie telefónu XML (cfg.xml) zadaním reťazca v tomto formáte:
Makropremenné sú podporované vo XML URL adresách. Informácie o platných makropremenných nájdete v téme Makrá premenné podporované v XML URL adresách. V adrese URL sú podporované iba protokoly HTTP alebo HTTP. |
Meno používateľa siete XML |
Predvolené: prázdne |
XML meno používateľa služby na účely overenia. Tento parameter môžete nakonfigurovať aj v súbore konfigurácie telefónu XML (cfg.xml) zadaním reťazca v tomto formáte:
|
Heslo XML |
Predvolené: prázdne |
XML heslo služby pre zadanú XML meno používateľa. Heslo, ktoré ste zadali do tohto poľa, sa v konfiguračnom súbore (cfg.xml) zobrazuje takto:
|
CISCO XML EXE povoliť |
Predvolené: Nie Možnosti: Áno, Nie |
Určuje, či sa na prístup k aplikačnému serveru XML vyžaduje overenie. Tento parameter môžete nakonfigurovať aj v súbore konfigurácie telefónu XML (cfg.xml) zadaním reťazca v tomto formáte:
|
Režim overenia CISCO XML EXE |
Predvolené: Lokálne poverenia Možnosti: Dôveryhodné, Lokálne poverenie, Vzdialené poverenie |
Určuje režim overovania pre Cisco XML EXE.
Tento parameter môžete nakonfigurovať aj v súbore konfigurácie telefónu XML (cfg.xml) zadaním reťazca v tomto formáte:
|
Pridanie aplikácie XML k kontextovému tlačidlu
Pridajte často používané aplikácie k softvérovým tlačidlám, aby používatelia mali ľahký prístup k službe.
Skôr než 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 časti Programovateľné tlačidlá nastavte položku Programovateľné tlačidlo povoliť na hodnotu Á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é kontextové tlačidlá upravte dostupné polia PSK1 až PSK16 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 kontextového kľúča. |
5 |
Kliknite na položku Uložiť všetky zmeny. |
Pridanie aplikácie XML do kľúča linky
Pridajte často používané aplikácie na linkové klávesy, aby používatelia mali ľahký prístup k službám.
Skôr než 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 kláves linky. |
4 |
Ak chcete rozšírenie vypnúť, nastavte parameter Extension na hodnotu Disabled (Zakázané). Ak je funkcia priamej konfigurácie PLK zakázaná, musíte rozšírenie vypnúť, aby ste do klávesu linky mohli pridať rozšírenú funkciu. Ak je táto funkcia povolená, môžete tento krok preskočiť. Podrobnosti nájdete v časti Povolenie priamej konfigurácie PLK. |
5 |
Do parametra Rozšírená funkcia 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:
Pričom n označuje číslo linky. |
6 |
Kliknite na položku Uložiť všetky zmeny. |
Makrá premenné podporované v XML URL adresách
V XML adresách URL môžete použiť makropremenné. Podporované sú nasledujúce makropremenné:
-
ID používateľa – UID1, UID2 až UIDn
-
Zobrazovaný názov – DISPLAYNAME1, DISPLAYNAME2 na DISPLAYNAMEn
-
ID overenia — AUTHID1, AUTHID2 na AUTHIDn
-
Server proxy – PROXY1, PROXY2 až PROXYn
-
MAC Adresa používajúca malé hexadecimálne číslice – MA
-
Názov produktu – PN
-
Číslo produktovej rady – PSN
-
Sériové číslo—SERIAL_NUMBER
Názov makra | Rozvoj makier |
---|---|
$ | Formulár $$ sa rozbalí na jeden znak $. |
A až P | Nahradené univerzálnymi parametrami GPP_A až GPP_P. |
SA až SD | Nahradené obsahom parametrov pre špeciálne účely GPP_SA až GPP_SD. Tieto parametre obsahujú kľúče alebo heslá používané počas poskytovania. $SA až $SD sa považujú za argumenty voliteľného kvalifikátora URL opätovnej synchronizácie – kľúča. |
MA | MAC adresu pomocou malých hexadecimálnych číslic (000E08AABCC). |
MAU | MAC adresu pomocou hexadecimálnych veľkých číslic (000E08AABBCC). |
MAC | MAC adresu pomocou malých hexadecimálnych číslic s dvojbodkou na oddelenie hexadecimálnych číslic (00:0e:08:aa:bb:cc). |
PN | Názov produktu; napríklad Videotelefón 8875, stolový telefón 9851. |
PSN | číslo série výrobkov; Napríklad 8875, 9841, 9861 |
SN | Reťazec sériového čísla; napríklad 88012BA01234. |
CCERT | SSL Stav certifikátu klienta, nainštalovaný alebo nenainštalovaný. |
IP | IP adresu 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 verzie hardvéru. Napríklad 2.0.1. |
PRVST |
Stav poskytovania (číselný reťazec): -1 = explicitná žiadosť o opätovnú synchronizáciu 0 = opätovná synchronizácia pri spustení 1 = pravidelná opätovná synchronizácia 2 = opätovná synchronizácia zlyhala, skúsiť znova |
UPGST |
Stav aktualizácie (číselný reťazec): 1 = prvý pokus o aktualizáciu 2 = aktualizácia zlyhala, skúsiť znova |
UPGERR |
Výsledná správa (ERR) posledného pokusu o aktualizáciu, napríklad http_get zlyhalo. |
PRVTMR |
Počet sekúnd od posledného pokusu o opätovnú synchronizáciu. |
UPGTMR |
Počet sekúnd od posledného pokusu o aktualizáciu. |
REGTMR1 |
Počet sekúnd, odkedy Linka 1 stratila registráciu na serveri SIP. |
REGTMR2 |
Počet sekúnd, odkedy Linka 2 stratila registráciu na serveri SIP. |
UPGCOND |
Pôvodný názov makra. |
SCHEME |
Schéma prístupu k súboru (TFTP, HTTP alebo HTTPS), ktorá bola získaná pri analýze opätovnej synchronizácie alebo URL aktualizácie. |
SERV |
Názov hostiteľa servera, ktorý bol cieľom požiadavky, získaný pri analýze opätovnej synchronizácie alebo URL aktualizácie. |
SERVIP |
Názov adresy IP servera, ktorá bola cieľom požiadavky, získaný pri analýze opätovnej synchronizácie alebo URL aktualizácie, prípadne po vyhľadávaní DNS |
PORT |
Názov portu UDP/TCP, ktorý bol cieľom požiadavky, získaný pri analýze opätovnej synchronizácie alebo URL aktualizácie. |
PATH |
Názov cesty súboru, ktorý bol cieľom požiadavky, získaný pri analýze opätovnej synchronizácie alebo URL aktualizácie. |
ERR |
Výsledná správa o opätovnej synchronizácii alebo pokuse o aktualizáciu. Užitočná len pre generovaní výsledných správ systémového denníka. Hodnota je uložená v premennej UPGERR pre prípad pokusov o aktualizáciu. |
UIDn |
Obsah parametra konfigurácie ID používateľa Linky n. |
ISCUST |
Ak je jednotka prispôsobená, hodnota=1, inak 0. Stav prispôsobenia je možné zobraziť na stránke Informácie o webovom používateľskom rozhraní. |
PRICHÁDZAJÚCE MENO | Meno priradené k prvému spojenému, zvoniacemu alebo prichádzajúcemu hovoru. |
VZDIALENÉ ČÍSLO |
Telefónne číslo prvého spojeného, zvoniaceho alebo prichádzajúceho hovoru. V prípade viacerých hovorov sa poskytnú údaje priradené k prvému nájdenému hovoru. |
ZOBRAZOVANÝ NÁZOVn | Obsah konfiguračného parametra Zobrazovaný názov linky N. |
AUTHIDn | Obsah konfiguračného parametra auth ID linky N. |