Sunteți pe pagina 1din 10

Finesse – Display a Permalink from a CUIC report

Created by M Baker for UCCX 10.6.1

Requirements from the Business – “Display a report so that that Agent can see some of their stats.”

For example, the Outbound Team wanted to be able to see how many calls they make outgoing
within the Finesse Desktop user web page from an existing Supervisor Report in CUIC.

This is what they needed to be able to see:-

There are a couple of things you need to do in the first instance (ie the first time you set this up).

From the UCCX Server set up the 3rdpartygadget. This is basically the area used to upload files to
that you then reference (explained later in this document).

From the UCCX CLI you need to set the password for this are (if you already know this then skip this
part of the setup).

To do this type:-
utils reset_3rdpartygadget_password

You are prompted to enter a password.

After you enter a password, you are prompted to confirm the password.

The password for the 3rdpartygadget account must be between 5 and 32 characters long and
cannot contain spaces or double quotes (").

The full document is here should you need to reference it:-


https://www.cisco.com/c/en/us/td/docs/voice_ip_comm/cust_contact/contact_center/finesse/fine
sse_1001/user/guide/CFIN_BK_CF7BB5C7_00_cisco-finesse-administration-
1001/CFIN_BK_CF7BB5C7_00_cisco-finesse-administration-1001_chapter_01110.html
Creating the Permalink from an existing report

From the CUIC webpage on the left hand menu click “Reports”

Right click on the report you want displaying in Finesse and click “Edit Views”

Now you need to click in the click the report you want displaying (not the charts) then click “Links” to
display the HTTP you will need.

Tick “Enable Unauthenticated Access”

Then Copy the HTML link that in the “HTML Link” box to a notepad.
The next part to complete is to create a .xml file which you will need to upload (SFTP) to UCCX

This is take from https://community.cisco.com/t5/collaboration-documents/instructions-for-


creating-cuic-gadgets/ta-p/3617980

Here is the series of steps that I use to create the gadget:


1) Make sure you are using CUIC 8.5(3).  Any version earlier than this won't work.
2) Create a file called "MyCUICGadget.xml"
3) In the file, paste the following:
 
<?xml version="1.0" encoding="UTF-8"?>
<Module>
<ModulePrefs
title="My CUIC Gadget" height="500">
</ModulePrefs>
<Content type="url" href="YourPermaLinkGoesHere" />
</Module>
 
4) Set the title to be whatever you want.  This will show up as the Gadget title in Finesse.
5) Set the height to whatever you want.  This will determine the height of the gadget in Finesse
6) Paste your Permalink in the "href" tag above.  
7) You will need to take care of the escape characters yourself.  For example, replace the "&" with
"&amp;"
 
Now your gadget is complete.  My gadget looks like this:
 
<?xml version="1.0" encoding="UTF-8"?>
<Module>
<ModulePrefs
title="My CUIC Gadget" height="500">
</ModulePrefs>
<Content type="url" href="https://10.80.180.21:8444/cuic/permalink/PermalinkViewer.htmx?
viewId=4FE0953F100001630000035E0A50B415&amp;linkType=htmlType&amp;viewType=Grid" />
</Module>
 
Save the.xml file

Now upload this file to UCCX to go into the location \3rdpartygadget\files

I used Filezilla and this is the config for the site I created in Sitemanager and I used the password I
set earlier in this document when I logged on to the UCCX CLI:-
Once you have a SFTP connection to UCCX the .xml file needs to go WITHIN the folder called “File”

So it should look like this when uploaded (NOTE THE FILE PERMISSIONS):-

