Ebben a cikkben
dropdown icon
Áttekintés
    Támogatott XML objektumok
    Támogatott URI-k
Telefonok konfigurálása XML-szolgáltatáshoz való csatlakozáshoz
XML szolgáltatások paraméterei
XML alkalmazás hozzáadása egy softbillentyűhöz
XML-alkalmazás hozzáadása egy sorkulcshoz
Az XML URL-ekben támogatott makróváltozók

XML alkalmazások konfigurálása 9800 és 8875 telefonokhoz (BroadWorks)

list-menuEbben a cikkben
list-menuVisszajelzés?

Ez a súgócikk a Cisco BroadWorks szolgáltatásban regisztrált Cisco Desk Phone 9800 Series és Cisco Video Phone 8875 termékekre vonatkozik. Olvassa el ezt a cikket a támogatott XML-objektumokról, az URI-król és az XSI-szolgáltatások konfigurálásának lépéseiről a telefon weboldalán.

Áttekintés

Az XML Services Interface (XSI) egy olyan protokoll, amely lehetővé teszi az alkalmazások és a telefonrendszer közötti kommunikációt. A támogatott X ML-objektumok és URI-k segítségével hozzáadhatja saját XSI-szolgáltatásait telefonjához.

Miután feliratkozta a telefont a szolgáltatásokra, a felhasználók elérhetik 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üpontra navigálva. A Cisco XML szolgáltatások az alapértelmezett név. Megváltoztathatja a nevet is. A felhasználók számára könnyű hozzáférés biztosítása érdekében az XML-alkalmazásokat a programbillentyűkhöz vagy vonalkulcsokhoz is hozzáadhatja.

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

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

Támogatott XML objektumok

  • CiscoIPPhoneMenu

  • CiscoipphoneText

  • CiscoipPhoneInput

  • CiscoipPhoneDirectory

  • CiscoipphoneImage

  • CiscoipPhoneImageFile

  • CiscoipPhoneIkon menü

  • CiscoipPhoneIconFileMenu

  • CiscoipPhoneStatus (kivéve 9811 és 9841)

  • CISCOIPPhonEstatusFile (kivéve 9811 és 9841)

  • CiscoipPhoneExecute

Támogatott URI-k

  • Eszköz

  • Tárcsa

  • EditDail

  • Init

  • Kulcs

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

  • Softkey

Az XSI szolgáltatás konfigurációjával kapcsolatos további részletekért lásd a Cisco Unified IP Phone Services alkalmazásfejlesztési megjegy zéseit.

Telefonok konfigurálása XML-szolgáltatáshoz való csatlakozáshoz

1

Nyissa meg a telefon adminisztrációs weboldalát.

2

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

3

Az XML-szolgáltatás szakaszban állí tsa be az XML-alkalmazásszolgáltatás ne vét és az XML alkalmazásszolgál tatás URL- paramétereit az XM L-szolgáltatások paraméterei menüpontban meghatározottak szerint.

4

(Opcionális) Ha hitelesítést szeretne hozzáadni az alkalmazásszolgáltatáshoz, konfigurálja a mezőket: XML felhasználónév, XML jelszó, CISCO XML EXE En able és CISCO XML EXE Auth Mo de.

5

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

XML szolgáltatások paraméterei

Az alábbi táblázat az XML-alkalmazás paramétereinek működését és használatát határozza meg az XML-szolgáltatás szakaszban a telefon webes felületén a Hang > Telefon lap alatt. Meghatározza annak a karakterláncnak a szintaxisát is, amelyet a telefon konfigurációs fájljába (cfg.xml) XML kóddal adnak hozzá egy paraméter konfigurálásához.

Táblázat 1. 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 webes alkalmazásként jelenik meg a telefonon.

Ezt a paramétert a telefonkonfigurációs XML fájlban (cfg.xml) is konfigurálhatja egy karakterlánc megadásával ebben a formátumban:

