- Domů
- /
- Článek
XML pro telefony na BroadWorks
V tomto článkuTento článek nápovědy se týká telefonů Cisco Desk Phone řady 9800 a Cisco Video Phone 8875, které jsou registrovány u společnosti Cisco BroadWorks. V tomto článku najdete podporované objekty XML, identifikátory URI a postup konfigurace služeb XSI na webové stránce telefonu.
Přehled
XML Services Interface (XSI) je protokol, který umožňuje komunikaci mezi aplikacemi a telefonním systémem. Do telefonu můžete přidat vlastní služby XSI pomocí podporovaných objektů XML a identifikátorů URI.
Po přihlášení telefonu k odběru služeb mohou uživatelé přistupovat ke všem nakonfigurovaným službám v telefonu v . Cisco XML services je výchozí název. Můžete také změnit název. Chcete-li uživatelům poskytnout snadný přístup, můžete přidat XML aplikace k softwarovým nebo linkovým klávesám.
Podporované funkce jsou:
- Zprávy (obrázky a text)
- Výpis
Podporované XML objekty
-
CiscoIPPhoneMenu
-
CiscoIPPhoneText
-
CiscoIPPhoneInput
-
CiscoIPPhoneDirectory
-
CiscoIPPhoneImage
-
CiscoIPPhoneImageFile
-
CiscoIPPhoneIconMenu
-
CiscoIPPhoneIconFileMenu
-
CiscoIPPhoneStatus (kromě 9841)
-
CiscoIPPhoneStatusFile (kromě 9841)
-
CiscoIPPhoneExecute
Podporované identifikátory URI
-
Zařízení
-
Ciferník
-
EditDail
-
Init
-
Klíč
-
Přehrát (pouze vyzváněcí tóny)
-
Softwarové tlačítko
Další podrobnosti o konfiguraci služby XSI naleznete v tématu Cisco Unified IP Phone Poznámky k vývoji aplikací pro služby.
Konfigurace telefonu pro připojení ke službě XML
| 1 |
Přejděte na webovou stránku správy telefonu. |
| 2 |
Vyberte možnost . |
| 3 |
V části XML služba nakonfigurujte parametry XML Název aplikační služby a XML adresa URL aplikační služby definované v tématu Parametry pro XML služby. |
| 4 |
(Volitelné) Chcete-li přidat autentizaci pro přístup k aplikační službě, nakonfigurujte tato pole: XML Uživatelské jméno,XML Heslo,Povolit XML CISCO EXE a Režim ověřování CISCO XML EXE. |
| 5 |
Klikněte na Uložit všechny změny. |
Parametry pro XML služby
Následující tabulka definuje funkci a použití parametrů aplikace XML v části Služba XML v záložce ve webovém rozhraní telefonu. Definuje také syntaxi řetězce, který je přidán do konfiguračního souboru telefonu (cfg.xml) s kódem XML (cfg.xml) za účelem konfigurace parametru.
|
Parametr |
Výchozí nastavení a možnosti |
Popis |
|---|---|---|
|
Název služby aplikace XML |
Výchozí: prázdné |
Název XML aplikace. Název se zobrazí v telefonu jako volba webové aplikace. Tento parametr můžete také nakonfigurovat v souboru XML konfigurace telefonu (cfg.xml) zadáním řetězce v tomto formátu: |
|
XML adresa URL aplikační služby |
Výchozí: prázdné |
Adresa URL, kde je umístěna aplikace XML. Tento parametr můžete také nakonfigurovat v souboru XML konfigurace telefonu (cfg.xml) zadáním řetězce v tomto formátu: Proměnné maker jsou podporovány v XML adresách URL. Platné proměnné maker naleznete v tématu Proměnné maker podporované v XML adresách URL. V adrese URL jsou podporovány pouze protokoly HTTP nebo HTTP. |
|
Uživatelské jméno XML |
Výchozí: prázdné |
XML uživatelské jméno služby pro účely ověřování. Tento parametr můžete také nakonfigurovat v souboru XML konfigurace telefonu (cfg.xml) zadáním řetězce v tomto formátu: |
|
Heslo XML |
Výchozí: prázdné |
XML servisní heslo pro zadané uživatelské jméno XML. Heslo, které jste zadali do tohoto pole, se zobrazí v konfiguračním souboru (cfg.xml) takto: |
|
CISCO XML EXE Povolit |
Výchozí nastavení: Ne Možnosti: Yes, No |
Určuje, zda je pro přístup k XML aplikačnímu serveru vyžadováno ověření. Tento parametr můžete také nakonfigurovat v souboru XML konfigurace telefonu (cfg.xml) zadáním řetězce v tomto formátu: |
|
Režim ověřování CISCO XML EXE |
Výchozí nastavení: Místní pověření Možnosti: Důvěryhodné, Místní pověření, Vzdálené pověření |
Určuje režim ověřování pro Cisco XML EXE.
Tento parametr můžete také nakonfigurovat v souboru XML konfigurace telefonu (cfg.xml) zadáním řetězce v tomto formátu: |
Přidání XML aplikace do softwarového tlačítka
Přidejte často používané aplikace k softwarovým klávesám, aby uživatelé měli snadný přístup ke službě.
Než začnete
Služba XML Application Service byla správně nakonfigurována.
| 1 |
Přejděte na webovou stránku správy telefonu. |
| 2 |
Vyberte možnost . |
| 3 |
V části Programovatelné softwarové klávesy nastavte položku Programovatelná softwarová klávesa Povolit na Ano . Tento parametr můžete také nakonfigurovat v konfiguračním souboru (cfg.xml). Zadejte řetězec v tomto formátu: |
| 4 |
V části Programovatelné softwarové klávesy upravte dostupná pole PSK1 až PSK16 v tomto formátu: fnc=xml;url=<xml_app_path>; nme=<app_name>
kde
Příklad Tento parametr můžete také nakonfigurovat v konfiguračním souboru (cfg.xml). Zadejte řetězec v tomto formátu:
kde n je číslo softwarového tlačítka. |
| 5 |
Klikněte na Uložit všechny změny. |
Přidání aplikace XML do klíče linky
Přidejte často používané aplikace do klíčů linek, aby uživatelé měli snadný přístup ke službám.
Než začnete
Služba XML Application Service byla správně nakonfigurována.
| 1 |
Přejděte na webovou stránku správy telefonu. |
| 2 |
Vyberte možnost . |
| 3 |
Vyberte klávesu linky. |
| 4 |
Nastavením parametru Extension na hodnotu Zakázáno rozšíření zakážete. Pokud je zakázána funkce Direct PLK Configuration, musíte linku zakázat, chcete-li ke klíči linky přidat rozšířenou funkci. Pokud je funkce povolena, můžete tento krok přeskočit. Podrobnosti naleznete v části Povolení konfigurace Direct PLK. |
| 5 |
Do parametru Rozšířená funkce zadejte řetězec v tomto formátu: fnc=xml;url=<xml_app_path>; nme=<app_name>
kde
Příklad Tento parametr můžete také nakonfigurovat v konfiguračním souboru (cfg.xml). Zadejte řetězec v tomto formátu:
kde n označuje číslo linky. |
| 6 |
Klikněte na Uložit všechny změny. |
Proměnné maker podporované v XML adresách URL
V XML adresách URL můžete použít proměnné makra. Podporovány jsou následující proměnné maker:
-
ID uživatele – UID1, UID2 až UIDn
-
Zobrazovaný název – DISPLAYNAME1, DISPLAYNAME2 na DISPLAYNAMEn
-
ID ověření – AUTHID1, AUTHID2 na AUTHIDn
-
Proxy – PROXY1, PROXY2 na PROXYn
-
MAC Adresa pomocí malých hexadecimálních číslic – MA
-
Název produktu—PN
-
Číslo řady produktů – PSN
-
Sériové číslo – SERIAL_NUMBER
| Název makra | Rozšíření makra |
|---|---|
| $ | Formulář $$ se rozbalí na jeden znak $. |
| A až P | Nahrazeno obecnými parametry GPP_A až GPP_P. |
| SA až SD | Nahrazuje se obsahem parametrů pro zvláštní účel GPP_SA až GPP_SD. V těchto parametrech jsou uloženy klíče a hesla používaná při zřizování. $SA až $SD se považují za argumenty volitelného kvalifikátoru adresy URL resynchronizace, --key |
| MA | MAC adresu pomocí malých hexadecimálních číslic (000E08AABBCC). |
| MAU | MAC adresu pomocí hexadecimálních číslic velkých písmen (000E08AABBCC). |
| MAC | MAC adresu pomocí malých hexadecimálních číslic s dvojtečkou k oddělení hexadecimálních dvojic (00:0e:08:aa:bb:cc). |
| PN | Název produktu; například Video Phone 8875, Stolní telefon 9851. |
| PSN | číslo produktové řady; Například 8875, 9841, 9861 |
| SN | řetězec sériového čísla; například 88012BA01234. |
| CCERT | SSL stav klientského certifikátu, nainstalován nebo nenainstalován. |
| IP | IP adresu telefonu v místní podsíti, například 192.168.1.100. |
| EXTIP | Externí IP telefonu, jak je vidět na internetu; například 66.43.16.52. |
|
SWVER |
Řetězec verze softwaru. Například: PHONEOS.3-2-1-0104-37 |
|
HWVER |
Řetězec verze hardwaru. Například 2.0.1 |
|
PRVST |
Stav zřizování (číselný řetězec): -1 = explicitní požadavek na resynchronizaci 0 = resynchronizace při spuštění 1 = pravidelná resynchronizace 2 = resynchronizace se nezdařila, opakování pokusu |
|
UPGST |
Stav upgradu (číselný řetězec): 1 = první pokus o upgrade 2 = upgrade se nezdařil, opakování pokusu |
|
UPGERR |
Zpráva výsledku (ERR) předchozího pokusu o upgrade, například „nezdařilo se provést http_get“. |
|
PRVTMR |
Počet sekund od posledního pokusu o resynchronizaci. |
|
UPGTMR |
Počet sekund od posledního pokusu o upgrade. |
|
REGTMR1 |
Počet sekund od registrace ztráty linky 1 se serverem SIP. |
|
REGTMR2 |
Počet sekund od registrace ztráty linky 2 se serverem SIP. |
|
UPGCOND |
Starší název makra. |
|
SCHEME |
Protokol pro přístup k souboru, TFTP, HTTP nebo HTTPS, zjištěný po analýze adresy URL resynchronizace nebo upgradu. |
|
SERV |
Název hostitele serveru cíle požadavku zjištěný po analýze adresy URL resynchronizace nebo upgradu. |
|
SERVIP |
Adresa IP serveru cíle požadavku zjištěná po analýze adresy URL resynchronizace nebo upgradu, možná po zjištění na serveru DNS. |
|
PORT |
Port UDP/TCP cíle požadavku zjištěný po analýze adresy URL resynchronizace nebo upgradu. |
|
PATH |
Cesta k souboru cíle požadavku zjištěný po analýze adresy URL resynchronizace nebo upgradu. |
|
ERR |
Zpráva výsledku pokusu o resynchronizaci nebo upgrade. Hodí se pouze při generování zpráv syslog výsledku. Hodnota se v případě pokusů o upgrade uchovává v proměnné UPGERR. |
|
UIDn |
Obsah parametru konfigurace UserID linky n. |
| ISCUST |
Pokud je jednotka přizpůsobena, hodnota = 1, jinak 0. Stav vlastního nastavení je možné zobrazit na stránce Informace o webovém uživatelském rozhraní. |
| PŘÍCHOZÍ JMÉNO | Jméno spojené s prvním spojeným, vyzváněcím nebo příchozím hovorem. |
| VZDÁLENÉ ČÍSLO |
Telefonní číslo prvního spojeného, vyzvánějícího nebo příchozího hovoru. Pokud existuje více hovorů, jsou k dispozici data přidružená k prvnímu nalezenému hovoru. |
| DISPLAYNAMEn | Obsah konfiguračního parametru Zobrazovaný název řádku N. |
| AUTHIDn | Obsah konfiguračního parametru ID ověření řádku N. |