From Filezilla you need to change the file permissions by right clicking the file and ensure they match
these:-
The next step is loading the gadget in the container by logging onto the Finesse Admin page
(https://10.80.180.21:8445/cfadmin)

Login and click on “Team Resources.” Hopefully you will have set your teams up previously as that
isn’t covered here.

Select the team that you want to report for, click “Desktop Layou” and put a tick in “Overide System
Default”

You now need to edit the layout………. Below is the layout changes I made. A full copy of the xml for
Finesse Desktop with these in are at the bottom of this document so that you can see where I added
the bits I needed for displaying in the correct location on the desktop:-

<tab>
<id>manageCall</id>
<label>finesse.container.tabs.agent.manageCallLabel</label>
</tab>
<tab>
<id>CustomTab1</id>
<label>Outgoing Calls</label>
<columns>
<column>
<gadgets>
<gadget>https://localhost:8445/3rdpartygadget/files/MyCUICGadget.xml</gadget>
</gadgets>
</column>
</columns>
</tab>
SAVE THE CHANGES YOU HAVE MADE

The final thing you need to do is restart the Cisco Finesse Tomcat service on UCCX

This can be done from the webpage for UCCX Serviceability>Tools>Control Centre – Network
Services. Select “Cisco Finesse Tomcat” then click “Restart”

Now login to the Cisco Finesse Agent website – http://10.80.180.21:8445/desktop

(ensure your ext number is in the team you have just added the additional gadget for) and you will
see your new Tab and the report should be displayed.
This is the full Desktop layout with in Finesse with the additional gadget highlighted so
you can see where it fits.
<finesseLayout xmlns="http://www.cisco.com/vtg/finesse">
<layout>
<role>Agent</role>
<page>
<gadget>/desktop/gadgets/CallControl.jsp</gadget>
<!--
The following Gadget is used for WebChat and Email. It is *ONLY* supported with WebChat and Email. If you are not using WebChat
and Email, then
remove it. If you are using WebChat or Email, include this Gadget in the Desktop Layouts used by Teams associated with chat and email
CSQs. To include this functionality:
1) Remove these comments leaving the gadget

RESTRICTIONS:
- The NonVoiceControl gadget must be configured as a page level gadget
- The NonVoiceControl gadget must not be configured in a column

<gadget>https://localhost/agentdesktop/gadgets/NonVoiceControl.xml</gadget>
-->
</page>
<tabs>
<tab>
<id>home</id>
<label>finesse.container.tabs.agent.homeLabel</label>
<columns>
<column>
<gadgets>
<gadget>https://localhost:8444/cuic/gadget/LiveData/LiveDataGadget.jsp?
gadgetHeight=310&viewId=76D964AD10000140000000830A4E5E6F&filterId=AgentCSQStats.csqName=CL&compositeFilterId=AgentCSQS
tats.AgentIds.agentId=loginId</gadget>
<gadget>https://localhost:8444/cuic/gadget/LiveData/LiveDataGadget.jsp?
gadgetHeight=310&viewId=5C626F9C10000140000000600A4E5B33&filterId=ResourceIAQStats.resourceId=CL</gadget>
</gadgets>
</column>
</columns>
</tab>
<tab>
<id>myStatistics</id>
<label>finesse.container.tabs.agent.myStatisticsLabel</label>
<columns>
<column>
<gadgets>
<gadget>https://localhost:8444/cuic/gadget/LiveData/LiveDataGadget.jsp?
gadgetHeight=112&viewId=67D4371110000140000001080A4E5E6B&filterId=ResourceIAQStats.resourceId=loginId</gadget>
<gadget>https://localhost:8444/cuic/gadget/LiveData/LiveDataGadget.jsp?
gadgetHeight=420&viewId=5D411E8A10000140000000230A4E5E6B&filterId=AgentStateDetailStats.agentID=loginId</gadget>
</gadgets>
</column>
</columns>
</tab>
<tab>
<id>manageCall</id>
<label>finesse.container.tabs.agent.manageCallLabel</label>
</tab>
<tab>
<id>CustomTab1</id>
<label>Outgoing Calls</label>
<columns>
<column>
<gadgets>
<gadget>https://localhost:8445/3rdpartygadget/files/MyCUICGadget.xml</gadget>
</gadgets>
</column>
</columns>
</tab>
<!--
The following Tab and Gadget are used for WebChat and Email. They are *ONLY* supported with WebChat and Email. If you are not
using WebChat or Email, then
remove them. If you are using WebChat or Email, include this Gadget in the Desktop Layouts used by Teams associated with chat or
email
CSQs. To include this functionality:
1) Remove these comments leaving the tab and gadget
2) Replace all instances of "my-socialminer-server" with the Fully Qualified Domain Name of your SocialMiner Server.
3) [OPTIONAL] Adjust the height of the gadget by changing the "gadgetHeight" parameter.

