概述

XML服务接口(XSI)是一种允许应用程序和电话系统之间进行通信的协议。 您可以使用支持的XML对象和URI将自己的XSI服务添加到您的手机。

将电话订阅服务后，用户可以通过导航至设置 > 网络和服务 > Cisco XML服务来访问电话上的所有配置服务。 Cisco XML服务是默认名称。 您还可以更改名称。 为了便于用户访问，您可以将XML应用程序添加到软键或线路键中。

支持的功能包括：

  • 消息（图像和文本）
  • 分页

支持的XML对象

  • CiscoIPPhoneMenu

  • CiscoIPPhoneText

  • CiscoIPPhoneInput

  • CiscoIPPhoneDirectory

  • CiscoIPPhoneImage

  • CiscoIPPhoneImageFile

  • CiscoIPPhoneIconMenu

  • CiscoIPPhoneIconFileMenu

  • CiscoIPPhoneStatus（9841除外）

  • CiscoIPPhoneStatusFile（9841除外）

  • Cisco IPPhoneExecute

支持的URI

  • 设备

  • 拨打

  • 编辑Dail

  • 因尼特

  • 密钥

  • 播放（仅限铃声）

  • 软键

有关XSI服务配置的更多详细信息，请参阅 Cisco Unified IP电话服务应用程序开发说明。

配置电话连接到XML服务

1

访问电话管理网页。

2

选择语音 > 电话。

3

在 XML服务部分中，配置XML服务参数中定义的XML应用程序服务名称和XML应用程序服务URL参数。

4

（可选）要为访问应用程序服务添加身份验证，请配置以下字段： XML用户名、XML密码、CISCO XML EXE启用和 CISCO XML EXE Auth模式。

5

单击保存所有更改。

XML服务的参数

下表定义了电话网络接口中的 语音 > 电话选项卡下的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">;*************&lt；/XML_Password> -->

Cisco XML EXE启用

默认： 不支持

选项： 是，否

指定是否需要身份验证才能访问XML应用程序服务器。

您还可以通过在此格式输入字符串，在电话配置XML文件(cfg.xml)中配置此参数：

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

CISCO XML EXE Auth模式

默认： 本地凭证

选项： 可信的、本地凭证、远程凭证

指定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>

其中url是XML应用程序存储的链接；nme是电话屏幕上的应用程序的显示名称。

示例 fnc=xml；url=http：//10.77.21.37/xmlapp/menu.xml；nme=菜单

您还可以在配置文件(cfg.xml)中配置此参数。 在此格式中输入字符串：

<PSK_n ua="na">fnc=xml；url=http：//10.77.21.37/xmlapp/menu.xml；nme=菜单<配置代码></PSK_n>

其中n是软键号码。

5

单击保存所有更改。

将XML应用程序添加到行键中

将常用应用程序添加到行键中，以便用户轻松访问服务。

准备工作

XML应用程序服务已正确配置。

1

访问电话管理网页。

2

选择语音 > 电话。

3

选择行键。

4

将扩展名参数设置为禁用以禁用扩展名。

如果禁用了Direct 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=菜单

您还可以在配置文件(cfg.xml)中配置此参数。 在此格式中输入字符串：

<Extended_Function_n_ ua="na">fnc=xml；url=http：//10.77.21.37/xmlapp/menu.xml；nme=菜单<配置代码></Extended_Function_n_>

其中n是分机号码。

6

单击保存所有更改。

在XML URL中支持的宏变量

您可以在XML URL中使用宏变量。 支持以下宏变量：

  • 用户ID - UID1、UID2到UIDn

  • 显示名称- <UNK> NAME1、<UNK> NAME2到<UNK> NAMEn

  • Auth ID — AUTHID1、AUTHID2到AUTHIDn

  • 代理—PROXY1、PROXY2到PROXYn

  • 使用小写十六进制数字的MAC地址—MA

  • 产品名称- PN

  • 产品系列编号- PSN

  • 序列号—序列号

表 2. 支持的宏
宏名称宏扩展
$$$格式扩展为单个$字符。
A到P由通用参数GPP_A通过GPP_P代替。
SA至SD由GPP_SA通过GPP_SD替换为特殊目的参数。 这些参数保留配置中使用的密钥或密码。
$SA到$SD被识别为可选重同步URL限定符--键的参数。
MA使用小写十六位数字的MAC地址(000e08aabbcc)。
MAU使用大写十六位数字的MAC地址(000E08AABBCC)。
MACMAC地址使用小写十六位数字和结肠分隔十六位数对(00：0e：08：aa：bb：cc)。
pn产品名称；例如，视频电话8875、办公电话9851。
psn产品系列编号；例如：8875、9841、9861
sn序列号字符串；例如，88012BA01234。
CCERT的SSL客户端证书状态，已安装或未安装。
IP本地子网中的电话的IP地址；例如，192.168.1.100。
外部电话的外部IP，如在互联网上看到的；例如，66.43.16.52。

斯沃尔

软件版本字符串。 例如，

phoneos.3-2-1-0104-37

hwver

硬件版本字符串。 例如，2.0.1

普韦斯特

配置状态（数字字符串）：

-1 =显式重同步请求

0 =加电重新同步

1 =定期重新同步

2 =重新同步失败，重试

升级

升级状态（数字字符串）：

1 =首次升级尝试

2 =升级失败，重试

上传

上次升级尝试的结果消息(ERR)；例如http_get失败。

Prvtmr

上次重新同步后秒数。

Upgtmr

自上次升级尝试以来的秒数。

regtmr1

自Line 1丢失使用SIP服务器注册以来的秒数。

regtmr2

自Line 2丢失使用SIP服务器注册以来的秒数。

upgcond

遗留宏名称。

方案

文件访问方案，TFTP、HTTP或HTTPS，在解析重同步或升级URL后获得的。

塞尔维亚

请求目标服务器主机名，在解析重同步或升级URL后获得的。

服务

请求目标服务器IP地址，在解析重同步或升级URL后获得，可能在DNS查找后获得。

端口

请求目标UDP/TCP端口，如解析重同步或升级URL后获得的。

路径

请求目标文件路径，如解析重同步或升级URL后获得的。

错误

重新同步或升级尝试的结果消息。 仅用于生成结果系统日志消息。 在尝试升级时，该值保留在UPGERR变量中。

用户名

Line n UserID配置参数的内容。

伊斯卡斯特

如果单位是自定义，则值为1，否则0。

可在Web UI Info页面上查看自定义状态。

收件人名与首次连接、铃声或入站呼叫关联的名称。
遥控器

首次连接、铃声或入站呼叫的电话号码。 如果有多个呼叫，将提供与找到的第一个呼叫关联的数据。

<UNK>名称行N显示名称配置参数的内容。
授权文件Line N auth ID配置参数的内容。