Áttekintés

XML Services Interface (XSI) egy olyan protokoll, amely lehetővé teszi az alkalmazások és a telefonrendszer közötti kommunikációt. Saját XSI-szolgáltatásokat is hozzáadhat telefonjához a támogatott XML objektumok és URI-k használatával.

Miután feliratkoztak a telefonra a szolgáltatásokra, a felhasználók a telefon összes konfigurált szolgáltatását elérhetik a Beállítások > Hálózat és szolgáltatás > Cisco XML szolgáltatások menüpontban. A Cisco XML szolgáltatások az alapértelmezett név. A nevet is módosíthatja. Annak érdekében, hogy a felhasználók könnyen hozzáférhessenek, hozzáadhatja a XML alkalmazásokat a funkciógombokhoz vagy a vonalgombokhoz.

A támogatott funkciók a következők:

  • Üzenetek (képek és szöveg)
  • Lapozás

Támogatott XML objektumok

  • CiscoIPPhoneMenu

  • CiscoIPPhoneText

  • CiscoIPPhoneInput

  • CiscoIPPhoneDirectory

  • CiscoIPPhoneImage

  • CiscoIPPhoneImageFile

  • CiscoIPPhoneIconMenu

  • CiscoIPPhoneIconFileMenu

  • CiscoIPPhoneStatus (kivéve 9841)

  • CiscoIPPhoneStatusFile (kivéve 9841)

  • CiscoIPPhoneExecute

Támogatott URI-k

  • Eszköz

  • Tárcsáz

  • EditDail

  • Init

  • Kulcs

  • Lejátszás (csak csengőhangok esetén)

  • Gomb

Az XSI szolgáltatás konfigurációjával kapcsolatos további részletekért lásd Cisco Unified IP Phone Szolgáltatások alkalmazásfejlesztési megjegyzései.

Telefon konfigurálása XML szolgáltatáshoz való csatlakozáshoz

1

Lépjen be a telefon adminisztrációs weboldalára.

2

Válassza ki a Hang > Telefon lehetőséget.

3

A XML szolgáltatás szakaszban konfigurálja az XML alkalmazásszolgáltatás neve és XML az alkalmazásszolgáltatás URL-címe paramétereket a XML szolgáltatások paramétereiben meghatározottak szerint.

4

(Nem kötelező) Az alkalmazásszolgáltatás eléréséhez szükséges hitelesítés hozzáadásához konfigurálja a következő mezőket: XML Felhasználónév,XML Jelszó,CISCO XML EXE engedélyezése és CISCO XML EXE hitelesítési mód.

5

Kattintson az Összes módosítás mentése gombra.

A XML szolgáltatások paraméterei

Az alábbi táblázat a XML alkalmazásparaméterek funkcióját és használatát határozza meg a telefon webes felületén a Hang >telefon lap XML Szolgáltatás szakaszában. Meghatározza továbbá a telefon konfigurációs fájljába (cfg.xml) a paraméter konfigurálásához XML-kóddal hozzáadott karakterlánc szintaxisát.

1. táblázat. A XML szolgáltatások paraméterei

Paraméter

Alapértelmezett értékek és beállítások

Leírás

XML alkalmazásszolgáltatás neve

Alapértelmezett: üres

A XML alkalmazás neve. A név webalkalmazás-választásként jelenik meg a telefonon.

Ezt a paramétert a telefon konfigurációs XML fájljában (cfg.xml) is konfigurálhatja, ha beír egy karakterláncot a következő formátumban:

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

XML Application Service URL-címe

Alapértelmezett: üres

Az az URL-cím, ahol a XML alkalmazás található.

Ezt a paramétert a telefon konfigurációs XML fájljában (cfg.xml) is konfigurálhatja, ha beír egy karakterláncot a következő formátumban:

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

A makróváltozókat XML URL-címek támogatják. Az érvényes makróváltozókról A XML URL-címekben támogatott makróváltozók című témakörben olvashat.

Az URL-cím csak a HTTP vagy HTTP protokollokat támogatja.

XML felhasználónév

Alapértelmezett: üres

XML szolgáltatás felhasználónevét hitelesítési célokra.

Ezt a paramétert a telefon konfigurációs XML fájljában (cfg.xml) is konfigurálhatja, ha beír egy karakterláncot a következő formátumban:

<XML_User_Name ua="na">felhasználónév</XML_User_Name>

XML jelszó

Alapértelmezett: üres

XML megadott XML-felhasználónévhez tartozó szolgáltatásjelszót.

Az ebben a mezőben megadott jelszó a konfigurációs fájlban (cfg.xml) a következőképpen jelenik meg:

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

CISCO XML EXE engedélyezése

Alapértelmezett: Nem

Lehetőségek: Igen, Nem

