概覽

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

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

支援的功能包括：

  • 訊息 (影像與文字)
  • 呼叫中

支援的 XML 物件

  • 思科 IP 電話功能表

  • CiscoIP 電話文字

  • CiscoIPPhoneInput

  • CiscoIP 電話目錄

  • Cisco IP 電話影像

  • CiscoIPPhone 影像檔案

  • CiscoIP 電話圖示功能表

  • CiscoIPPhoneIconFileMenu

  • CiscoIPPhoneStatus (9841 除外)

  • CiscoIPPhoneStatusFile (9841 除外)

  • CiscoIPPhoneExecute

支援的 URI

  • 裝置

  • 撥號

  • 編輯戴爾

  • 初始化

  • 按鍵

  • 播放 (僅限鈴聲)

  • 軟鍵

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

配置電話以連接至 XML 服務

1

存取電話管理網頁。

2

選擇語音 > 電話。

3

在 XML 服務 “部分中，配置 XML XML 服務的 參數中 定義的”應用程式服務名稱 “和 ”XML 應用程式服務 URL參數“。

4

（選用）若要添加用於訪問應用程式服務的身份驗證，請配置以下欄位： XML 使用者名、 XML 密碼、 CISCO XML EXE 啟用和 CISCO XML EXE 身份驗證模式。

5

按一下「 儲存所有變更」。

XML 服務的參數

下表定義了電話 Web 介面中「語音>電話」標籤下 XML 服務 」區段 中 XML 應用程式參數的功能和用法。 表格還界定了電話組態檔 (cfg.xml) 中所新增的字串語法，其中包含用於配置參數的 XML (cfg.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 或 HTTP 通訊協定。

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”>Local Credential</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>

其中 url 是存儲 XML 應用程式的連結; NME 是應用程式在電話螢幕上的顯示名稱。

範例 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>

其中 n 為軟鍵號碼。

5

按一下「 儲存所有變更」。

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

將常用應用程式添加到線路鍵，以便使用者輕鬆訪問服務。

開始之前

XML 應用程式服務已正確配置。

1

存取電話管理網頁。

2

選擇語音 > 電話。

3

選擇一個線路鍵。

4

將「擴展 」參數 設置為「已禁用」 以禁用擴展。

如果禁用了直接 PLK 配置功能，則必須禁用擴展才能向線路鍵添加擴展功能。 如果啟用了該功能，則可以跳過此步驟。 有關詳細資訊，請參閱 啟用直接 PLK 配置。
5

在擴展功能參數中輸入一個以下格式的字串：

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

其中 url 是存儲 XML 應用程式的連結; NME 是應用程式在電話螢幕上的顯示名稱。

範例 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_>

其中 n 是分機號碼。

6

按一下「 儲存所有變更」。

XML URL 中支援的宏變數

您可以在 XML URL 中使用巨集變數。 支援以下巨集變數：

  • 使用者 ID—UID1、UID2 至 UIDn

  • 顯示名稱 - DISPLAYNAME1，DISPLAYNAME2 到 DISPLAYNAMEn

  • 授權 ID—AUTHID1，AUTHID2 至 AUTHIDn

  • Proxy—PROXY1、PROXY2 至 PROXYn

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

  • 產品名稱—PN

  • 產品序列號—PSN

  • 序號 - SERIAL_NUMBER

表 2. 支援的巨集
宏名稱宏擴展
$形式 $$ 擴展為單個 $ 字元。
A 至 P替換為通用參數 GPP_A 到 GPP_P。
SA 至 SD替換為專用參數 GPP_SA 至 GPP_SD。 這些參數存有在佈建過程中使用的密鑰或密碼。
$SA 至 $SD 被認為是傳遞给可選重新同步 URL 限定符 — 密鑰 — 的參數。
MAMAC 使用小寫十六進位數字的位址 (000e08aabbcc)。
MAUMAC 使用大寫十六進位數字的位址 (000E08AABBCC)。
MACMAC 位址使用小寫十六進位數位和冒號分隔十六進位數位對 (00：0e：08：aa：bb：cc)。
PN產品名稱;例如視訊電話 8875、桌上型電話 9851。
PSN產品序列號;例如 8875、9841、9861
SN序列號字串;例如，88012BA01234。
CCERTSSL 客戶端證書狀態，已安裝或未安裝。
IPIP 電話本機子網路中的位址，例如 192.168.1.100。
EXTIP電話的外部 IP，如網際網路所顯示;例如，66.43.16.52。

SWVER

軟體版本字串。 例如：

電話.3-2-1-0104-37

HWVER

硬體版本字串。 例如 2.0.1

PRVST

佈建狀態 (數字字串)：

-1 = 明顯重新同步請求

0 = 接通電源時重新同步

1 = 定期重新同步

2 = 重新同步失敗，重試

UPGST

升級狀態 (數字字串)：

1 = 第一次升級嘗試

2 = 升級失敗，重試

UPGERR

上次升級嘗試的結果訊息 (錯誤)；例如，http_get 失敗。

PRVTMR

距離上次重新同步嘗試的秒數。

UPGTMR

距離上次升級嘗試的秒數。

REGTMR1

線路 1 遺失在 SIP 伺服器的註冊訊息後經歷的秒數。

REGTMR2

線路 2 遺失在 SIP 伺服器的註冊訊息後經歷的秒數。

UPGCOND

原來的宏指令名稱。

SCHEME

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

SERV

請求目標伺服器主機名稱，在剖析重新同步或升級 URL 後獲得。

SERVIP

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

PORT

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

PATH

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

ERR

重新同步或升級嘗試的結果訊息。 只有助於生成結果系統記錄訊息。 嘗試升級時，值將保留在 UPGERR 變數中。

UIDn

線路 n UserID 組態參數的內容。

伊斯庫斯特

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

自訂狀態可在 Web UI 資訊頁面上查看。

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

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

顯示名稱 n第 N 行顯示名稱配置參數的內容。
授權行 N 身份驗證 ID 配置參數的內容。