<XML_Application_Service_Name
ua="na">XML APP Name</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 telefonkonfigurációs XML fájlban (cfg.xml) is konfigurálhatja egy karakterlánc megadásával ebben a formátumban:

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

A makróváltozókat az XML URL-ek támogatják. Az érvényes makróváltozókat lásd: XML URL-ek által támogatott makróváltozók.

Csak HTTP vagy HTTPs protokollok támogatottak az URL-ben.

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 telefonkonfigurációs XML fájlban (cfg.xml) is konfigurálhatja egy karakterlánc megadásával ebben a formátumban:

<XML_User_Name ua="na">username</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_Password ua="na">*************</XML_Password>
-->

CISCO XML EXE engedélyezése

Alapértelmezett: Nem

Opciók: Igen, Nem

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

Ezt a paramétert a telefonkonfigurációs XML fájlban (cfg.xml) is konfigurálhatja egy karakterlánc megadásával ebben a formátumban:

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

CISCO XML EXE hitelesítési mód

Alapértelmezett: Helyi hitelesítő adatok

Opciók: Megbízható, Helyi hitelesítő adatok, Távoli hitelesítő adatok

Megadja a Cisco XML EXE hitelesítési módját.

  • Megbízható — A helyi hitelesítő adatoktól függetlenül nem történik hitelesítés.

  • Helyi hitelesítés — A hitelesítés a helyi hitelesítő adatokat használó összesített hitelesítésen alapul, ha beállítva van. Ha a helyi hitelesítő adatok nincs beállítva, akkor hitelesítés nem történik meg.

  • Távoli hitelesítés — A hitelesítés a weboldal XML-alkalmazásában beállított távoli hitelesítő adatokat használó összesített hitelesítésen alapul (egy XML-alkalmazáskiszolgáló eléréséhez).

Ezt a paramétert a telefonkonfigurációs XML fájlban (cfg.xml) is konfigurálhatja egy karakterlánc megadásával ebben a formátumban:

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

XML alkalmazás hozzáadása egy softbillentyűhöz

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

Mielőtt elkezdené

Az XML alkalmazásszolgáltatás megfelelően van konfigurálva.

1

Nyissa meg a telefon adminisztrációs weboldalát.

2

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

3

A Programozható Softkeys szakaszban állí tsa be a Programozható Softkey Enable lehetőséget Igen értékre.

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

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

A Programozható Softkeys szakasz ban szerkesztheti a PSK1 és PSK16 elérhető mezőket ebben a formátumban:

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

ahol az url az a link, ahol az XML alkalmazás tárolódik; 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 is konfigurálhatja (cfg.xml). Írjon be egy karakterláncot ebben a formátumban:

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

ahol n a programkulcs száma.

5

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

XML-alkalmazás hozzáadása egy sorkulcshoz

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

Mielőtt elkezdené

Az XML alkalmazásszolgáltatás megfelelően van konfigurálva.

1

Nyissa meg a telefon adminisztrációs weboldalát.

2

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

3

Válasszon egy vonalgombot.

4

A kiterjesztés letiltásához állí tsa a Bő vítmény paramétert Letiltva értékre.

Ha a Közvetlen PLK konfiguráció funkció le van tiltva, le kell tiltania a kiterjesztést ahhoz, hogy kiterjesztett funkciót adjon hozzá a vonalgombhoz. Ha a funkció engedélyezve van, kihagyhatja ezt a lépést. Részletekért lásd: Közvet len PLK konfiguráció engedél yezése.
5

Az Extended Function paraméterben írjon be egy karakterláncot ebben a formátumban:

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

ahol az url az a link, ahol az XML alkalmazás tárolódik; 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 is konfigurálhatja (cfg.xml). Írjon be egy karakterláncot ebben a formátumban:

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

ahol n a kiterjesztés száma.

6

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

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