Megadja, hogy szükség van-e hitelesítésre a XML alkalmazáskiszolgáló eléréséhez.

Ezt a paramétert a telefon konfigurációs XML fájljában (cfg.xml) is konfigurálhatja, ha beír egy karakterláncot a következő formátumban:

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

CISCO XML EXE hitelesítési mód

Alapértelmezés: Helyi hitelesítő adatok

Beállítások: Megbízható, Helyi hitelesítő adatok, Távoli hitelesítő adatok

A Cisco XML EXE hitelesítési módját adja meg.

  • Megbízható – A rendszer a helyi hitelesítő adatoktól függetlenül nem végez hitelesítést.

  • Helyi hitelesítő adatok – A hitelesítés a kivonatoló hitelesítésen alapul a helyi hitelesítő adatokkal, ha be van állítva. Ha a helyi hitelesítő adatok nincsenek beállítva, akkor a rendszer nem végez hitelesítést.

  • Távoli hitelesítő adatok – A hitelesítés a kivonatoló hitelesítésen alapul, amely a weboldalon található XML alkalmazásban beállított távoli hitelesítő adatokkal történik (egy XML alkalmazáskiszolgáló eléréséhez).

Ezt a paramétert a telefon konfigurációs XML fájljában (cfg.xml) is konfigurálhatja, ha beír egy karakterláncot a következő formátumban:

<CISCO_XML_EXE_Auth_Mode ua="na">Helyi hitelesítő adatok</CISCO_XML_EXE_Auth_Mode>

XML alkalmazás hozzáadása funkciógombhoz

Adja hozzá a gyakran használt alkalmazásokat a funkciógombokhoz, hogy a felhasználók könnyen hozzáférhessenek a szolgáltatáshoz.

Mielőtt nekilátna

A XML Application Service megfelelően van konfigurálva.

1

Lépjen be a telefon adminisztrációs weboldalára.

2

Válassza ki a Hang > Telefon lehetőséget.

3

A Programozható funkciógombok részben állítsa a Programozható funkciógomb engedélyezése beállítást Igen értékre.

Ezt a paramétert a konfigurációs fájlban (cfg.xml) is konfigurálhatja. Írjon be egy karakterláncot a következő formátumban:

<Programmable_Softkey_Enable ua="na">Igen</Programmable_Softkey_Enable>
4

A Programozható funkciógombok részben szerkessze a PSK1 és PSK16 között elérhető mezőket a következő formátumban:

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

ahol az URL az a hivatkozás, ahol az XML alkalmazás tárolódik; Az NME az alkalmazás megjelenített neve a telefon képernyőjén.

Példa: fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu

Ezt a paramétert a konfigurációs fájlban (cfg.xml) is konfigurálhatja. Írjon be egy karakterláncot a következő formátumban:

<PSK_n ua="na">fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu<konfigurációs kód></PSK_n>

ahol n a funkciógomb száma.

5

Kattintson az Összes módosítás mentése gombra.

XML alkalmazás hozzáadása vonalgombhoz

Adja hozzá a gyakran használt alkalmazásokat a vonalgombokhoz, hogy a felhasználók könnyen hozzáférhessenek a szolgáltatásokhoz.

Mielőtt nekilátna

A XML Application Service megfelelően van konfigurálva.

1

Lépjen be a telefon adminisztrációs weboldalára.

2

Válassza ki a Hang > Telefon lehetőséget.

3

Válasszon ki egy vonalkulcsot.

4

Állítsa a Extension paramétert Disabled (Letiltva ) értékre a bővítmény letiltásához.

Ha a Közvetlen PLK-konfiguráció funkció le van tiltva, le kell tiltania a melléket, hogy kiterjesztett függvényt adjon a vonalgombhoz. Ha a funkció engedélyezve van, kihagyhatja ezt a lépést. Részletekért lásd: Direct PLK-konfiguráció engedélyezése.
5

A Bővített funkció paraméterben adjon meg egy karakterláncot ebben a formátumban:

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

ahol az URL az a hivatkozás, ahol az XML alkalmazás tárolódik; Az NME az alkalmazás megjelenített neve a telefon képernyőjén.

Példa: fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu

Ezt a paramétert a konfigurációs fájlban (cfg.xml) is konfigurálhatja. Írjon be egy karakterláncot a következő formátumban:

<Extended_Function_n_ ua="na">fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu<konfigurációs kód></Extended_Function_n_>

ahol n a mellék száma.

6

Kattintson az Összes módosítás mentése gombra.

A XML URL-címekben támogatott makróváltozók

