使用第三方小工具在Cisco Finesse中配置CUIC历史报告小工具

简介

本文档介绍在Finesse上配置历史报告小工具的步骤，因为默认设置仅包括Finesse Agent/Supervisor Desktop中的实时数据小工具。

先决条件

要求

Cisco 建议您了解以下主题：

• 思科统一联系中心快捷版(UCCX)
• 思科统一情报中心(CUIC)
• Finesse管理
• Finesse桌面

使用的组件

本文档中的信息基于以下软件和硬件版本：

• UCCX版本12.5
• CUIC版本12.5
• Finesse版本12.5
• 菲莱齐拉

本文档中的信息都是基于特定实验室环境中的设备编写的。本文档中使用的所有设备最初均采用原始（默认）配置。如果您的网络处于活动状态，请确保您了解所有命令的潜在影响。

配置

在Finesse上启用历史报告的过程。

下面概述了在Finesse平台上启用历史报表功能的逐步说明：

1.在CUIC中创建自定义报告。

导航至CUIC页面。 点击  Reports > Stock > Unified CCX Historical > Inbound. 选择  Agent Detail Report 如图所示.

保存座席状态详细数据报告的副本

在  Actions  选项卡，选择  Save As  并为报告命名。例如，  Agent Detail Report - Test  并将其保存在  Reports  如图所示.

保存座席详细数据报告

2.向用户添加权限。

导航至  Reports  并选择  Agent Detail Report - Test  并添加权限。在  Actions  选项卡，选择  Permissions - All Users/Supervisors - View/Edit  如图所示的要求。

选择“座席详细数据报表”的权限选项

为报表分配权限

3.不足  Actions , 选择  Set Default Filter  并选择 Agent Names  您希望查看的数据。此外，请确保选择此选项  Skip Filter during the report execution  如图所示.

在报告中设置默认筛选器

选择默认过滤器的用户

4.不足  Actions,选择 Permalinks . 点击  HTML ，然后复制  permalink  左下角的URL地址。然后，确保取消选中permalink authentication选项（包括Variable和Default），最后，单击 Save  如图所示. 

选择报表的永久链接

查找报表的永久链接

例如；https://FQDN:8444/cuicui/permalink/?viewId=2F8D8F0710000186000000440A6A54A2&linkType=htmlType&viewType=Grid&refreshRate=1800

5.使用复制的永久链接创建XML文件。

创建此格式的XML文件并将其另存为  AgentDetailReport.xml and href = “Permalink you have copied from CUIC” .此外，在永久链接中将“&”替换为“&amp；”。

格式示例：

<?xml version="1.0" encoding="UTF-8"?>

<Module>

<ModulePrefs title=" Agent Detail Report " height="425">

</ModulePrefs>

<Content type="url" href= “https://FQDN:8444/cuicui/permalink/?viewId=2F8D8F0710000186000000440A6A54A2&linkType=htmlType&viewType=Grid&refreshRate=1800 “/>

</Module>

XML格式

6.在UCCX服务器上通过CLI重置3rdpartygadget用户密码。

3rdpartygadget帐户用于将第三方小工具上载到Finesse。用于设置或重置密码的新CLI命令为： utils reset_3rdpartygadget_password  如图所示.

3rdpartygadget登录CLI

7.上传  AgentDetailReport.xml  文件到  /3rdpartygadget/files  文件夹使用FileZilla或WinSCP（SFTP客户端）：

FFilezilla登录界面

将XML上载到服务器

8.通过将值更改为755，为XML文件授予文件权限。

设置XML权限

需要XML文件权限

9.导航至Cisco Finesse管理：https://FQDN:8445/cfadmin/container/?locale=en_US。 编辑Finesse桌面布局文件。点击  Expand All  如图所示.

Finesse桌面布局页面

10.将小工具添加到Finesse桌面上的代理/主管角色的新选项卡并保存。

例如：

        <tab>

               <id>Agent_Detail_Report</id>

               <label>Agent Detail Report</label>

                     <gadgets>

                          <gadget>/3rdpartygadget/files/AgentDetailReport.xml</gadget>

                     </gadgets>

        </tab>

Finesse小工具配置

11.从UCCX GUI重新启动这些服务：

• Cisco Unified CCX通知服务

• 思科Finesse Tomcat

• Unified CCX Socket.IO服务”

12.登录Finesse桌面，验证座席详细报告现在是否显示在新选项卡中。

Finesse座席桌面视图

故障排除

1. 遇到错误消息“呈现此小工具时出现问题。org.apache.shindig.common.xml.Xml异常：对于与元素类型“Content”关联的属性“href”，应为开放报价。”，如图所示。

Finesse中的Href错误

解决方案：

打开错误中提到的XML文件，并验证href属性之后用引号(")括起的永久链接是否按照步骤5中的说明格式正确。

XML文件格式

2.尝试从Finesse桌面加载小工具时，用户收到错误“不允许用户查看此报告”。

Finesse座席桌面上出错

解决方案：

确保取消选中该选项  Skip Filter during the report execution如前面提到的步骤3所示。

如果  Actions  菜单，选择  Set Default Filter  然后确保勾选选项  Skip filter during the report execution  如图所示.

设置报告的默认过滤器

常见问题

1. 是否可以在单个选项卡下添加多个3rdpartygadgets?

是，可以在单个选项卡下添加多个3rdpartygadgets。在内部添加新的小工具   桌面布局中的步骤。

2. 重置3rdpartygadget用户密码是否影响/3rdpartygadget/files文件夹中的现有XML文件？

3rdpartygadget密码的目的是访问  3rdpartygadget/files  文件夹并上传XML文件。因此，它不会影响任何现有配置。