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. Sélectionner  Agent Detail Report comme illustré dans l'image.

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

Sous la  Actions  , sélectionnez  Save As  et donnez un nom au rapport. Exemple :  Agent Detail Report - Test  et l'enregistrer sous  Reports  comme illustré dans l'image.

Enregistrer le rapport détaillé des agents

2. Ajoutez des autorisations aux utilisateurs.

Naviguez jusqu'à  Reports  et sélectionnez  Agent Detail Report - Test  et ajoutez des autorisations. Sous la  Actions  , sélectionnez  Permissions - All Users/Supervisors - View/Edit  conformément aux exigences indiquées dans l'image.

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

Attribuer des autorisations pour le rapport

3. Au titre  Actions , sélect  Set Default Filter  et sélectionnez l'option Agent Names  vous souhaitez voir les données pour. En outre, assurez-vous de sélectionner l'option  Skip Filter during the report execution  comme illustré dans l'image.

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

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

4. Au titre  Actions, sélectionnez Permalinks . Cliquez sur  HTML , puis copiez le fichier  permalink  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 illustré 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  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&linkType=htmlType&viewType=Grid&refreshRate=1800 “/>

</Module>

format XML

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 la suivante : utils reset_3rdpartygadget_password  comme illustré dans l'image.

Connexion 3rdpartygadget à l'interface CLI

7. Téléchargez le  AgentDetailReport.xml  fichier à  /3rdpartygadget/files  dossier utilisant FileZilla ou WinSCP (client SFTP) :

FInterface de connexion Filezilla

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 illustré 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 la  Actions  , sélectionnez  Set Default Filter  puis assurez-vous de cocher l'option  Skip filter during the report execution  comme illustré 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. Ajouter le nouveau gadget à l'intérieur   dans la 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  3rdpartygadget/files  via un client SFTP et téléchargez le fichier XML. ainsi, cela n'a pas d'impact sur la configuration existante.