Configurar gadgets de relatório histórico do CUIC no Cisco Finesse usando gadget de terceiros

Introdução

Este documento descreve as etapas para configurar gadgets de relatórios de histórico no Finesse, pois a configuração padrão inclui apenas o gadget de dados ao vivo no Finesse Agent/Supervisor Desktop.

Pré-requisitos

Requisitos

A Cisco recomenda que você tenha conhecimento destes tópicos:

• Cisco Unified Contact Center Express (UCCX)
• Cisco Unified Intelligence Center (CUIC)
• Administração Finesse
• Desktop Finesse

Componentes Utilizados

As informações neste documento são baseadas nestas versões de software e hardware:

• UCCX versão 12.5
• CUIC versão 12.5
• Finesse versão 12.5
• Filezila

As informações neste documento foram criadas a partir de dispositivos em um ambiente de laboratório específico. Todos os dispositivos utilizados neste documento foram iniciados com uma configuração (padrão) inicial. Se a rede estiver ativa, certifique-se de que você entenda o impacto potencial de qualquer comando.

Configuração

Procedimento para habilitação do Historical Reports no Finesse.

Aqui estão descritas as instruções passo a passo para ativar a funcionalidade de relatórios de histórico na plataforma Finesse:

1. Crie um Relatório personalizado no CUIC.

Navegue até a página CUIC. Clique em Reports > Stock > Unified CCX Historical > Inbound. Select Agent Detail Report como mostrado na imagem.

Como salvar uma cópia do relatório de Detalhes de estados de agentes

Na guiaActions , selecione Save As e dê um nome ao relatório. Por exemplo, Agent Detail Report - Test e salve-o em Reports  como mostrado na imagem.

Salvar Relatório de Detalhes de Agentes

2. Adicione Permissões aos usuários.

Navegue até Reports , selecioneAgent Detail Report - Test e adicione Permissões. Na guiaActions, selecione Permissions - All Users/Supervisors - View/Edit de acordo com o requisito, conforme mostrado na imagem.

Selecionando a opção Permissão para o Relatório de detalhes de agentes

Atribuindo permissões para o relatório

3. Em Actions , selecioneSet Default Filter e escolha o Agent Names para o qual deseja ver os dados. Além disso, certifique-se de selecionar a opção Skip Filter during the report execution  conforme mostrado na imagem.

Definir Filtro Padrão no Relatório

Selecionando usuários para o filtro padrão

4. Em Actions, selecione Permalinks . Clique em HTML e copie o permalink que aparece no canto inferior esquerdo. Depois disso, certifique-se de desmarcar as opções de autenticação do permalink (Variável e Padrão) e, finalmente, clique em Save  como mostrado na imagem. 

Selecionar Permalink de um relatório

Localizar Permalink de um relatório

Por exemplo; https://FQDN:8444/cuicui/permalink/?viewId=2F8D8F0710000186000000440A6A54A2&linkType=htmlType&viewType=Grid&refreshRate=1800

5. Crie um arquivo XML usando o permalink copiado.

Crie um arquivo XML neste formato e salve-o como AgentDetailReport.xml and href = “Permalink you have copied from CUIC” . Além disso, substitua "&" por "&" do permalink.

Exemplo de formato:

<?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&amp;linkType=htmlType&amp;viewType=Grid&amp;refreshRate=1800 “/>

</Module>

Formato XML

<?xml version="1.0" encoding="UTF-8"?> <Module> <ModulePrefs title="Agent Detail Report" height="425"> </ModulePrefs> <Content type="url" href= "https://ccxshabic.cscotaclab.com:8444/cuicui/permalink/?viewId=2F8D8F0710000186000000440A6A54A2&amp;linkType=htmlType&amp;viewType=Grid&amp;refreshRate=1800"/> </Module>

6. Redefina a senha de usuário do gadget 3rd partyvia CLI no servidor UCCX.

A conta 3rdpartygadget é usada para carregar gadgets de terceiros no Finesse. O novo comando CLI para definir ou redefinir a senha é: utils reset_3rdpartygadget_password  como mostrado na imagem.


Logon de gadget de terceiros na CLI

7. Carregue o AgentDetailReport.xml arquivo para a pasta/3rdpartygadget/files usando FileZilla ou WinSCP (cliente SFTP):

Interface de login do Filezilla

Carregar XML no servidor

8. Dê permissões de arquivo ao arquivo XML alterando o valor para 755.

Definir Permissão XML

Permissão de arquivo XML necessária

9. Navegue até Cisco Finesse Administration: https://FQDN:8445/cfadmin/container/?locale=en_US. Edite o arquivo de Layout do Finesse Desktop. Clique em Expand All  como mostrado na imagem.



Página Layout do Finesse Desktop

10. Adicione o gadget a uma nova guia na área de trabalho do Finesse para a função de agente/supervisor e salve.

Por exemplo:

        <tab>

               <id>Agent_Detail_Report</id>

               <label>Agent Detail Report</label>

                     <gadgets>

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

                     </gadgets>

        </tab>

Configuração do gadget Finesse

11. Reinicie estes serviços a partir da GUI do UCCX:

• Serviço de notificação do Cisco Unified CCX

• Cisco Finesse Tomcat

• Soquete do Unified CCX.Serviço IO"

12. Faça login no Finesse Desktop e verifique se o Relatório de detalhes do agente está sendo exibido em uma nova guia ou não.

Exibição de Área de Trabalho do Agente Finesse

Troubleshooting

1. Encontrando a mensagem de erro "Houve problemas ao processar este gadget. org.apache.shindig.common.xml.XmlException: aspas abertas são esperadas para o atributo "href" associado a um tipo de elemento "Content"." como mostrado na imagem.

Erro Href no finesse

Solução:

Abra o arquivo XML mencionado no erro e verifique se o permalink entre aspas (") depois que o atributo href estiver formatado corretamente, conforme instruído na Etapa 5.

Formato de arquivo XML

2. Ao tentar carregar o gadget do Finesse Desktop, o usuário recebe o erro "O usuário não tem permissão para exibir esse relatório".

Erro no Finesse Agent Desktop

Solução:

Certifique-se de desmarcar a opção Skip Filter during the report execution, conforme indicado na Etapa 3. mencionada anteriormente.

No menuActions, selecione Set Default Filter e certifique-se de marcar a opção Skip filter during the report execution como mostrado na imagem.

Definir Filtro Padrão para Relatório

Perguntas frequentes

1. É possível adicionar vários gadgets de terceiros em uma única guia?

Sim, é possível adicionar vários gadgets de terceiros em uma única guia. Adicione o novo gadget na etapa interna<gadgets> do Layout da Área de Trabalho.

2. A redefinição da senha de usuário do 3rdpartygadget afeta os arquivos XML existentes na pasta /3rdpartygadget/files?

A finalidade da senha do 3rdpartygadget é acessar a pasta3rdpartygadget/files por meio de um cliente SFTP e carregar o arquivo XML. Portanto, ela não afeta nenhuma configuração existente.