Konfigurieren der CUIC-Gadgets für Verlaufsberichte in Cisco Finesse mithilfe des Drittanbieter-Gadgets

Einleitung

In diesem Dokument werden die Schritte zur Konfiguration von Verlaufsberichte-Gadgets auf Finesse beschrieben, da die Standardeinstellung nur das Live-Daten-Gadget auf dem Finesse Agent-/Supervisor-Desktop beinhaltet.

Voraussetzungen

Anforderungen

Cisco empfiehlt, dass Sie über Kenntnisse in folgenden Bereichen verfügen:

• Cisco Unified Contact Center Express (UCCX)
• Cisco Unified Intelligence Center (CUIC)
• Finesse-Verwaltung
• Finesse Desktop

Verwendete Komponenten

Die Informationen in diesem Dokument basierend auf folgenden Software- und Hardware-Versionen:

• UCCX Version 12.5
• CUIC Version 12.5
• Finesse Version 12.5
• Filezilla

Die Informationen in diesem Dokument beziehen sich auf Geräte in einer speziell eingerichteten Testumgebung. Alle Geräte, die in diesem Dokument benutzt wurden, begannen mit einer gelöschten (Nichterfüllungs) Konfiguration. Wenn Ihr Netzwerk in Betrieb ist, stellen Sie sicher, dass Sie die möglichen Auswirkungen aller Befehle kennen.

Konfiguration

Verfahren zum Aktivieren von Verlaufsberichten zu Finesse.

Hier finden Sie eine schrittweise Anleitung, wie Sie die Funktion für Verlaufsberichte auf der Finesse-Plattform aktivieren können:

1. Erstellen Sie einen benutzerdefinierten Bericht in CUIC.

Navigieren Sie zur CUIC-Seite. Klicken Sie  Reports > Stock > Unified CCX Historical > Inbound. Auswählen  Agent Detail Report wie im Bild dargestellt.

Kopie des Agentenstatus-Detailberichts speichern

Im  Actions  Registerkarte, auswählen  Save As  und geben Sie dem Bericht einen Namen. Beispiele,  Agent Detail Report - Test  und speichere sie unter  Reports  wie im Bild dargestellt.

Agent-Detailbericht speichern

2. Berechtigungen zu den Benutzern hinzufügen.

Navigieren Sie zu  Reports  und wählen  Agent Detail Report - Test  und Berechtigungen hinzufügen. Im  Actions  Registerkarte, auswählen  Permissions - All Users/Supervisors - View/Edit  gemäß der Anforderung im Bild.

Auswählen der Berechtigungsoption für den Agent-Detailbericht

Berechtigungen für Bericht zuweisen

3. Unter  Actions , auswählen  Set Default Filter  und wählen Sie Agent Names  für die Sie Daten anzeigen möchten. Wählen Sie außerdem die gewünschte Option aus.  Skip Filter during the report execution  wie im Bild dargestellt.

Standardfilter im Bericht festlegen

Benutzer für Standardfilter auswählen

4. Unter  Actions, wählen Permalinks . Klicken Sie  HTML , und kopieren Sie dann die  permalink  die in der linken unteren Ecke angezeigt wird. Deaktivieren Sie anschließend die Permalink-Authentifizierungsoptionen (Variable und Standard), und klicken Sie auf Save  wie im Bild dargestellt. 

Permalink eines Berichts auswählen

Permalink eines Berichts suchen

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

5. Erstellen Sie eine XML-Datei mit dem kopierten Permalink.

Erstellen Sie eine XML-Datei in diesem Format, und speichern Sie sie unter  AgentDetailReport.xml and href = “Permalink you have copied from CUIC” . Ersetzen Sie "&" durch "&" aus dem Permalink.

Beispiel formatieren:

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

XML-Format

6. Setzen Sie das Benutzerkennwort von 3rdpartygadget über die CLI auf dem UCCX-Server zurück.

