Configurar gadgets de informe histórico de CUIC en Cisco Finesse mediante gadgets de terceros

Introducción

Este documento describe los pasos para configurar los gadgets de informes históricos en Finesse, ya que la configuración predeterminada solo incluye el gadget Datos en directo en el escritorio de agente/supervisor de Finesse.

Prerequisites

Requirements

Cisco recomienda que tenga conocimiento sobre estos temas:

• Cisco Unified Contact Center Express (UCCX)
• Cisco Unified Intelligence Center (CUIC)
• Administración Finesse
• Escritorio Finesse

Componentes Utilizados

La información que contiene este documento se basa en las siguientes versiones de software y hardware.

• UCCX versión 12.5
• CUIC versión 12.5
• Finesse versión 12.5
• Filezilla

La información que contiene este documento se creó a partir de los dispositivos en un ambiente de laboratorio específico. Todos los dispositivos que se utilizan en este documento se pusieron en funcionamiento con una configuración verificada (predeterminada). Si tiene una red en vivo, asegúrese de entender el posible impacto de cualquier comando.

Configuración

Procedimiento para habilitar informes históricos en Finesse.

A continuación se describen las instrucciones paso a paso para habilitar la funcionalidad de informes históricos en la plataforma Finesse:

1. Cree un informe personalizado en CUIC.

Acceda a la página CUIC. Haga clic en Reports > Stock > Unified CCX Historical > Inbound. Select Agent Detail Report como se muestra en la imagen.

Guardar una copia del informe de detalles de estado de agente

En la Actions ficha, seleccione Save As y asigne un nombre al informe. Por ejemplo, Agent Detail Report - Test y guárdelo en Reports  como se muestra en la imagen.

Guardar informe detallado de agente

2. Agregue permisos a los usuarios.

Desplácese hasta Reports Agent Detail Report - Testy seleccione y agregue permisos. En la Actions pestaña, seleccione Permissions - All Users/Supervisors - View/Edit según el requisito como se muestra en la imagen.

Selección de una opción de permiso para el informe de detalles de agente

Asignación de permisos para el informe

3. En Actions , seleccione Set Default Filter y elija el Agent Names para el que desea ver los datos. Además, asegúrese de seleccionar la opción Skip Filter during the report execution  como se muestra en la imagen.

Establecer filtro predeterminado en el informe

Selección de usuarios para el filtro predeterminado

4. En Actions, seleccione Permalinks . Hacer clic en HTML y, a continuación, copie el permalink que aparece en la esquina inferior izquierda. Después de eso, asegúrese de desmarcar las opciones de autenticación de vínculo permanente (Variable y Default) y, finalmente, haga clic en Save  como se muestra en la imagen. 

Seleccionar vínculo permanente de un informe

Buscar vínculo permanente de un informe

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

5. Cree un archivo XML utilizando el vínculo permanente copiado.

Cree un archivo XML con este formato y guárdelo como AgentDetailReport.xml and href = “Permalink you have copied from CUIC” . También, reemplace "&" por "&" del vínculo permanente.

Ejemplo 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. Restablezca la contraseña de usuario del gadget de terceros mediante CLI en el servidor UCCX.

La cuenta de gadgets de terceros se utiliza para cargar gadgets de terceros en Finesse. El nuevo comando CLI para establecer o restablecer la contraseña es: utils reset_3rdpartygadget_password  como se muestra en la imagen.


inicio de sesión de gadget de terceros en CLI

7. Cargue el AgentDetailReport.xml archivo en la /3rdpartygadget/files carpeta mediante FileZilla o WinSCP (cliente SFTP):

Interfaz de inicio de sesión Filezilla

Cargar XML en el servidor

8. Conceda permisos de archivo al archivo XML cambiando el valor a 755.

Establecer permiso XML

Archivo XML Permiso necesario

9. Vaya a Cisco Finesse Administration: https://FQDN:8445/cfadmin/container/?locale=en_US. Edite el archivo de diseño de escritorio de Finesse. Haga clic en Expand All  como se muestra en la imagen.



Página Diseño de escritorio Finesse

10. Agregue el gadget a una nueva pestaña en el escritorio de Finesse para la función de agente/supervisor y guárdelo.

Por ejemplo:

        <tab>

               <id>Agent_Detail_Report</id>

               <label>Agent Detail Report</label>

                     <gadgets>

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

                     </gadgets>

        </tab>

Configuración de gadgets de Finesse

11. Reinicie estos servicios desde la GUI de UCCX:

• Servicio de notificación de Cisco Unified CCX

• Cisco Finesse Tomcat

• Servicio Unified CCX Socket.IO"

12. Inicie sesión en Finesse Desktop y verifique si el informe de detalles de agente se muestra ahora en una pestaña nueva o no.

Vista de escritorio del agente Finesse

Troubleshoot

1. Aparece el mensaje de error "Se han producido problemas al procesar este gadget. org.apache.shindig.common.xml.XmlException: se espera el presupuesto abierto para el atributo "href" asociado a un tipo de elemento "Content".", como se muestra en la imagen.

Error Href en finura

Solución:

Abra el archivo XML mencionado en el error y compruebe que el vínculo permanente entre comillas (") después del atributo href tiene el formato correcto indicado en el paso 5.

Formato de archivo XML

2. Al intentar cargar el gadget desde Finesse Desktop, el usuario recibe el error "El usuario no tiene permiso para ver este informe".

Error en Finesse Agent Desktop

Solución:

Asegúrese de desactivar la opción Skip Filter during the report execution, como se indica en el paso 3. mencionado anteriormente.

En el Actions menú, seleccione Set Default Filter y asegúrese de marcar la opción Skip filter during the report execution como se muestra en la imagen.

Establecer filtro predeterminado para el informe

Preguntas frecuentes

1. ¿Es posible agregar varios gadgets de terceros en una sola ficha?

Sí, es posible agregar varios gadgets de terceros en una sola ficha. Agregue el nuevo gadget al paso interior<gadgets> en Diseño del escritorio.

2. ¿El restablecimiento de la contraseña de usuario de 3rdpartygadget afecta a los archivos XML existentes en la carpeta /3rdpartygadget/files?

El propósito de la contraseña del gadget de terceros es acceder a la 3rdpartygadget/files carpeta a través de un cliente SFTP y cargar el archivo XML. Por lo tanto, no afecta a ninguna configuración existente.