- Domov
- /
- Článok
Ďakujeme za vašu spätnú väzbu.
XML pre telefóny 9800 a 8875 (BroadWorks)
V tomto článku
Spätná väzba?Tento článok Pomocníka sa vzťahuje na Cisco stolový telefón radu 9800 a Cisco videotelefón 8875, ktoré sú zaregistrované v službe 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 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ú na Cisco XML. Cisco XML služby je predvolený názov. Môžete tiež zmeniť názov. Ak chcete používateľom poskytnúť jednoduchý prístup, môžete aplikácie XML pridať k kontextovým tlačidlám alebo linkovým klávesom.
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 9811 a 9841)
-
CiscoIPPhoneStatusFile (okrem 9811 a 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 časti 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 nakonfigurujte parametre XML Application Service Name a XML Application Service URL 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 Povoliť EXE a Cisco XML Režim overenia EXE. |
| 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 časti XML Služba v časti Tab vo webovom rozhraní telefónu. Definuje tiež syntax reťazca, ktorý sa pridá do konfiguračného súboru telefónu (cfg.xml) s kódom XML na konfiguráciu parametra.
|
Parameter |
Predvolené a možnosti |
Popis |
|---|---|---|
|
XML Názov aplikačnej služby |
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 tiež nakonfigurovať 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 tiež nakonfigurovať v súbore konfigurácie telefónu XML (cfg.XML) zadaním reťazca v tomto formáte: Makropremenné sú podporované v adresách URL XML. Informácie o platných makropremenných nájdete v časti Makrá podporované v adresách URL XML. V adrese URL sú podporované iba protokoly HTTP alebo HTTP. |
|
Meno používateľa siete XML |
Predvolené: prázdne |
XML používateľské meno služby na účely overenia. Tento parameter môžete tiež nakonfigurovať 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é meno používateľa XML. 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 tiež nakonfigurovať v súbore konfigurácie telefónu XML (cfg.XML) zadaním reťazca v tomto formáte: |
|
Cisco XML Režim overenia 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 tiež nakonfigurovať 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. |
Makro premenné podporované v XML URL adresách
V adresách URL XML 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 | Makro rozšírenie |
|---|---|
| $ | Formulár $$ sa rozbalí na jeden znak $. |
| A až P | Nahradené univerzálnymi parametrami GPP_A až GPP_P. |
| SA až 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 voliteľného kvalifikátora URL adresy na opätovnú synchronizáciu, --key. |
| MA | MAC adresa používajúca malé hexadecimálne číslice (000E08aabbcc). |
| MAU | MAC adresa s použitím veľkých hexadecimálnych číslic (000E08AABBCC). |
| MAC | MAC adresa používajúca malé hexadecimálne číslice 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. |
| TIP | 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 |
Provisioning State (číselný reťazec): -1 = explicitná požiadavka na opakovanú synchronizáciu 0 = resynchronizácia zapnutia 1 = pravidelná opakovaná synchronizácia 2 = opakovaná synchronizácia zlyhala, pokus o zopakovanie |
|
UPGST |
Stav inovácie (číselný reťazec): 1 = prvý pokus o aktualizáciu 2 = inovácia zlyhala, pokus o zopakovanie |
|
UPGERR |
Správa o výsledku (ERR) predchádzajúceho pokusu o inováciu; Napríklad http_get zlyhal. |
|
PRVTMR |
Sekúnd od posledného pokusu o opätovnú synchronizáciu. |
|
UPGTMR |
Sekúnd od posledného pokusu o aktualizáciu. |
|
REGTMR1 |
Pár sekúnd po tom, čo linka 1 stratila registráciu na serveri SIP. |
|
REGTMR2 |
Pár sekúnd od toho, čo linka 2 stratila registráciu na serveri SIP. |
|
UPGCOND |
Názov staršieho makra. |
|
SCHÉMA |
Schéma prístupu k súborom, jedna z TFTP, HTTP alebo HTTPS, získaná po analýze, opätovnej synchronizácii alebo inovácii URL adresy. |
|
SERV |
Požiadajte o názov hostiteľa cieľového servera, ktorý získate po analýze, opätovnej synchronizácii alebo inovácii adresy URL. |
|
SERVIP |
Požiadajte cieľový server IP adresu získanú po analýze, opätovnej synchronizácii alebo inovácii adresy URL, prípadne po vyhľadávaní DNS. |
|
PRÍSTAV |
Port cieľa požiadavky UDP/TCP získaný po analýze, opätovnej synchronizácii alebo inovácii adresy URL. |
|
CESTIČKA |
Vyžiadajte si cestu k cieľovému súboru získanú po analýze, opätovnej synchronizácii alebo inovácii adresy URL. |
|
ERR |
Výsledné hlásenie o opätovnej synchronizácii alebo pokuse o inováciu. Užitočné iba pri generovaní správ syslog výsledkov. 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 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. |