IMPORTANT NOTE:
- In order for this Gadget to work, you must have performed all documented prerequisite steps.

RESTRICTIONS:
- The multisession-reply-gadget must not be configured as a page level gadget
- The multisession-reply-gadget must not be configured in a column

<tab>
<id>manageNonVoiceMedia</id>
<label>finesse.container.tabs.agent.manageNonVoiceMediaLabel</label>
<columns>
<column>
<gadgets>
<gadget>https://my-socialminer-server/multisession/ui/gadgets/multisession-reply-gadget.jsp?
gadgetHeight=430</gadget>
</gadgets>
</column>
</columns>
</tab>
-->
</tabs>
</layout>
<layout>
<role>Supervisor</role>
<page>
<gadget>/desktop/gadgets/CallControl.jsp</gadget>
<!--
The following Gadget is used for WebChat and Email. It is *ONLY* supported with WebChat and Email. If you are not using WebChat
and Email, then
remove it. If you are using WebChat or Email, include this Gadget in the Desktop Layouts used by Teams associated with chat or email
CSQs. To include this functionality:
1) Remove these comments leaving the gadget

RESTRICTIONS:
- The NonVoiceControl gadget must be configured as a page level gadget
- The NonVoiceControl gadget must not be configured in a column

<gadget>https://localhost/agentdesktop/gadgets/NonVoiceControl.xml</gadget>
-->
</page>
<tabs>
<tab>
<id>manageTeam</id>
<label>finesse.container.tabs.supervisor.manageTeamLabel</label>
<columns>
<column>
<gadgets>
<gadget>/desktop/gadgets/TeamPerformance.jsp</gadget>
</gadgets>
</column>
</columns>
</tab>
<tab>
<id>teamData</id>
<label>finesse.container.tabs.supervisor.teamDataLabel</label>
<columns>
<column>
<gadgets>
<gadget>https://localhost:8444/cuic/gadget/LiveData/LiveDataGadget.jsp?
gadgetHeight=310&viewId=7291DCB410000140000000890A4E5B33&filterId=ResourceIAQStats.resourceId=CL</gadget>
<gadget>https://localhost:8444/cuic/gadget/LiveData/LiveDataGadget.jsp?
gadgetHeight=310&viewId=728283C210000140000000530A4E5B33&filterId=ResourceIAQStats.resourceId=CL</gadget>
<!--
The following Gadget is used for WebChat. It is *ONLY* supported with WebChat. If you are not using WebChat, then
remove it. If you are using WebChat, include this Gadget in the Desktop Layouts used by Teams associated with chat
CSQs. To include this functionality:
1) Remove these comments leaving the gadget

<gadget>https://localhost:8444/cuic/gadget/LiveData/LiveDataGadget.jsp?
gadgetHeight=310&viewId=F2F1FC17100001440000014E0A4E5D48&filterId=ChatAgentStats.agentId=CL</gadget>
-->
<!--
The following Gadgets are used for Predictive/Progressive/Preview Agent Outbound.
To include this functionality:
1) Remove these comments leaving the gadget

