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 ponuky Nastavenia > Sieť a služby >služby XML spoločnosti 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 Voice> Phone (Hlastelefón ).

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 karte Hlas > telefón 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.

Tabuľka 1. Parametre pre XML služby

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_Application_Service_Name ua="na">XML Názov aplikácie</XML_Application_Service_Name>

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:

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

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:

<XML_User_Name ua="na">meno používateľa</XML_User_Name>

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:

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

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:

<CISCO_XML_EXE_Enable ua="na">Áno</CISCO_XML_EXE_Enable>

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.

  • Dôveryhodné – bez ohľadu na lokálne poverenia sa nevykoná žiadne overenie.

  • Lokálne poverenia – overenie je založené na súhrnnom overení pomocou lokálneho poverenia, ak je nastavené. Ak lokálne poverenie nie je nastavené, nevykoná sa žiadne overenie.

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

<CISCO_XML_EXE_Auth_Mode ua="na">Miestne poverenie</CISCO_XML_EXE_Auth_Mode>

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 Voice> Phone (Hlastelefón ).

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:

<Programmable_Softkey_Enable ua="na">Áno</Programmable_Softkey_Enable>
4

V sekcii Programovateľné kontextové tlačidlá upravte dostupné polia PSK1PSK16 v tomto formáte:

fnc=xml;url=<xml_app_path>; nme = <app_name>

kde url je odkaz, kde je XML aplikácia uložená; NME je zobrazovaný 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<konfiguračný kód></PSK_n>

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 Voice> Phone (Hlastelefón ).

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 url je odkaz, kde je XML aplikácia uložená; NME je zobrazovaný 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<konfiguračný kód></Extended_Function_n_>

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

Tabuľka 2. Podporované makrá
Názov makraRozvoj makier
$Formulár $$ sa rozbalí na jeden znak $.
A až PNahradené univerzálnymi parametrami GPP_A až GPP_P.
SA až SDNahradené 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.
MAMAC adresu pomocou malých hexadecimálnych číslic (000E08AABCC).
MAUMAC adresu pomocou hexadecimálnych veľkých číslic (000E08AABBCC).
MACMAC adresu pomocou malých hexadecimálnych číslic s dvojbodkou na oddelenie hexadecimálnych číslic (00:0e:08:aa:bb:cc).
PNNázov produktu; napríklad Videotelefón 8875, stolový telefón 9851.
PSNčíslo série výrobkov; Napríklad 8875, 9841, 9861
SNReťazec sériového čísla; napríklad 88012BA01234.
CCERTSSL Stav certifikátu klienta, nainštalovaný alebo nenainštalovaný.
IPIP adresu 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 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 MENOMeno 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ÁZOVnObsah konfiguračného parametra Zobrazovaný názov linky N.
AUTHIDnObsah konfiguračného parametra auth ID linky N.