Cisco Finesse Configuration
This chapter contains the configuration procedures you must perform to configure Cisco Finesse. Perform the procedures on the Cisco Finesse Primary node.
The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.
This chapter contains the configuration procedures you must perform to configure Cisco Finesse. Perform the procedures on the Cisco Finesse Primary node.
In order to test the Live Data reports in the Finesse desktops, configure the following in Unified CCE Administration ( https://<Side A/B Unified CCE AW-HDS-DDS IP address>/cceadmin):
Agents
Skill groups or precision queues
Call types
Dialed numbers
Network VRU scripts
Routing scripts
Note |
Routing scripts are configured in Script Editor, which you can open from Unified CCE Administration Tools. |
For instructions, see the Cisco Packaged Contact Center Enterprise Administration and Configuration Guide at https://www.cisco.com/c/en/us/support/customer-collaboration/packaged-contact-center-enterprise/products-maintenance-guides-list.html.
Cisco Unified Intelligence Center provides Live Data real-time reports that you can add to the Finesse desktop.
Before you add Live Data reports to the desktop, you must meet the following prerequisites:
Download the Live Data reports from Cisco.com and import them into Cisco Unified Intelligence Center. Verify that the reports are working in Unified Intelligence Center.
Ensure that user integration synchronization is enabled for Cisco Unified Intelligence Center. For more information, see Administration Console User Guide for Cisco Unified Intelligence Center https://www.cisco.com/c/en/us/support/customer-collaboration/unified-intelligence-center/products-maintenance-guides-list.html.
For HTTPS, you must upload security certificates to the Finesse and Cisco Unified Intelligence Center servers. Both Finesse and Cisco Unified Intelligence Center are installed with self-signed certificates. However, if you use the self-signed certificates, agents and supervisors must accept certificates in the Finesse desktop when they sign in before they can use the Live Data gadget. To avoid this requirement, you can provide a CA certificate instead. You can obtain a CA certificate from a third-party certificate vendor or produce one internal to your organization.
The following sections describe how to add the Live Data reports to the Finesse desktop. The procedure that you follow depends on several factors, described in the following table.
Procedure |
When to use |
---|---|
Add Live Data reports to default desktop layout |
Use this procedure if you want to add Live Data reports to the Finesse desktop after a fresh installation or after an upgrade if you have not customized the default desktop layout. |
Add Live Data reports to custom desktop layout |
Use this procedure if you have customized the Finesse desktop layout. |
Add Live Data reports to team layout |
Use this procedure if you want to add Live Data reports to the desktop layout for specific teams only. |
The Finesse default layout XML contains commented XML code for the Live Data report gadgets available for the Finesse desktop. The gadgets are divided into two categories: HTTPS version of Live Data gadgets and HTTP version of Live Data gadgets.
This procedure explains how to add the Live Data report gadgets to the default desktop layout. Use this procedure after a fresh installation of Finesse. If you upgraded Finesse but do not have a custom desktop layout, click Restore Default Layout on the Manage Desktop Layout gadget and then follow the steps in this procedure. Note that line breaks and spaces that appear in the example text are provided only for readability and must not be included in the actual code.
Step 1 |
Sign in to the Finesse administration console (https://FQDN of Finesse server:Port Number(8445)/cfadmin), in which FQDN refers to the fully qualified domain name. |
||
Step 2 |
Click the Desktop Layout tab. |
||
Step 3 |
Remove the comment characters (<!-- and -->) from each report that you want to add to the desktop layout. Make sure you choose the reports that match the method your agents use to access the Finesse desktop (HTTP or HTTPS). |
||
Step 4 |
Replace my-cuic-server with the fully qualified domain name of your Cisco Unified Intelligence Center Server. |
||
Step 5 |
Optionally, change the gadget height. Example:The height specified in the Live Data gadget URLs is 310 pixels. If you want to change the height, change the gadgetHeight parameter in the URL to the desired value. For example, if you want the gadget height to be 400 pixels, change the code as follows, replacing 310 with 400:
To maintain the optimal display of the gadget with scroll bars, set the value for the gadget height to a minimum of 200 pixels. If the report does not require scroll bars, for example a one-row report, you can set a smaller gadget height (for example, 100 pixels). If you do not specify anything for the gadget height (if you remove the 310 from the URL), it defaults to 170 pixels. |
||
Step 6 |
Click Save.
|
The Finesse default layout XML contains commented XML code for the Live Data report gadgets available for the Finesse desktop. The gadgets are divided into two categories: HTTPS version of Live Data gadgets and HTTP version of Live Data gadgets.
This procedure explains how to add the Live Data report gadgets to a custom desktop layout. Note that line breaks and spaces that appear in the example text are provided only for readability and must not be included in the actual code.
Step 1 |
Sign in to the Finesse administration console. |
||
Step 2 |
Click the Desktop Layout tab. |
||
Step 3 |
Click Finesse Default Layout XML to show the default layout XML. |
||
Step 4 |
Copy the XML code for the report you want to add from the Finesse default layout XML. Example:To add the Agent Report for HTTPS, copy the following:
|
||
Step 5 |
Paste the XML within the tab tags where you want it to appear. Example:To add the report to the home tab of the agent desktop:
|
||
Step 6 |
Replace my-cuic-server with the fully qualified domain name of your Cisco Unified Intelligence Center Server. |
||
Step 7 |
Optionally, change the gadget height. Example:The height specified in the Live Data gadget URLs is 310 pixels. If you want to change the height, change the gadgetHeight parameter in the URL to the desired value. For example, if you want the gadget height to be 400 pixels, change the code as follows:
To maintain the optimal display of the gadget with scroll bars, set the value for the gadget height to a minimum of 200 pixels. If the report does not require scroll bars, for example a one-row report, you can set a smaller gadget height (for example, 100 pixels). If you do not specify anything for the gadget height (if you remove the 310 from the URL), it defaults to 170 pixels. |
||
Step 8 |
Click Save.
|
The Finesse default layout XML contains commented XML code for the Live Data report gadgets available for the Finesse desktop. The gadgets are divided into two categories: HTTPS version of Live Data gadgets and HTTP version of Live Data gadgets.
This procedure explains how to add the Live Data report gadgets to the desktop layout of a specific team. Note that line breaks and spaces that appear in the example text are provided only for readability and must not be included in the actual code.
Step 1 |
Copy the XML code for the report you want to add from the Finesse default layout XML. Example:To add the Agent Report for HTTPS, copy the following:
|
||
Step 2 |
Click the Team Resources tab. |
||
Step 3 |
Select the team from the list of teams for which you want to add the report. |
||
Step 4 |
In the Resources for <team name> area, click the Desktop Layout tab. |
||
Step 5 |
Check the Override System Default check box. |
||
Step 6 |
Paste the XML within the tab tags where you want it to appear. Example:To add the report to the home tab of the agent desktop:
|
||
Step 7 |
Replace my-cuic-server with the fully qualified domain name of your Cisco Unified Intelligence Center Server. |
||
Step 8 |
Optionally, change the gadget height. Example:The height specified in the Live Data gadget URLs is 310 pixels. If you want to change the height, change the gadgetHeight parameter in the URL to the desired value. For example, if you want the gadget height to be 400 pixels, change the code as follows:
To maintain the optimal display of the gadget with scroll bars, set the value for the gadget height to a minimum of 200 pixels. If the report does not require scroll bars, for example a one-row report, you can set a smaller gadget height (for example, 100 pixels). If you do not specify anything for the gadget height (if you remove the 310 from the URL), it defaults to 170 pixels. |
||
Step 9 |
Click Save.
|
This procedure describes how to modify the Live Data stock reports in Cisco Unified Intelligence Center and add the modified report to the Finesse desktop layout. Note that line breaks and spaces that appear in the example text are provided only for readability and must not be included in the actual code.
Note |
To make sure the modified gadget renders in the Finesse desktop, you must give the appropriate permission for that report in Cisco Unified Intelligence Center. |
Step 1 |
Copy the gadget URL for the report you want to modify from the Finesse default layout XML and paste it into a text editor. Example:If you want to modify the Agent Report for HTTPS, copy the following URL and paste it into a text editor:
|
||
Step 2 |
In Cisco Unified Intelligence Center, in Edit view of the report, select the view for which you want to create a gadget URL and then click Links. The HTML Link field displays the permalink of the customized report. |
||
Step 3 |
Copy the permalink of the customized report from the HTML Link field, and paste it in a text editor. Then copy the viewId value from this link into the desired view. Example:Copy the viewId, which is underlined in this example, from the permalink for the report.
|
||
Step 4 |
Replace the desired viewId value in the gadget URL with the viewId value from the permalink of the customized report. |
||
Step 5 |
Replace my-cuic-server with the FQDN of the Cisco Unified Intelligence Center Server. |
||
Step 6 |
Add the customized gadget URL to the desktop layout XML in the Manage Desktop Layout gadget and click Save.
|
Cisco Unified Intelligence Center allows you to display multiple Live Data reports or views on a single gadget. Agents can select the desired view to display from a drop-down list on the gadget toolbar, which lists up to five report views in Report Name - View Name format.
This procedure describes how to add multiple Live Data views to the Finesse desktop layout using the viewId_n and filterId_n keys. You can specify up to five report views to appear in your gadget. The first view among the five is the default view. There is no defined order for how the remaining views are displayed.
Finesse still supports the display of a single gadget using a single viewId. However, if you specify the single viewId along with multiple viewId_n keys, the multiple views are used and the single viewId is ignored.
Note |
To make sure the modified gadget renders in the Finesse desktop, you must give the appropriate permission for that report in Unified Intelligence Center. |
Step 1 |
For each report or view that you want to include in the gadget, obtain the associated viewId from the permalink for the view: |
||
Step 2 |
From the Finesse default layout XML, copy the gadget URL for one of the Live Data reports and paste it into a text editor. Example:Copy the URL for the Agent Skill Group for HTTPS from the default layout XML and paste it into a text editor:
|
||
Step 3 |
To update the URL to refer to a different report view, populate the viewId_1 value (after the equal sign) with the desired viewId obtained in step 1. Example:The following shows the URL updated with the example viewId copied from step 1.
|
||
Step 4 |
For each additional view you want to include: |
||
Step 5 |
Replace my-cuic-server with the fully qualified domain name of your Cisco Unified Intelligence Center Server. |
||
Step 6 |
Add the customized gadget URL to the desktop layout XML in the Manage Desktop Layout gadget and click Save.
|