<gadget>https://localhost:8444/cuic/gadget/LiveData/LiveDataGadget.jsp?
gadgetHeight=310&viewId=FD919FB9100001440000005D0A4E5B29&filterId=ResourceIAQStats.resourceId=CL</gadget>
<gadget>https://localhost:8444/cuic/gadget/LiveData/LiveDataGadget.jsp?
gadgetHeight=310&viewId=FD919FB510000144000000470A4E5B29&filterId=ResourceIAQStats.resourceId=CL</gadget>
-->
</gadgets>
</column>
</columns>
</tab>
<tab>
<id>queueData</id>
<label>finesse.container.tabs.supervisor.queueDataLabel</label>
<columns>
<column>
<gadgets>
<gadget>https://localhost:8444/cuic/gadget/LiveData/LiveDataGadget.jsp?
gadgetHeight=310&viewId=C8E2DB1610000140000000A60A4E5E6B&filterId=VoiceIAQStats.esdName=CL</gadget>
<gadget>https://localhost:8444/cuic/gadget/LiveData/LiveDataGadget.jsp?
gadgetHeight=310&viewId=9A7A14CE10000140000000ED0A4E5E6B&filterId=VoiceCSQDetailsStats.agentId=CL&compositeFilterId=VoiceC
SQDetailsStats.AgentVoiceCSQNames.agentVoiceCSQName=CL</gadget>
<!--
The following Gadget is used for WebChat. It is *ONLY* supported with WebChat. If you are not using WebChat, then
remove it. If you are using WebChat, include this Gadget in the Desktop Layouts used by Teams associated with chat
CSQs. To include this functionality:
1) Remove these comments leaving the gadget

<gadget>https://localhost:8444/cuic/gadget/LiveData/LiveDataGadget.jsp?
gadgetHeight=310&viewId=E42ED788100001440000007B0A4E5CA1&filterId=ChatQueueStatistics.queueName=CL</gadget>
-->
</gadgets>
</column>
</columns>
</tab>
<tab>
<id>manageCall</id>
<label>finesse.container.tabs.supervisor.manageCallLabel</label>
</tab>
<!--
The following Tab and Gadget are used for WebChat and Email. They are *ONLY* supported with WebChat and Email. If you are not
using WebChat or Email, then
remove them. If you are using WebChat or Email, include this Gadget in the Desktop Layouts used by Teams associated with chat or
email
CSQs. To include this functionality:
1) Remove these comments leaving the tab and gadget
2) Replace all instances of "my-socialminer-server" with the Fully Qualified Domain Name of your SocialMiner Server.
3) [OPTIONAL] Adjust the height of the gadget by changing the "gadgetHeight" parameter.

IMPORTANT NOTE:
- In order for this Gadget to work, you must have performed all documented prerequisite steps.

RESTRICTIONS:
- The multisession-reply-gadget must not be configured as a page level gadget
- The multisession-reply-gadget must not be configured in a column

<tab>
<id>manageNonVoiceMedia</id>
<label>finesse.container.tabs.supervisor.manageNonVoiceMediaLabel</label>
<columns>
<column>
<gadgets>
<gadget>https://my-socialminer-server/multisession/ui/gadgets/multisession-reply-gadget.jsp?
gadgetHeight=430</gadget>
</gadgets>
</column>
</columns>
</tab>
-->
<!--
The following Tab and Gadget are for MediaSense. They are *ONLY* supported with MediaSense. If you are not using MediaSense,
then remove them. If you are using MediaSense and wish to show Recording Management, then do the following:
1) Remove these comments leaving the tab and gadget
2) Replace all instances of "my-mediasense-server" with the Fully Qualified Domain Name of your MediaSense Server.

IMPORTANT NOTE:
- In order for this Gadget to work, you must have performed all documented prerequisite steps.

<tab>
<id>manageRecordings</id>
<label>finesse.container.tabs.supervisor.manageRecordingsLabel</label>
<columns>
<column>
<gadgets>
<gadget>https://my-mediasense-server:8440/ora/gadget/MediaSenseGadget.xml</gadget>
</gadgets>
</column>
</columns>
</tab>
-->
</tabs>
</layout>
</finesseLayout>

S-ar putea să vă placă și