Használhat makróváltozókat XML URL-ekben. A következő makróváltozók támogatottak:

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

  • Megjelenítési név — DisplayName1, DISPLAYNAME2 a DisplayNamen

  • Autóazonosító — AUTHID1, AUTHID2-től AuthidN-ig

  • Proxy—Proxy1, PROXY2 a ProxyN

  • MAC-cím kisbetűs hexadegyek használatával—MA

  • Terméknév — PN

  • Terméksorozat száma — PSN

  • Sorozatszám — sorozatszám

Táblázat 2. Támogatott makrók
Makró névMakró bővítés
$A $$ forma egyetlen $ karakterre bővül.
A-tól P-igÁltalános célú paraméterekkel helyettesítik a GPP_A GPP_P-n keresztül.
SA-n keresztül SD-nA GPP_SD-n keresztül GPP_SA speciális célú paraméterekkel helyettesítették. Ezek a paraméterek tartalmaznak a biztosításhoz használt kulcsokat vagy jelszavakat.

A $SA-tól $SD-ig az opcionális újraszinkronizálási URL-minősítő (--key) argumentumként ismerik fel .

MAMAC-cím kisbetűs hatlapszámjegyek használatával (000e08aabbcc).
MAUMAC-cím nagybetűs hatlapszámjegyek használatával (000E08AABBCC).
MACMAC-cím a kettősponttal ellátott kisbetűs hatszögletű számjegyeket használva a hatlapú számjegypárok elválasztásához (00:0 e:08:aa:bb:cc).
PNTermék neve; például videótelefon 8875, asztali telefon 9851.
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.
IPA telefon IP-címe a helyi alhálózaton belül; például 192.168.1.100.
EXTIPA telefon külső IP-je az interneten látható; például 66.43.16.52.

SWVER

Szoftververzió karakterlánc. Például

PHONEOS.3-2-1-0104-37

HWVER

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

PRVST

Rendelkezési állapot (numerikus karakterlánc):

-1 = kifejezett újraszinkronizálási kérelem

0 = bekapcsolás újraszinkronizálása

1 = időszakos újraszinkronizálás

2 = sikertelen újraszinkronizálás, próbálja újra

UPGST

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

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

2 = a frissítés sikertelen, próbálkozzon újra

UPGERR

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

PRVTMR

Másodpercek az utolsó újraszinkronizálási kísérlet óta.

UPGTMR

Másodpercek az utolsó frissítési kísérlet óta.

REGTMR1

Másodpercekkel azóta, hogy az 1. sor elvesztette a regisztrációt a SIP szerverrel.

REGTMR2

Másodpercekkel azóta, hogy a 2. sor elvesztette a regisztrációt a SIP szerverrel.

UPGCOND

Régebbi makró név.

SCHEME

Fájlhozzáférési séma, amely a TFTP, HTTP vagy HTTPS egyike, az újraszinkronizálás vagy frissítési URL elemzése után kapható.

SERV

Kérje meg a célkiszolgáló gazdanevét, amint azt az újraszinkronizálás vagy frissítés URL elemzése után kaptuk.

SERVIP

Kérje meg a célkiszolgáló IP-címét az újraszinkronizálás vagy az URL frissítése elemzése után, esetleg a DNS-keresést követően.

PORT

Cél UDP/TCP port kérése az újraszinkronizálás vagy frissítés URL elemzése után kapott.

PATH

Kérje meg a célfájl elérési útvonalát az újraszinkronizálás vagy az URL frissítése elemzése után.

ERR

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

UIDn

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

ISCUST

Ha az egység testreszabott, akkor érték-1, ellenkező esetben 0.

A testreszabási állapot a Web UI Info oldalon látható.

INCOMINGNAMEAz első csatlakoztatott, csengő vagy bejövő híváshoz társított név.
REMOTENUMBER

Az első csatlakoztatott, csengő vagy bejövő hívás telefonszáma. Ha több hívás van, megadják az első talált híváshoz kapcsolódó adatokat.

DisplayNameAz N Line Display Name konfigurációs paraméter tartalma.
AuthidNAz N Line auth ID konfigurációs paraméter tartalma.
Hasznos volt ez a cikk?
Hasznos volt ez a cikk?