Das 3rdpartygadget-Konto wird verwendet, um Gadgets von Drittanbietern nach Finesse hochzuladen. Der neue CLI-Befehl zum Festlegen oder Zurücksetzen des Kennworts lautet: utils reset_3rdpartygadget_password  wie im Bild dargestellt.

3rdpartygadget-Anmeldung bei CLI

7. Laden Sie die  AgentDetailReport.xml  Datei an  /3rdpartygadget/files  Ordner mit FileZilla oder WinSCP (SFTP-Client):

FFilezilla-Login-Schnittstelle

XML auf Server hochladen

8. Erteilen Sie der XML-Datei Dateiberechtigungen, indem Sie den Wert auf 755 ändern.

XML-Berechtigung festlegen

XML-Dateiberechtigung erforderlich

9. Navigieren Sie zu Cisco Finesse Administration: https://FQDN:8445/cfadmin/container/?locale=en_US. Bearbeiten Sie die Datei "Finesse Desktop Layout". Klicken Sie  Expand All  wie im Bild dargestellt.

Seite "Finesse Desktop Layout"

10. Fügen Sie das Gadget einer neuen Registerkarte auf dem Finesse-Desktop für die Agenten-/Supervisor-Rolle hinzu, und speichern Sie.

Beispiele:

        <tab>

               <id>Agent_Detail_Report</id>

               <label>Agent Detail Report</label>

                     <gadgets>

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

                     </gadgets>

        </tab>

Konfiguration des Finesse-Gadgets

11. Starten Sie diese Dienste über die UCCX-GUI neu:

• Cisco Unified CCX Notification Service

• Cisco Finesse Tomcat

• Unified CCX Socket.IO Service"

12. Melden Sie sich bei Finesse Desktop an, und überprüfen Sie, ob der Agent-Detailbericht nun in einer neuen Registerkarte angezeigt wird.

Finesse Agent Desktop-Ansicht

Fehlerbehebung

1. Die Fehlermeldung "Beim Rendern dieses Gadgets sind Probleme aufgetreten. org.apache.shindig.common.xml.XmlException: Für das Attribut "href", das mit dem Elementtyp "Content" verknüpft ist, wird ein offener Kostenvoranschlag erwartet.", wie im Bild angezeigt.

Href-Fehler in Finesse

Lösung:

Öffnen Sie die XML-Datei, die im Fehler erwähnt wurde, und überprüfen Sie, ob der Permalink, der in den Anführungszeichen (") enthalten ist, nachdem das href-Attribut wie in Schritt 5 beschrieben ordnungsgemäß formatiert wurde.

XML-Dateiformat

2. Beim Versuch, das Gadget von Finesse Desktop zu laden, erhält der Benutzer die Fehlermeldung "Der Benutzer darf diesen Bericht nicht anzeigen".

Fehler auf Finesse Agent Desktop

Lösung:

Deaktivieren Sie die Option  Skip Filter during the report execution, wie in Schritt 3. bereits erwähnt.

Im  Actions  Menü, auswählen  Set Default Filter  und markieren Sie dann die Option  Skip filter during the report execution  wie im Bild dargestellt.

Standardfilter für Bericht festlegen

Häufig gestellte Fragen

1. Ist es möglich, mehrere 3rdpartygadgets unter einer einzigen Registerkarte hinzuzufügen?

Ja, es ist möglich, mehrere 3rdpartygadgets unter einer einzigen Registerkarte hinzuzufügen. Neues Gadget hinzufügen   -Schritt in Desktop Layout.

2. Wirkt sich das Zurücksetzen des 3rdpartygadget-Benutzerkennworts auf die vorhandenen XML-Dateien im Ordner /3rdpartygadget/files aus?

Der Zweck des 3rdpartygadget-Kennworts besteht darin, auf die  3rdpartygadget/files  über einen SFTP-Client zu speichern und die XML-Datei hochzuladen, sodass die vorhandene Konfiguration nicht beeinträchtigt wird.