概觀

XML服務介面 (XSI) 是一種允許應用程式與電話系統之間通訊的通訊協定。 您可以使用受支援的XML物件和 URI 將您自己的 XSI 服務新增至電話。

在電話訂閱服務後，使用者可以透過導覽至來存取電話上的所有已設定服務。設定>網路和服務> Cisco XML服務。 Cisco XML Services 是預設名稱。 您也可以變更名稱。 為了方便使用者存取，您可以將XML應用程式新增至軟鍵或線路鍵。

支援的功能包括：

  • 訊息（影像和文字）
  • 傳呼

支援的XML物件

  • CiscoIP電話功能表

  • Cisco IP 電話文字

  • CiscoIP電話輸入

  • CiscoIP電話目錄

  • CiscoIPPhoneImage

  • CiscoIPPhone影像檔案

  • CiscoIP電話圖示功能表

  • CiscoIP電話圖示檔案功能表

  • CiscoIPPhone狀態（9841 除外）

  • CiscoIPPhone狀態檔案（9841 除外）

  • CiscoIP電話執行

支援的 URI

  • 裝置

  • 撥打

  • 每日編輯

  • 初始化

  • 金鑰

  • 播放（僅適用於鈴聲）

  • 軟鍵

有關 XSI 服務設定的更多詳細資訊，請參閱Cisco Unified IP Phone Services 應用程式開發說明。

設定電話以連線至XML服務

1

存取電話管理網頁。

2

選取語音>電話。

3

在XML服務區段，設定XML應用程式服務名稱和XML應用程式服務URL中定義的參數XML服務的參數。

4

（可選）若要新增用於存取應用程式服務的驗證，請設定這些欄位： XML使用者名稱， XML密碼， CISCO XML EXE 啟用，和CISCO XML EXE 驗證模式。

5

按一下儲存所有變更。

XML服務的參數

下表定義了 中XML應用程式參數的功能和用法XML服務區段下的語音>電話電話Web 介面中的標籤。 它還會定義電話組態檔 ( XML ) 中新增的字串的語法，以配置參數。

表 1. XML服務的參數

參數

預設與選項

說明

XML應用程式服務名稱

預設值： 空

XML應用程式的名稱。 該名稱在電話上顯示為一個Web 應用程式選項。

您還可以在電話組態XML 檔案(cfg.xml) 中透過輸入以下格式的字串來配置此參數：

<XML_Application_Service_Name ua="na">XML應用程式名稱</XML_Application_Service_Name>

XML應用程式服務URL

預設值： 空

XML應用程式所在的URL 。

您還可以在電話組態XML 檔案(cfg.xml) 中透過輸入以下格式的字串來配置此參數：

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

XML URL 支援宏變數。 有關有效的宏變數，請參閱XML URL 中支援的宏變數。

URL中僅支援 HTTP 或 HTTPS 通訊協定。

XML使用者名稱

預設值： 空

用於驗證的XML服務使用者名稱。

您還可以在電話組態XML 檔案(cfg.xml) 中透過輸入以下格式的字串來配置此參數：

<XML_User_Name ua="na">使用者名稱</XML_User_Name>

XML密碼

預設值： 空

指定的XML使用者名稱的XML服務密碼。

您在此欄位中輸入的密碼在組態檔(cfg.xml) 中顯示如下：

<!-- <XML_Password ua="na">*************</XML_Password> -->

CISCO XML EXE 啟用

預設值： 否

選項： 是，否

指定存取XML應用程式伺服器是否需要驗證。

您還可以在電話組態XML 檔案(cfg.xml) 中透過輸入以下格式的字串來配置此參數：

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

CISCO XML EXE 驗證模式

預設值： 本地憑證

選項： 受信任, 本端認證, 遠端認證

指定Cisco XML EXE 的驗證模式。

  • 受信任 - 無論本地憑證如何，都不執行驗證。

  • 本端憑證 — 驗證是根據使用本地憑證（若已設定）的摘要式驗證進行。 若未設定本端憑證，則不會執行任何驗證。

  • 遠程認證 — 驗證是根據使用網頁的XML應用程式所設定的遠程認證的摘要式驗證進行 (用以存取XML應用程式伺服器)。

您還可以在電話組態XML 檔案(cfg.xml) 中透過輸入以下格式的字串來配置此參數：

<CISCO_XML_EXE_Auth_Mode ua="na">本地憑證</CISCO_XML_EXE_Auth_Mode>

將XML應用程式新增至軟鍵

將常用的應用程式新增至軟鍵，使使用者能夠輕鬆地存取服務。

準備工作

XML應用程式服務已正確設定。

1

存取電話管理網頁。

2

選取語音>電話。

3

在可編程軟鍵區段中，設定可編程軟鍵啟用至是。

您還可以在組態檔(cfg.xml) 中配置此參數。 以下列格式輸入字串：

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

在可編程軟鍵部分，編輯的可用欄位PSK1至PSK16採用以下格式：

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

在哪裡網址是儲存XML應用程式的鏈結；嚗是應用程式在電話螢幕上的顯示名稱。

範例 fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu

您還可以在組態檔(cfg.xml) 中配置此參數。 以下列格式輸入字串：

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

在哪裡甈是軟鍵號碼。

5

按一下儲存所有變更。

將XML應用程式新增至線路鍵

將常用的應用程式新增至線路鍵，讓使用者能夠輕鬆存取服務。

準備工作

XML應用程式服務已正確設定。

1

存取電話管理網頁。

2

選取語音>電話。

3

選取線路鍵。

4

設定分機參數為已停用以停用擴充功能。

如果「直接 PLK 設定」功能被停用，您必須停用擴充功能，才能將擴充功能新增至線路鍵。 如果已啟用該功能，您可以跳過此步驟。 有關詳細資訊，請參閱啟用 Direct PLK 設定。
5

在擴充功能參數，請採用以下格式輸入字串：

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

在哪裡網址是儲存XML應用程式的鏈結；嚗是應用程式在電話螢幕上的顯示名稱。

範例 fnc=xml;url=http://10.77.21.37/xmlapp/menu.xml;nme=Menu

您還可以在組態檔(cfg.xml) 中配置此參數。 以下列格式輸入字串：

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

在哪裡甈是分機號碼。

6

按一下儲存所有變更。

XML URL 中支援的宏變數

您可以在XML URL 中使用 macro 變數。 支援下列宏變數：

  • 使用者ID— UID1、UID2 到 UIDn

  • 顯示名稱 — DISPLAYNAME1，DISPLAYNAME2 到 DISPLAYNAMEn

  • 驗證 ID— AUTHID1、AUTHID2 至 AUTHIDn

  • Proxy — PROXY1、PROXY2 到 PROXYn

  • 使用小寫十六進制數字的MAC位址 — MA

  • 產品名稱 — PN

  • 產品系列號 — PSN

  • 序列號 — SERIAL_NUMBER

表格 2. 支援的 macros
宏名稱宏擴充
$表格 $$ 會擴充為單個 $ 字元。
A 到 P已被通用參數 GPP_A 到 GPP_P 取代。
SA 到 SD已由特殊用途參數 GPP_SA 到 GPP_SD 取代。 這些參數包含佈建中使用的金鑰或密碼。
$SA 到 $SD 被識別為可選重新同步URL限定詞 --key 的參數。
MA使用小寫十六進制數字 (000e08aabbcc) 的MAC 位址。
MAU使用大寫十六進制數字的MAC 位址(000E08AABBCC)。
MACMAC 位址使用小寫的十六進制數字和冒號來分隔十六進制數字對 (00:0e:08:aa:bb:cc)。
PN產品名稱；例如，視訊電話 8875、桌面電話 9851。
PSN產品系列號；例如 8875、9841、9861
SN序號字串；例如 88012BA01234。
CCERTSSL用戶端憑證狀態，已安裝或未安裝。
IP電話本地子網的IP 位址；例如 192.168.1.100。
EXTIP電話的外部IP ，如互聯網上所看到的；例如 66.43.16.52。

SWVER

軟體版本字串。 例如：

PHONEOS.3-2-1-0104-37

硬體

硬體版本字串。 例如 2.0.1

PRVST

佈建狀態（數字字串）：

-1 = 明確的重新同步要求

0 = 啟動時重新同步

1 = 定期重新同步

2 = 重新同步失敗，重試嘗試

UPGST

升級狀態（數字字串）：

1 = 第一次嘗試升級

2 = 升級失敗，請重試

UPGERR

先前升級嘗試的結果訊息（ERR）；例如 http_get 失敗。

PRVMR

自上次嘗試重新同步以來的秒數。

UPGTMR

自上次嘗試升級以來的秒數。

REGTMR1

自線路 1 失去與SIP伺服器的註冊以來的秒數。

REGTMR2

自線路 2 丟失SIP伺服器註冊以來的秒數。

UPGCOND

舊版巨集名稱。

計劃

檔案存取方案， TFTP，HTTP 或 HTTPS 之一，在解析重新同步或升級URL後獲得。

SERV

解析重新同步或升級URL後獲得的請求目標伺服器主持人名稱。

服務

請求目標伺服器 IP位址（在剖析重新同步或升級URL後）（可能在DNS查找之後）。

埠

解析重新同步或升級URL後獲得的請求目標UDP/ TCP 連接埠。

路徑

請求目標檔案路徑，如在剖析重新同步或升級URL後獲得的。

錯誤

重新同步或升級嘗試的結果訊息。 僅在產生結果 syslog 訊息時有用。 當嘗試升級時，該值將保留在 UPGERR 變數中。

UIDn

「線路 n 使用者 ID」組態參數的內容。

ISCUST

如果單位是自訂的，則值 = 1，否則為 0。

自訂狀態可在網路 UI 資訊頁上檢視。

傳入名稱與第一個連線、第一個響鈴或傳入通話關聯的名稱。
遠端號碼

第一個連線、響鈴或傳入通話的電話號碼。 如果有多路通話，則會提供與找到的第一個通話關聯的資料。

顯示名稱n「線路 N 顯示名稱」組態參數的內容。
AUTHIDn「線路 N 驗證ID 」組態參數的內容。