- Domů
- /
- Článek
Děkujeme za vaši zpětnou vazbu.
Konfigurace aplikací XML pro telefony ve službě 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 registrované ve službě Cisco BroadWorks. V tomto článku najdete podporované objekty XML, identifikátory URI a kroky 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 ke službám mají uživatelé přístup ke všem nakonfigurovaným službám v telefonu v nabídce . Služby Cisco XML jsou výchozí název. Název můžete také změnit. Chcete-li uživatelům poskytnout snadný přístup, můžete do softwarových tlačítek nebo tlačítek linky přidat aplikace XML.
Jsou podporovány tyto funkce:
- Zprávy (obrázky a text)
- Stránkování
Podporované objekty XML
-
Nabídka mikrofonu Cisco
-
Text mikrofonu Cisco
-
Vstup telefonu Cisco IPPhone
-
Adresář CiscoIPPhone
-
Obrázek telefonu Cisco IPPhone
-
SouborIPPhoneImageFileCisco
-
Nabídka Cisco IPPhoneIconMenu
-
Nabídka souboru Cisco IPPhoneIconFileMenu
-
Stav CiscoIPPhonePhonu (kromě 9841)
-
Soubor stavu CiscoIPPhoneStatusFile (kromě 9841)
-
Spuštění mikrofonu CiscoIPPhone
Podporované identifikátory URI
-
Zařízení
-
Volat
-
UpravitDail
-
Init
-
Klíč
-
Přehrát (pouze vyzváněcí tóny)
-
Softwarové tlačítko
Další informace o konfiguraci služby XSI naleznete v poznámkách k vývoji aplikace služeb Cisco Unified IP telefonu.
Konfigurace telefonu pro připojení ke službě XML
| 1 |
Přejděte na webovou stránku správy telefonu. |
| 2 |
Vyberte . |
| 3 |
V části Služba XML nakonfigurujte parametry XML Application Service Name a URL adresy XML Application Service tak, jak jsou definovány v části Parametry pro služby XML. |
| 4 |
(Volitelně) Chcete-li přidat ověření pro přístup ke službě aplikací, nakonfigurujte pole těchto polí: Uživatelské jméno XML, heslo XML, povolení CISCO XML EXE a režim ověření CISCO XML EXE. |
| 5 |
Klikněte na možnost Uložit všechny změny. |
Parametry pro služby XML
V následující tabulce je definována funkce 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 za účelem konfigurace parametru přidán do konfiguračního souboru telefonu (cfg.xml) s kódem XML.
|
Parametr |
Výchozí nastavení a možnosti |
Popis |
|---|---|---|
|
Název služby aplikace XML |
Výchozí nastavení: Prázdné |
Název aplikace XML. Název se zobrazí na telefonu jako volba webové aplikace. Tento parametr můžete nakonfigurovat také 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í nastavení: Prázdné |
Adresa URL, kde se nachází aplikace XML. Tento parametr můžete nakonfigurovat také 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ěnné makra podporované v adresách URL XML. V adrese URL jsou podporovány pouze protokoly HTTP nebo HTTPs. |
|
Uživatelské jméno XML |
Výchozí nastavení: Prázdné |
Uživatelské jméno služby XML pro účely ověřování. Tento parametr můžete nakonfigurovat také v konfiguračním souboru XML telefonu (cfg.xml) zadáním řetězce v tomto formátu: |
|
Heslo XML |
Výchozí nastavení: Prázdné |
Heslo služby XML pro zadané uživatelské jméno XML. Heslo zadané v tomto poli se v konfiguračním souboru (cfg.xml) zobrazí následujícím způsobem: |
|
Povolení EXE SOUBORU CISCO XML |
Výchozí nastavení: 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 nakonfigurovat také v konfiguračním souboru XML telefonu (cfg.xml) zadáním řetězce v tomto formátu: |
|
Režim OVĚŘENÍ EXE CISCO XML |
Výchozí nastavení: Místní přihlašovací údaje Možnosti: Důvěryhodné, místní přihlašovací údaje, vzdálené přihlašovací údaje |
Určuje režim ověřování pro soubor Cisco XML EXE.
Tento parametr můžete nakonfigurovat také 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ého tlačítka
Přidejte často používané aplikace do softwarových tlačítek, aby uživatelé měli snadný přístup ke službě.
Než začnete
Služba aplikace XML byla správně nakonfigurována.
| 1 |
Přejděte na webovou stránku správy telefonu. |
| 2 |
Vyberte . |
| 3 |
V části Programovatelná softwarová tlačítka nastavte možnost Programovatelná softwarová tlačítka povolena na hodnotu 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á tlačítka upravte dostupná pole od PSK1 do PSK16 v tomto formátu: fnc=xml;url=<xml_app_path>;nme=<app_name>
kde adresa URL je odkaz, kde je uložena aplikace XML; nme je zobrazovaný název aplikace na obrazovce telefonu.
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 možnost Uložit všechny změny. |
Přidání aplikace XML do klávesy linky
Přidejte často používané aplikace do tlačítek linky, aby uživatelé měli snadný přístup ke službám.
Než začnete
Služba aplikace XML byla správně nakonfigurována.
| 1 |
Přejděte na webovou stránku správy telefonu. |
| 2 |
Vyberte . |
| 3 |
Vyberte klávesu linky. |
| 4 |
Nastavením parametru Linka na hodnotu Zakázáno rozšíření zakážete. Pokud je funkce přímé konfigurace PLK zakázána, musíte linku zakázat, chcete-li přidat rozšířenou funkci ke klávese linky. Pokud je funkce povolena, tento krok můžete přeskočit. Podrobnosti najdete v tématu Povolení přímé konfigurace PLK. |
| 5 |
V parametru Rozšířená funkce zadejte řetězec v tomto formátu: fnc=xml;url=<xml_app_path>;nme=<app_name>
kde adresa URL je odkaz, kde je uložena aplikace XML; nme je zobrazovaný název aplikace na obrazovce telefonu.
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 linky. |
| 6 |
Klikněte na možnost Uložit všechny změny. |
Proměnné makra podporované v adresách URL XML
V adresách URL XML můžete použít proměnné makra. Podporovány jsou následující proměnné maker:
-
Uživatelské ID – UID1, UID2 na UIDn
-
Zobrazované jméno – DISPLAYNAME1, DISPLAYNAME2 až DISPLAYNAMEn
-
ID autorizace – AUTHID1, AUTHID2 na AUTHIDn
-
Proxy – PROXY1, PROXY2 na PROXYn
-
Adresa MAC v malých šestnáctkových číslech – MA
-
Název produktu – PN
-
Číslo řady produktu – PSN
-
Sériové číslo – SÉRIOVÉ_ČÍSLO
| Název makra | Rozšíření makra |
|---|---|
| $ | Zápis $$ se rozšíří na jeden znak $. |
| A až P | Nahrazuje se obecnými parametry GPP_A až GPP_P. |
| SA až SD | Nahrazuje se parametry 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 |
| Moje | Adresa MAC v malých šestnáctkových číslech (000e08aabbcc) |
| MAU | Adresa MAC v malých šestnáctkových číslech (000E08AABBCC). |
| Počítač | Adresa MAC pomocí malých šestnáctkových číslic se středníkem oddělujících páry šestnáctkových číslic (00:0e:08:aa:bb:cc). |
| PN | Název produktu, například videotelefon 8875, stolní telefon 9851. |
| PSN | Číslo řady produktu, například 8875, 9841, 9861 |
| sn | Řetězec sériového čísla, například 88012BA01234. |
| Skřítek | Stav klientského certifikátu SSL, nainstalovaný, nebo nenainstalovaný. |
| IP | Adresa IP telefonu v místní podsíti, například 192.168.1.100. |
| Extip | Externí adresa IP telefonu, jak je vidět na internetu; například 66.43.16.52. |
|
Houpačka |
Řetězec verze softwaru. Příklad: telefonní systémy.3-2-1-0104-37 |
|
hwver |
Řetězec verze hardwaru. Například 2.0.1 |
|
první |
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 |
|
nahoru |
Stav upgradu (číselný řetězec): 1 = první pokus o upgrade 2 = upgrade se nezdařil, opakování pokusu |
|
Vyšší |
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. |
|
Schéma |
Protokol pro přístup k souboru, TFTP, HTTP nebo HTTPS, zjištěný po analýze adresy URL resynchronizace nebo upgradu. |
|
Servírování |
Název hostitele serveru cíle požadavku zjištěný po analýze adresy URL resynchronizace nebo upgradu. |
|
Šotek |
Adresa IP serveru cíle požadavku zjištěná po analýze adresy URL resynchronizace nebo upgradu, možná po vyhledání v serveru DNS. |
|
Port |
Port UDP/TCP cíle požadavku zjištěný po analýze adresy URL resynchronizace nebo upgradu. |
|
Cesta |
Cesta k souboru cíle požadavku zjištěný po analýze adresy URL resynchronizace nebo upgradu. |
|
Chyba |
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. |
|
Číslo UID |
Obsah parametru konfigurace UserID linky n. |
| Iscust (rozcestník) |
Pokud je jednotka přizpůsobena, value=1, jinak 0. Stav přizpůsobení lze zobrazit na stránce Informace o webovém uživatelském rozhraní. |
| jméno příchozího kontaktu | Jméno spojené s prvním připojeným, vyzvánějícím nebo příchozím hovorem. |
| vzdálené číslo |
Telefonní číslo prvního připojeného, vyzvánějícího nebo příchozího hovoru. Pokud existuje více hovorů, jsou poskytnuty údaje přidružené k prvnímu nalezenému hovoru. |
| Zobrazované JMÉNO | Obsah parametru konfigurace názvu zobrazení linky N. |
| Číslo AUTHID | Obsah parametru konfigurace ID ověření linky N. |
