- Domů
- /
- Článek
Děkujeme za vaši zpětnou vazbu.
Konfigurace aplikací XML pro telefony 9800 a 8875 (BroadWorks)
V tomto článku
Zpětná vazba?Tento článek nápovědy se vztahuje na stolní telefony Cisco řady 9800 a Cisco Video Phone 8875, které jsou registrovány v Cisco BroadWorks. Přečtěte si tento článek o podporovaných objektech XML, URI a postupech pro konfiguraci 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. Pomocí podporovaných objektů XML a URI můžete do telefonu přidat vlastní služby XSI.
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 přechodem do . Výchozí název je Cisco XML Services. Můžete také změnit název. Chcete-li uživatelům poskytnout snadný přístup, můžete přidat aplikace XML do softwarových kláves nebo řádkových kláves.
Podporované funkce jsou:
- Zprávy (obrázky a text)
- Stránkování
Podporované objekty XML
-
CiscoIpPhoneMenu
-
CiscoIPPhoneText
-
CiscoIPPhoneVstup
-
CiscoIPPhoneAdresář
-
CiscoIPPhoneObrázek
-
CiscoIPPhoneImageSoubor
-
CiscoIPPhoneIconMenu
-
CiscoIPPhoneIconFileMenu
-
CiscoIPPhoneStatus (kromě 9811 a 9841)
-
CiscoIPPhoneStatusFile (kromě 9811 a 9841)
-
CiscoIPPhoneExecute
Podporované adresy URI
-
Přístroj
-
Číselník
-
EditDail
-
Init
-
Klíč
-
Přehrát (pouze vyzváněcí tóny)
-
Softwarové klávesy
Další podrobnosti o konfiguraci služby XSI naleznete v tématu Poznámky k vývoji aplikací Cisco Unified IP Phone Services.
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 Služba XML nakonfigurujte parametry Název služby aplikace XML a URL služby aplikace XML, jak jsou definovány v části Parametry pro služby XML. |
| 4 |
(Volitelné) Chcete-li přidat ověřování pro přístup k aplikační službě, nakonfigurujte tato pole: Uživatelské jméno XML, Heslo XML, Povolit CISCO XML EXE a Rež im ověřování CISCO XML EXE. |
| 5 |
Klepněte na tlačítko Uložit všechny změny. |
Parametry pro služby XML
Následující tabulka definuje funkci a použití parametrů aplikace XML v části Služba XML na kartě 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 pro konfiguraci parametru.
|
Parametr |
Výchozí nastavení a možnosti |
Popis |
|---|---|---|
|
Název služby aplikace XML |
Výchozí: Prázdné |
Název aplikace XML. Název se zobrazí v telefonu jako volba webové aplikace. Tento parametr můžete také nakonfigurovat v konfiguračním souboru XML telefonu (cfg.xml) zadáním řetězce v tomto formátu: |
|
Adresa URL služby aplikace XML |
Výchozí: Prázdné |
Adresa URL, kde se nachází aplikace XML. Tento parametr můžete také nakonfigurovat v konfiguračním souboru XML telefonu (cfg.xml) zadáním řetězce v tomto formátu: Proměnné makra jsou podporovány v adresách URL XML. Platné proměnné makra najdete v tématu Proměn né makra podporované v adresách URL XML. V URL jsou podporovány pouze protokoly HTTP nebo HTTPS. |
|
Uživatelské jméno XML |
Výchozí: Prázdné |
Uživatelské jméno služby XML pro účely ověřování. Tento parametr můžete také nakonfigurovat v konfiguračním souboru XML telefonu (cfg.xml) zadáním řetězce v tomto formátu: |
|
XML heslo |
Výchozí: Prázdné |
Heslo služby XML pro zadané uživatelské jméno XML. Heslo, které jste zadali v tomto poli, se v konfiguračním souboru (cfg.xml) zobrazí následovně: |
|
CISCO XML EXE Povolit |
Výchozí: Ne Možnosti: Ano, Ne |
Určuje, zda je pro přístup k aplikačnímu serveru XML vyžadováno ověření. Tento parametr můžete také nakonfigurovat v konfiguračním souboru XML telefonu (cfg.xml) zadáním řetězce v tomto formátu: |
|
Režim autorizace CISCO XML EXE |
Výchozí: 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 konfiguračním souboru XML telefonu (cfg.xml) zadáním řetězce v tomto formátu: |
Přidání aplikace XML do softwarové klávesy
Přidejte často používané aplikace do softwarových kláves, aby uživatelé mohli snadno přistupovat 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áves y nastavte možnost Povolit programovatelné klávesy 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é klávesy upravte dostupná pole PSK1 na 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 klávesové klávesy. |
| 5 |
Klepněte na tlačítko Uložit všechny změny. |
Přidání aplikace XML do klíče řádku
Přidejte často používané aplikace do řádkových kláves, aby uživatelé mohli snadno přistupovat 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 čárový klíč. |
| 4 |
Chcete-li rozšíření deaktivovat, nastavte parametr Rozšíření na hodnotu Zakázáno. Pokud je funkce Přímá konfigurace PLK zakázána, je nutné rozšíření zakázat, abyste přidali rozšířenou funkci do klávesy řádky. Pokud je tato funkce povolena, můžete tento krok přeskočit. Podrobnosti viz Pov olit přímou konfiguraci PLK. |
| 5 |
V parametru Extended Func tion 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 je číslo rozšíření. |
| 6 |
Klepněte na tlačítko Uložit všechny změny. |
Proměnné makra podporované v adresách URL XML
Proměnné makra můžete použít v adresách URL XML. Podporovány jsou následující proměnné makra:
-
ID uživatele-UID1, UID2 na UIDn
-
Zobrazovaný název — DisplayName1, DISPLAYNAME2 na DisplayNamen
-
Auth ID — AUTHID1, AUTHID2 na AuthIDN
-
Proxy—Proxy1, PROXY2 na ProxyN
-
MAC adresa pomocí malých šestihranných číslic — MA
-
Název produktu—PN
-
Číslo produktové řady — PSN
-
Sériové číslo — sériové číslo
| Název makra | Rozšíření makra |
|---|---|
| $ | Formulář $$ se rozšíří na jeden znak $. |
| A až P | Nahrazeno obecnými parametry GPP_A přes GPP_P. |
| SA přes SD | Nahrazeno speciálními parametry GPP_SA přes GPP_SD. Tyto parametry obsahují
klíče nebo hesla použitá při zajišťování. $SA až $SD jsou rozpoznány jako argumenty volitelného kvalifikátoru URL resync, --key. |
| MA | MAC adresa s malými hexadecimálními číslicemi (000e08aabbcc). |
| MAU | MAC adresa pomocí velkých šestihranných číslic (000E08AABBCC). |
| MAC | MAC adresa pomocí malých šestihranných číslic s dvojtečkou k oddělení dvojic hexadecimálních číslic (00:0 e: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 | Stav certifikátu klienta SSL, nainstalovaný nebo nenainstalovaný. |
| IP | IP adresa 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 opětovnou synchronizaci 0 = opětovná synchronizace zapnutí 1 = periodická resynchronizace 2 = opětovná synchronizace selhala, pokus o opakování |
|
UPGST |
Stav upgradu (číselný řetězec): 1 = první pokus o upgrade 2 = upgrade se nezdařil, pokus o opakování |
|
UPGERR |
Zpráva o výsledku (ERR) předchozího pokusu o upgrade; například http_get selhal. |
|
PRVTMR |
Sekundy od posledního pokusu o synchronizaci. |
|
UPGTMR |
Sekundy od posledního pokusu o upgrade. |
|
REGTMR1 |
Sekundy od chvíle, kdy řádek 1 ztratil registraci na SIP serveru. |
|
REGTMR2 |
Sekundy od ztráty registrace na SIP serveru Line 2. |
|
UPGCOND |
Název staršího makra. |
|
SCHEME |
Schéma přístupu k souborům, jedno z TFTP, HTTP nebo HTTPS, získané po analýze resynchronizace nebo upgradu adresy URL. |
|
SERV |
Vyžádejte si název hostitele cílového serveru, jak je získáno po analýze adresy URL resynchronizace nebo upgradu. |
|
SERVIP |
Vyžádejte si IP adresu cílového serveru, jak je získána po analýze adresy URL resynchronizace nebo upgradu, případně po vyhledání DNS. |
|
PORT |
Vyžádejte si cílový port UDP/TCP, jak je získáno po analýze adresy URL resync nebo upgradu. |
|
PATH |
Vyžádejte si cestu k cílovému souboru, jak je získáno po analýze adresy URL resynchronizace nebo upgradu. |
|
ERR |
Zpráva o výsledku pokusu o opětovnou synchronizaci nebo upgrade. Užitečné pouze při generování výsledků syslog zpráv. Hodnota je zachována v proměnné UPGERR v případě pokusů o upgrade. |
|
UIDn |
Obsah konfiguračního parametru Line n UserId. |
| ISCUST |
Pokud je jednotka přizpůsobena, hodnota = 1, jinak 0. Stav přizpůsobení lze zobrazit na stránce Informace o webovém uživatelském rozhraní. |
| INCOMINGNAME | Název přiřazený k prvnímu připojenému, vyzváněcímu nebo příchozímu hovoru. |
| REMOTENUMBER |
Telefonní číslo prvního připojeného, vyzváněcího nebo příchozího hovoru. Pokud existuje více hovorů, jsou poskytnuta data spojená s prvním nalezeným hovorem. |
| DisplayNamen | Obsah konfiguračního parametru Zobrazovaný název řádku N. |
| AuthenticIDN | Obsah konfiguračního parametru ID autentizace řádku N. |
