Áttekintés

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

Miután előfizette a telefont a szolgáltatásokra, a felhasználók a telefon összes konfigurált szolgáltatását a Beállítások > Hálózat és szolgáltatás > Cisco XML szolgáltatások menüpontban érhetik el. Az alapértelmezett név a Cisco XML szolgáltatások. A nevet is megváltoztathatja. A felhasználók könnyű hozzáférésének biztosítása érdekében hozzáadhatja az XML-alkalmazásokat funkciógombokhoz vagy vonalgombokhoz.

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

  • Üzenetek (képek és szöveg)
  • Személyhívás

Támogatott XML objektumok

  • Cisco IPPhoneMenü

  • CiscoIPPhoneText

  • CiscoIPPhoneInput

  • CiscoIPPhoneDirectory címtár

  • CiscoIPPhoneImage

  • CiscoIPPhoneImageFile

  • CiscoIPPhoneIconMenu

  • CiscoIPPhoneIconFileMenu

  • CiscoIPPhoneStatus (kivéve 9841)

  • CiscoIPPhoneStatusFile (kivéve 9841)

  • CiscoIPPhoneExecute

Támogatott URI-k

  • Eszköz

  • Tárcsázás

  • Szerkesztési dátum

  • Inicializálás

  • Kulcs

  • Lejátszás (csak csengőhangok)

  • Funkciógomb

Az XSI szolgáltatás konfigurációjával kapcsolatos további részletekért lásd: A Cisco Unified IP-telefon 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 a Hang > Telefon lehetőséget.

3

Az XML szolgáltatás szakaszban konfigurálja az XML alkalmazás szolgáltatás nevét és az XML alkalmazás szolgáltatás URL paramétereit az XML szolgáltatások paraméterei című részben meghatározottak szerint.

4

(Opcionális) Ha hitelesítést szeretne hozzáadni az alkalmazásszolgáltatáshoz való hozzáféréshez, 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.

XML szolgáltatások paraméterei

Az alábbi táblázat határozza meg az XML alkalmazásparaméterek funkcióját és használatát az XML szolgáltatás szakaszban a Hang > Telefon lapon a telefon webinterfészén. Meghatározza annak a karakterláncnak a szintaxisát is, amelyet a telefon konfigurációs fájljához (cfg.xml) adtak hozzá XML kóddal a paraméter konfigurálásához.

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

Paraméter

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

Leírás

XML alkalmazásszolgáltatás neve

Alapértelmezett: üres

Az 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 a következő formátumú karakterláncot adja meg:

<XML_Application_Service_Name ua="na">XML alkalmazás neve</XML_Application_Service_Name>

XML alkalmazásszolgáltatás URL-címe

Alapértelmezett: üres

Az URL, ahol az XML alkalmazás található.

Ezt a paramétert a telefon konfigurációs XML fájljában (cfg.xml) is konfigurálhatja, ha a következő formátumú karakterláncot adja meg:

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

XML URL-címekben a makróváltozók támogatottak. Az érvényes makróváltozókat lásd az XML URL-címekben támogatott makróváltozók című részben.

Az URL csak HTTP vagy HTTPs protokollok támogatottak.

XML-felhasználónév

Alapértelmezett: üres

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

Ezt a paramétert a telefon konfigurációs XML fájljában (cfg.xml) is konfigurálhatja, ha a következő formátumú karakterláncot adja meg:

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

XML jelszó

Alapértelmezett: üres

XML szolgáltatás jelszava a megadott XML felhasználónévhez.

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

<!-- <XML_jelszó ua="na">;*************</XML_jelszó> -->

A CISCO XML EXE engedélyezése

Alapértelmezett: Nem

Beállítások: Igen, Nem

Megadja, hogy szükséges-e hitelesítés az 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 a következő formátumú karakterláncot adja meg:

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

A CISCO XML EXE hitelesítési módja

Alapértelmezett: Helyi hitelesítő adat

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 helyi hitelesítő adattól függetlenül nem történik hitelesítés.

  • Helyi hitelesítő adatok – A hitelesítés a helyi hitelesítő adatok kivonatoló hitelesítésén alapul, ha be van állítva. Ha nincs beállítva a helyi hitelesítő adat, akkor nem történik hitelesítés.

  • Távoli hitelesítő adatok – A hitelesítés a weblapon az XML alkalmazásban beállított távoli hitelesítő adatok kivonatoló hitelesítésén alapul (egy XML alkalmazás szerverhez való hozzáféréshez).

Ezt a paramétert a telefon konfigurációs XML fájljában (cfg.xml) is konfigurálhatja, ha a következő formátumú karakterláncot adja meg:

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

XML-alkalmazás hozzáadása egy 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 elkezdené

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

1

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

2

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

3

A Programozható funkciógombok részben állítsa a Programozható funkciógomb engedélyezéseIgen értékre.

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

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

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

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

