简介
本文档介绍通过包联系中心企业版(PCCE)单一管理窗格(SPOG)命令执行窗格发送应用编程接口(API)请求的步骤。
作者:Ramiro Amaya和Anuj Bhatia,思科TAC工程师和Shilpa Jayashekar,思科工程。
先决条件
要求
思科建议您了解 思科产品包联系中心企业版
使用的组件
本文档中使用的信息基于PCCE 12.5(1)版本。
本文档中的信息都是基于特定实验室环境中的设备编写的。本文档中使用的所有设备最初均采用原始(默认)配置。如果您的网络处于活动状态,请确保您了解任何步骤的潜在影响。
背景信息
命令执行窗格在统一联系中心企业版(CCE)管理中提供REST客户端界面。此窗格允许系统管理员:
- 从统一CCE管理的单个界面执行对统一客户语音门户(CVP)、统一CVP报告和思科虚拟化语音浏览器(CVB)的REST API调用。
- 配置Packaged CCE最新版本中提供的客户虚拟助理(CVA)等功能,无需升级Packaged CCE组件。例如,如果VVB升级到12.5,则CVA功能(在12.5中提供)可通过使用命令执行窗格从Packaged CCE 12.0 ES 37进行配置。
配置
只有系统管理员有权访问命令执行窗格。
以系统管理员身份登录时,可以从Infrastructure Settings(Card)> Command Execution Pane访问Command Execution窗格。
注意:系统管理员是有权访问所有功能的角色。在CCE管理中,选择用户>角色>系统管理(分配了此角色的管理员可以访问所有功能和子功能)
本页包含两个部分:请求和响应。
请求部分
“请求”部分包含以下属性:
1.机器类型: 用户要执行API请求的计算机类型。
2.地点:必须执行API的站点。选择计算机类型时,默认情况下会选择所有站点。
3.主机:必须执行API的主机。默认情况下,所有主机都处于选中状态。 如果没有可用主机,将显示相应消息。
4.方法:选择的方法:GET、POST、PUT和DELETE是选项。
5.路径:要执行的API的相对路径。
6.请求正文:此处是API请求的负载。目前支持的内容类型为JSON。
注意:对于POST和PUT,请求正文为必填项。
7.内容类型:支持JSON和XML内容类型。
8.响应类型:选择预期响应的类型。默认值为JSON。XML是另一个选项。
9.执行:执行请求。填写所有必填字段后,即会启用该字段。
响应部分
“响应”部分包含以下属性:
1.结果筛选:过滤结果以查看成功或失败响应。
2.结果详情:它包含主机名列表和所选主机名的响应。
3.重置:这会将屏幕上的所有属性重置为默认值。
验证
您可以使用这些示例验证命令执行窗格的结果。
示例 1:在Cisco VVB上创建服务帐户
填写如图所示的请求参数,然后点击执行。
示例 2:获取在示例1中创建的Cisco VVB上的服务帐户
填写请求参数,如图所示。然后点击Execute。您应获得如图所示的成功响应。
路径:speehconfig/rest/config/tts/serviceaccount/newServiceaccount。
示例 3:在示例1中创建的Cisco VVB上更新服务帐户
填写请求参数,如图所示。然后点击Execute。
路径 — speechconfig/rest/config/tts/serviceaccount/newServiceaccount。
注意:此API PUT请求中更新了描述
示例 4:删除在示例1中创建的Cisco VVB上的服务帐户
填写请求参数,如图所示。然后点击Execute。
路径 — speechconfig/rest/config/tts/serviceaccount/newServiceaccount。
故障排除
需要Tomcat日志c:\icm\tomcat\logs\CCBU。<timestamp>来排除来自SPOG中“命令执行”窗格的任何API请求故障。
相关信息
PCCE管理指南
技术支持和文档 - Cisco Systems