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. Selecionar  Agent Detail Report conforme mostrado na imagem.

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

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

Salvar Relatório de Detalhes de Agentes

2. Adicione Permissões aos usuários.

Navegue até  Reports  e selecione  Agent Detail Report - Test  e adicionar permissões. Sob o comando  Actions  , 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. Ao abrigo do  Actions , selecionar  Set Default Filter  e escolha a opção Agent Names  você deseja ver os dados de. Além disso, selecione 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. Nos termos do  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  conforme 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.

Criar um arquivo XML neste formato e salvá-lo 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&linkType=htmlType&viewType=Grid&refreshRate=1800 “/>

</Module>

Formato XML

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  conforme mostrado na imagem.

Logon de gadget de terceiros na CLI

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

FInterface 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  conforme 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  Actions  , selecione  Set Default Filter  e certifique-se de marcar a opção  Skip filter during the report execution  conforme 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. Adicionar o novo gadget ao   etapa em 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 gadget 3rdparty é acessar o  3rdpartygadget/files  por meio de um cliente SFTP e carregar o arquivo XML. portanto, ele não afeta nenhuma configuração existente.