A makróváltozók XML URL-címekben használhatók. A következő makróváltozók támogatottak:

  • Felhasználói azonosító: UID1, UID2–UIDn

  • Megjelenítendő név – DISPLAYNAME1, DISPLAYNAME2 DISPLAYNAMEn értékre

  • Hitelesítési azonosító – AUTHID1, AUTHID2 az AUTHIDn-nek

  • Proxy – PROXY1, PROXY2 – PROXYn

  • MAC Megszólítás kisbetűs hexadecimális számjegyekkel – MA

  • Terméknév – PN

  • Terméksorozatszám – PSN

  • Sorozatszám – SERIAL_NUMBER

2. táblázat. Támogatott makrók
Makró neveMakró kiterjesztés
$A $$ űrlap egyetlen $ karakterré bővül.
A - PÁltalános célú paraméterekkel helyettesítve GPP_A GPP_P.
SA - SDA speciális célú GPP_SA - GPP_SD paraméterek értékeinek tartalmával lesz kicserélve. Ezek a paraméterek a szolgáltatásban használt kulcsok vagy jelszavak.
Az $SA - $SD értékek argumentumként lesznek felismerve az opcionális újraszinkronizálási URL meghatározóhoz -- kulcs.
MAMAC címet kisbetűs hexadecimális számjegyekkel (000E08AABBCC).
MAUMAC cím nagybetűs hexadecimális számjegyekkel (000E08AABBCC).
MACMAC a címet, amely kisbetűs hexadecimális számjegyeket és kettőspontot használ a hexadecimális számjegypárok elválasztására (00:0e:08:aa:bb:cc).
PNterméknév; például 8875-ös videotelefon, 9851-es asztali telefon.
PSNTerméksorozat száma; Például: 8875, 9841, 9861
SNSorozatszám karakterlánc; például: 88012BA01234.
CCERTSSL Ügyféltanúsítvány állapota, telepítve vagy nincs telepítve.
IPIP telefon címe a helyi alhálózaton belül, például 192.168.1.100.
EXTIPA telefon külső IP, ahogyan az az interneten látható; például 66.43.16.52.

SWVER

A szoftver verzió string. Például,

TELEFONOS.3-2-1-0104-37

HWVER

A hardver verzió string. Például 2.0.1

PRVST

Szolgáltatási állapot (szám string):

-1 = explicit újraszinkronizálási kérés

0 = bekapcsolás újraszinkron

1 = időszakos újraszinkron

2 = újraszinkron sikertelen, ismétlési kísérlet

UPGST

Frissítési állapot (szám string):

1 = első frissítési kísérlet

2 = frissítés sikertelen, ismétlési kísérlet

UPGERR

Az előző frissítési kísérlet eredmény üzenete (ERR); például http_get sikertelen.

PRVTMR

Az utolsó újraszinkron kísérlet óta eltelt másodpercek.

UPGTMR

Az utolsó frissítési kísérlet óta eltelt másodpercek.

REGTMR1

A Line 1 vonalon a SIP szerverrel elvesztett regisztráció óta eltelt másodpercek.

REGTMR2

A Line 2 vonalon a SIP szerverrel elvesztett regisztráció óta eltelt másodpercek.

UPGCOND

Régi makrónév.

SCHEME

Fájl hozzáférési séma, egy TFTP, HTTP vagy HTTPS az újraszinkron vagy frissítés URL elemzés során kapott módon.

SERV

Kérési cél szerver kiszolgáló név az újraszinkron vagy frissítés URL elemzés során kapott módon.

SERVIP

Kérési cél szerver kiszolgáló IP cím az újraszinkron vagy frissítés URL elemzés során kapott módon, valószínűleg DNS keresés után.

PORT

Kérési cél UDP/TCP port az újraszinkron vagy frissítés URL elemzés során kapott módon.

PATH

Kérési cél fájl útvonal az újraszinkron vagy frissítés URL elemzés során kapott módon.

ERR

Az újraszinkron vagy frissítési kísérlet eredmény üzenete. Csak az eredmény syslog üzenetek létrehozásánál hasznos. Az érték az UPGERR változóban tárolódik frissítési kísérlet esetén.

UIDn

A Line n UserID konfigurációs paraméter tartalma.

ISCUST

Ha az egység testre van szabva, value=1, egyébként 0.

A testreszabási állapot a Webes felhasználói felület adatai oldalon tekinthető meg.

INCOMINGNAMEAz első csatlakoztatott, kicsengő vagy bejövő híváshoz társított név.
TÁVOLI SZÁM

Az első csatlakoztatott, kicsengő vagy bejövő hívás telefonszáma. Több hívás esetén az első megtalált híváshoz tartozó adatok kerülnek megadásra.

MEGJELENÍTENDŐ NÉVnAz N sor megjelenítendő neve konfigurációs paraméter tartalma.
AUTHIDnAz N vonal hitelesítési azonosítója konfigurációs paraméter tartalma.