ahol az url az a hivatkozás, ahol az XML alkalmazást tárolják; 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. Adjon meg egy karakterláncot a következő formátumban:

<PSK_n ua="na">fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menü<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 egy 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 elkezdené

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

1

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

2

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

3

Válasszon ki egy vonalgombot.

4

A mellék letiltásához állítsa a Mellék paramétert Letiltva értékre.

Ha a közvetlen PLK konfigurációs funkció le van tiltva, akkor le kell tiltania a melléket ahhoz, hogy kibővített funkciót adjon hozzá a vonalgombhoz. Ha engedélyezve van a funkció, kihagyhatja ezt a lépést. Részletekért lásd: A közvetlen PLK-konfiguráció engedélyezése.
5

A Kibővített függvény paraméterben adjon meg egy ilyen formátumú karakterláncot:

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

ahol az url az a hivatkozás, ahol az XML alkalmazást tárolják; 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. Adjon meg 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=Menü<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.

XML URL-ekben támogatott makróváltozók

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

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

  • Megjelenített név – DISPLAYNAME1, DISPLAYNAME2 – DISPLAYNAMEn

  • Hitelesítési AZONOSÍTÓ – AUTHID1, AUTHID2 – AUTHIDn

  • Proxy – PROXY1, PROXY2 – PROXYn

  • MAC-cím kisbetűs hex jegyekkel – MA

  • Termék neve – PN

  • Terméksorozat száma – PSN

  • Sorozatszám—SERIAL_NUMBER

2. táblázat Támogatott makrók
Makró neveMakró kiterjesztés
$A $$ űrlap kiterjesztése egyetlen $ karakter.
A-tól P-igAz általános célú GPP_A - GPP_P paraméterekkel helyettesítve.
SA és SD közöttA speciális célú GPP_SA - GPP_SD paraméterek kerülnek kicserélésre. Ezek a paraméterek a szolgáltatásban használt kulcsok vagy jelszavak.
Az $SA - $SD argumentumként ismeri fel az opcionális újraszinkronizálási URL minősítő --key paraméterként.
Az USAMAC cím kisbetűs hex jegyekkel (000e08aabbcc).
MAUMAC-cím, nagybetűs hex jegyekkel (000E08AABBCC).
mac-enMAC-cím, kisbetűs hexadecimális számjegyekkel és kettősponttal a hexadecimális számpárok elválasztására (00:0e:08:aa:bb:cc).
pnTerméknév; például: 8875-ös videótelefon, 9851-es asztali telefon.
psnTerméksorozatszám; például 8875, 9841, 9861
snSorozatszám karakterlánc; például 88012BA01234.
Ccert-nekSSL kliens tanúsítvány állapota, telepített vagy nem telepített.
IPA telefon IP címe a helyi alhálózaton belül; például 192.168.1.100.
kilépésA telefon külső IP-címe, amint az interneten látható; például 66.43.16.52.

Cserélő

Szoftververzió-karakterlánc. Például:

phoneos.3-2-1-0104-37

Hwver (egyértelműsítő lap)

Hardververzió-karakterlánc. Például: 2.0.1

Kategória: Németország

Szolgáltatási állapot (numerikus karakterlánc):

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

0 = bekapcsolási újraszinkronizálás

1 = időszakos újraszinkronizálás

2 = újraszinkron sikertelen, újrapróbálkozás

upgst

Frissítési állapot (numerikus karakterlánc):

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

2 = frissítés sikertelen, újrapróbálkozás

upgerr (egyértelműsítő lap)

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

Az 1-es vonal elvesztése óta eltelt másodpercek a SIP szerverrel.

regtmr2

A 2-es vonal elvesztése óta eltelt másodpercek a SIP szerverrel.

upgcond csevegés

Régi makró neve.

Séma

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.

Szervo

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

Szervo

Kérés cél szerver IP cím az újraszinkronizálás 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.

útvonal

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

err

Újraszinkronizálási vagy frissítési kísérlet eredmény üzenete. Csak az eredmény syslog üzenetek generálásakor hasznos. Az érték frissítési kísérletek esetén az UPGERR változóban marad.

UID-n

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

Iszkusz

Ha az egység testreszabott, az érték=1, egyébként 0.

A testreszabási állapot megtekinthető a webes felhasználói felület információs oldalán.

tartozásnameAz elsőként kapcsolódott, kicsengő vagy bejövő híváshoz társított név.
távoli szám

Az első kapcsolódott, kicsengő vagy bejövő hívás telefonszáma. Több hívás esetén a rendszer az első talált híváshoz tartozó adatokat adja meg.

Megjelenítési NÉVnA Line N megjelenítési név konfigurációs paraméter tartalma.
HITELESÍTÉSA Line N hitelesítési azonosító konfigurációs paraméter tartalma.