V tomto článku
dropdown icon
Prehľad
    Podporované objekty XML
    Podporované URI
Konfigurácia telefónu na pripojenie k službe XML
Parametre pre služby XML
Pridanie aplikácie XML do softkey
Pridanie aplikácie XML do riadkového kľúča
Makro premenné podporované v URL XML

Konfigurácia aplikácií XML pre telefóny 9800 a 8875 (BroadWorks)

list-menuV tomto článku
list-menuSpätná väzba?

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 Nastavenia > Sieť a služba > Služby Cisco XML. 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ž ky Hlas > Telefón.

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 las > Telef ó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.

Tabuľka 1. Parametre pre služby XML

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:

<XML_Application_Service_Name
ua="na">XML APP Name</XML_Application_Service_Name>

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:

<XML_Application_Service_URL
ua="na">https://server.com/path/app.xml</XML_Application_Service_URL>

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_User_Name ua="na">username</XML_User_Name>

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:

<!--
<XML_Password ua="na">*************</XML_Password>
-->

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:

<CISCO_XML_EXE_Enable ua="na">Yes</CISCO_XML_EXE_Enable>

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.

  • Dôveryhodné — bez ohľadu na miestne poverenie sa nevykonáva žiadna autentifikácia.

  • Lokálne poverenie — autentifikácia je založená na súhrnnej autentifikácii pomocou lokálneho poverenia, ak je nastavené. Ak nie je nastavené miestne poverenie, nevykoná sa žiadna autentifikácia.

  • Remote Credential — Autentifikácia je založená na súhrnnej autentifikácii pomocou vzdialeného poverenia, ako je nastavená v aplikácii XML na webovej stránke (na prístup k serveru aplikácií 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:

<CISCO_XML_EXE_Auth_Mode ua="na">Local Credential</CISCO_XML_EXE_Auth_Mode>

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ž ky Hlas > Telefón.

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:

<Programmable_Softkey_Enable ua="na">Yes</Programmable_Softkey_Enable>
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 url je odkaz, kde je uložená aplikácia XML; nme je zobrazený názov aplikácie na obrazovke telefónu.

Príklad fnc=xml; url= http://10.77.21.37/xmlapp/menu.xml;nme=Menu

Tento parameter môžete nakonfigurovať aj v konfiguračnom súbore (cfg.xml). Zadajte reťazec v tomto formáte:

<PSK_n ua="na">fnc=xml; url= http://10.77.21.37/xmlapp/menu.xml;nme=Menu</PSK_n> <configuration code>

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ž ky Hlas > Telefón.

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 url je odkaz, kde je uložená aplikácia XML; nme je zobrazený názov aplikácie na obrazovke telefónu.

Príklad fnc=xml; url= http://10.77.21.37/xmlapp/menu.xml;nme=Menu

Tento parameter môžete nakonfigurovať aj v konfiguračnom súbore (cfg.xml). Zadajte reťazec v tomto formáte:

<Extended_Function_n_ ua="na">fnc=xml; url= http://10.77.21.37/xmlapp/menu.xml;nme=Menu</Extended_Function_n_> <configuration code>

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

Tabuľka 2. Podporované makrá
Názov makraRozšírenie makra
$Forma $$ sa rozširuje na jeden znak $.
A až PNahradené všeobecnými parametrami GPP_A cez GPP_P.
SA cez SDNahradené š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.

MAMAC adresa pomocou malých šesťhranných číslic (000e08aabbcc).
MAUMAC adresa pomocou veľkých šesťhranných číslic (000E08AABBCC).
MACMAC 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).
PNNázov produktu; napríklad Video Phone 8875, Stolný telefón 9851.
PSNČíslo série produktov; napríklad 8875, 9841, 9861
SNReťazec sériového čísla; napríklad 88012BA01234.
CCERTStav certifikátu klienta SSL, nainštalovaný alebo nenainštalovaný.
IPIP adresa telefónu v jeho lokálnej podsieti; napríklad 192.168.1.100.
EXTIPExterná 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.

INCOMINGNAMENá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ázvyObsah konfiguračného parametra Line N Display Name.
AuthidNObsah konfiguračného parametra Line N auth ID.
Bol tento článok užitočný?
Bol tento článok užitočný?