Configurer des gadgets de rapport historique CUIC dans Cisco Finesse à l'aide d'un gadget tiers

Introduction

Ce document décrit les étapes pour configurer les gadgets de rapport historique sur Finesse, car la configuration par défaut inclut uniquement le gadget de données en direct dans Finesse Agent/Supervisor Desktop.

Conditions préalables

Exigences

Cisco vous recommande de prendre connaissance des rubriques suivantes :

• Cisco Unified Contact Center Express (UCCX)
• Cisco Unified Intelligence Center (CUIC)
• Administration Finesse
• Bureau Finesse

Composants utilisés

Les informations contenues dans ce document sont basées sur les versions de matériel et de logiciel suivantes :

• UCCX version 12.5
• CUIC version 12.5
• Finesse version 12.5
• Filezilla

The information in this document was created from the devices in a specific lab environment. All of the devices used in this document started with a cleared (default) configuration. Si votre réseau est en ligne, assurez-vous de bien comprendre l’incidence possible des commandes.

Configuration

Procédure d'activation des rapports historiques sur Finesse.

Voici les instructions détaillées pour activer la fonctionnalité de rapports historiques sur la plate-forme Finesse :

1. Créez un rapport personnalisé dans CUIC.

Accédez à la page CUIC. Cliquez sur Reports > Stock > Unified CCX Historical > Inbound. Select Agent Detail Report comme indiqué dans l'image.

Enregistrement d'une copie du rapport détaillé de l'état des agents

Sous l'Actions onglet, sélectionnez Save As et donnez un nom au rapport. Par exemple, Agent Detail Report - Test et enregistrez-le sous Reports  comme illustré dans l'image.

Enregistrer le rapport détaillé des agents

2. Ajoutez des autorisations aux utilisateurs.

Naviguez jusqu'à Reports , sélectionnez Agent Detail Report - Test et ajoutez des autorisations. Sous l'Actions onglet, sélectionnez Permissions - All Users/Supervisors - View/Edit en fonction des besoins, comme indiqué dans l'image.

Sélection de l'option Autorisation pour le rapport détaillé agent

Attribuer des autorisations pour le rapport

3. Sous Actions , sélectionner Set Default Filter et choisissez le Agent Names pour lequel vous souhaitez voir les données. En outre, assurez-vous de sélectionner l'option Skip Filter during the report execution  comme indiqué dans l'image.

Définir le filtre par défaut dans le rapport

Sélection des utilisateurs pour le filtre par défaut

4. Sous Actions, sélectionnez Permalinks . Cliquez sur HTML , puis copiez le textepermalink qui apparaît dans le coin inférieur gauche. Après cela, assurez-vous de décocher les deux options d'authentification de lien permanent (Variable et Par défaut) et enfin, cliquez sur Save  comme indiqué dans l'image. 

Sélectionner le lien permanent d'un rapport

Rechercher le lien permanent d'un rapport

Par exemple : https://FQDN:8444/cuicui/permalink/?viewId=2F8D8F0710000186000000440A6A54A2&linkType=htmlType&viewType=Grid&refreshRate=1800

5. Créez un fichier XML en utilisant le lien permanent copié.

Créez un fichier XML dans ce format et enregistrez-le sous le nom AgentDetailReport.xml and href = “Permalink you have copied from CUIC” . Remplacez également « & » par « & » dans le lien permanent.

Exemple de format :

<?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>

format 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. Réinitialisez le mot de passe utilisateur 3rdpartygadget via l'interface de ligne de commande sur le serveur UCCX.

Le compte 3rdpartygadget est utilisé pour télécharger des gadgets tiers vers Finesse. La nouvelle commande CLI permettant de définir ou de réinitialiser le mot de passe est : utils reset_3rdpartygadget_password  comme illustré dans l'image.


Connexion 3rdpartygadget à l'interface CLI

7. Téléchargez le fichier versAgentDetailReport.xml le dossier/3rdpartygadget/files à l'aide de FileZilla ou de WinSCP (client SFTP) :

Interface de connexion Firezilla

Télécharger XML sur le serveur

8. Accordez des autorisations de fichier au fichier XML en remplaçant la valeur par 755.

Définir l'autorisation XML

Autorisation de fichier XML requise

9. Accédez à Cisco Finesse Administration : https://FQDN:8445/cfadmin/container/?locale=en_US. Modifiez le fichier Finesse Desktop Layout. Cliquez sur Expand All  comme indiqué dans l'image.



Page Finesse Desktop Layout

10. Ajoutez le gadget à un nouvel onglet sur le bureau Finesse pour le rôle d'agent/superviseur et enregistrez.

Exemple :

        <tab>

               <id>Agent_Detail_Report</id>

               <label>Agent Detail Report</label>

                     <gadgets>

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

                     </gadgets>

        </tab>

Configuration du gadget Finesse

11. Redémarrez ces services à partir de l'interface utilisateur graphique UCCX :

• Service de notification Cisco Unified CCX

• Cisco Finesse Tomcat

• Unified CCX Socket.IO Service"

12. Connectez-vous à Finesse Desktop et vérifiez si le rapport détaillé de l'agent s'affiche dans un nouvel onglet ou non.

Vue de bureau de Finesse Agent

Dépannage

1. Rencontre du message d'erreur « Des problèmes se sont produits lors du rendu de ce gadget. org.apache.shindig.common.xml.XmlException : un devis ouvert est attendu pour l'attribut « href » associé à un type d'élément « Content ». », comme illustré dans l'image.

Erreur Href dans la finesse

Solution :

Ouvrez le fichier XML mentionné dans l'erreur et vérifiez que le lien permanent placé entre guillemets («) après l'attribut href est correctement formaté comme indiqué à l'étape 5.

Format de fichier XML

2. Lors de la tentative de chargement du gadget à partir de Finesse Desktop, l'utilisateur reçoit l'erreur « L'utilisateur n'est pas autorisé à afficher ce rapport ».

Erreur sur Finesse Agent Desktop

Solution :

Assurez-vous de désélectionner l'option Skip Filter during the report execution, comme indiqué à l'étape 3. mentionnée précédemment.

Dans le menu,Actions sélectionnez Set Default Filter puis assurez-vous de cocher l'option Skip filter during the report execution comme indiqué dans l'image.

Définir le filtre par défaut pour le rapport

Questions fréquentes

1. Est-il possible d'ajouter plusieurs gadgets 3rdpartygadgets sous un seul onglet ?

Oui, il est possible d'ajouter plusieurs gadgets tiers sous un seul onglet. Ajoutez le nouveau gadget dans l'étape<gadgets> Mise en page du bureau.

2. La réinitialisation du mot de passe utilisateur 3rdpartygadget affecte-t-elle les fichiers XML existants dans le dossier /3rdpartygadget/files ?

L'objectif du mot de passe 3rdpartygadget est d'accéder au dossier via un client SFTP et de télécharger le fichier XML. Par conséquent, il n'a pas d'impact sur la configuration existante de ce dernier 3rdpartygadget/files.