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

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

Tabuľka č. 1 Parametre pre služby XML

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:

<XML_Application_Service_Name ua="na">Názov aplikácie XML</XML_Application_Service_Name>

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:

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

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_User_Name ua="na">používateľské meno</XML_User_Name>

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:

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

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:

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

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.

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

  • Lokálne poverenie – overenie je založené na overení súhrnu pomocou miestnych poverení, ak sú nastavené. Ak nie je nastavené lokálne poverenie, nevykoná sa žiadna autentifikácia.

  • Vzdialené poverenie – autentifikácia je založená na overení pomocou súhrnu pomocou vzdialeného poverenia nastaveného v aplikácii XML na webovej stránke (na prístup k aplikačnému serveru 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">Miestne poverenia</CISCO_XML_EXE_Auth_Mode>

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

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:

<Programmable_Softkey_Enable ua="na">Áno</Programmable_Softkey_Enable>
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 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 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 Hlas > Telefón.

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 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_>

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

Tabuľka 2 Podporované makrá
Názov makraRozšírenie makra
$Formulár $$ sa rozšíri na jeden znak $.
A až PNahradené všeobecnými parametrami GPP_A až GPP_P.
SA cez SDNahradené 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.
MAAdresa MAC s použitím malých hexadecimálnych číslic (000e08aabbcc).
MAUAdresa MAC s použitím veľkých hexadecimálnych číslic (000E08AABBCC).
MACMAC adresa používa malé hexadecimálne číslice s dvojbodkou na oddelenie hexadecimálnych párov (00:0e:08:aa:bb:cc).
PNNázov produktu; napríklad videotelefón 8875, stolný telefón 9851.
PSNČíslo série produktu; napríklad 8875, 9841, 9861
SNReťazec sériového čísla; napríklad 88012BA01234.
CCERTStav klientskeho certifikátu SSL, nainštalovaný alebo nenainštalovaný.
IPIP adresa telefónu v rámci jeho lokálnej podsiete; 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.

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ÁZOVMeno 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.

DISPLAYNAMEnObsah konfiguračného parametra riadka N Display Name.
AUTHIDnObsah konfiguračného parametra Line N auth ID.