Académique Documents
Professionnel Documents
Culture Documents
Automatic call distributor features, including conditional routing, call-in-queue, and expected-wait-time messages
Presence integration to help increase caller satisfaction through improved agent performance and expertise
Historical and real-time reports and dashboards with flexible presentation options using Cisco Unified Intelligence Center
A mobile skill manager feature that helps enable skill management on the go
This lab is intended to give the participant hands-on configuration experience with particular components and configuration
elements of the Unified CCX solution. The content in this lab is focused on providing a self-paced interaction experience
highlighting product features and functions specifically requested by Cisco Partners and Customers.
NOTE: Participants should have a degree of familiarity with the software, tools and methods used to deploy, configure and
maintain Cisco Customer Collaboration technologies.
Students will observe and interact including the configuration and/or installation of the following components:
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 1 of 193
Cisco dCloud
Visit the Cisco dCloud Help pages: https://dcloud-cms.cisco.com/help for more information and training materials.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 2 of 193
Cisco dCloud
Table of Contents
About This Solution ..................................................................................................................................... 1
About This Lab ............................................................................................................................................ 1
Lab Workflow ....................................................................................................................................................... 8
Modular Approach ............................................................................................................................................ 8
Lab Requirements ....................................................................................................................................... 9
Lab Configuration........................................................................................................................................ 9
Lab Topology ............................................................................................................................................... 9
Applications and Versions................................................................................................................................... 10
Lab Pre-Configuration ......................................................................................................................................... 11
Unified Contact Center Express 10.6 ................................................................................................................ 11
Dial Plan .......................................................................................................................................................... 11
Certificate Management and DNS Resolution .................................................................................................. 11
Cisco Jabber .................................................................................................................................................... 11
Connecting to Your Session ............................................................................. Error! Bookmark not defined.
Lab Orientation ......................................................................................................................................... 13
Connecting to Required Resources ..................................................................................................................... 13
Introduction .................................................................................................................................................... 13
Host Reference and Use Cases......................................................................................................................... 13
Create and Connect RDP Sessions.................................................................................................................... 14
Activity Complete ............................................................................................................................................ 15
Module 1: Cisco Agent Desktop (CAD) to Finesse Migration..................................................................... 16
Module Overview ............................................................................................................................................... 16
What is Cisco Finesse? ..................................................................................................................................... 16
CAD and Finesse Mixed Mode Operation......................................................................................................... 17
Mixed Mode Functional Caveats...................................................................................................................... 17
CAD to Finesse Recommended Approach ........................................................................................................ 17
Module Objectives .............................................................................................................................................. 18
Unified CCX 10.6(1) Configuration Review .......................................................................................................... 18
Confirm RmCm Configuration .......................................................................................................................... 18
Enterprise Data and Workflow Assignments .................................................................................................... 20
Review CAD Workflows ................................................................................................................................... 22
Verify Operation of CAD and Supervisor Desktop ............................................................................................... 26
Launch and Log in to the Cisco Supervisor Desktop .......................................................................................... 26
Launch and Log in to the Cisco Agent Desktop ................................................................................................. 26
Place a Test Call to the Customer Service Unified CCX Script Application ......................................................... 28
Enabling CAD and Cisco Finesse Mixed Mode Operation .................................................................................... 31
Confirm Status of Cisco Finesse Services .......................................................................................................... 31
Activate Cisco Finesse Services ........................................................................................................................ 32
Confirm Finesse Service Activation .................................................................................................................. 32
Configure the Customer Service Workflow in Cisco Finesse ................................................................................ 34
Finesse Administration Overview .................................................................................................................... 34
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 3 of 193
Cisco dCloud
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 4 of 193
Cisco dCloud
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 5 of 193
Cisco dCloud
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 6 of 193
Cisco dCloud
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 7 of 193
Cisco dCloud
Lab Workflow
Modular Approach
The lab consists of a series of five modules, each of which is designed to require between 45 to 60 minutes. All modules are
designed to operate independently so that students with limited time may choose those topics most important to a personalized
professional development approach.
NOTE: Modules may be completed in any order desired. The greatest learning benefit will be realized when approached in
sequential order and through completion of each activity.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 8 of 193
Cisco dCloud
Lab Requirements
The table below outlines the requirements for this preconfigured lab activity.
Required Optional
Lab Configuration
This lab contains preconfigured users and components to illustrate the scripted scenarios and features of this solution. All
information needed to access the lab components is in the Topology and Servers menus of your active session.
Topology Menu. Click on any server in the topology and a popup window will appear with available server options.
Servers Menu. Click on or next to any server name to display the available server options and credentials.
Charles Holland cholland C1sco12345 Cisco Jabber for Windows 6018 cholland@dcloud.cisco.com
Anita Perez aperez C1sco12345 Cisco Jabber for Windows 6017 aperez@dcloud.cisco.com
Lab Topology
This demonstration includes several server virtual machines. Most of the servers are fully configurable using the administrative
level account. Administrative account details are included in the lab guide steps where relevant and in the server details table.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 9 of 193
Cisco dCloud
UCCX1 Unified Contact Center Express 10.6(1)SU1 uccx1.dcloud.cisco.com 198.18.133.19 ccxadministrator dCloud123!
UCCX2 Unified Contact Center Express 11.0.1 uccx2.dcloud.cisco.com 198.18.133.20 ccxadministrator dCloud123!
UCM1 Communications Manager 11.0 (Call Control) ucm1.dcloud.cisco.com 198.18.133.3 administrator dCloud123!
IMP1 IM & Presence 11.0 (Presence and Chat) cup1.dcloud.cisco.com 198.18.133.4 administrator dCloud123!
CUC1 Unity Connection 11.0 (Voicemail) cuc1.dcloud.cisco.com 198.18.133.5 administrator dCloud123!
NOTE: Two passwords are used throughout this lab. Password1 (dCloud123!) is used across all Cisco Collaboration components
and Linux hosts. Password2 (C1sco12345) is used for all Microsoft Active Directory accounts including administrative, service, and
demonstration accounts. This applies to both Platform and Administrative user accounts within Cisco Collaboration Applications.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 10 of 193
Cisco dCloud
Lab Pre-Configuration
In order to save time, certain elements of this lab have been pre-configured in advance to provide a baseline starting point. Please
review this section before proceeding to the first configuration activity.
This lab focuses primarily on feature configuration using Unified Contact Center Express (UCCX) version 11.0.1, however to
illustrate the Cisco Agent Desktop (CAD) to Finesse migration process a standalone instance of Unified Contact Center Express
10.6(1) SU1 mirroring the Team, Users, Skills, CSQs and other fundamental configuration elements of the version 11.0.1 host has
been implemented.
Dial Plan
Table 2. Partitions
Partition Description
All components of this Lab environment are provisioned with SSL certificates signed by a Microsoft Windows Server 2008
Certificate Services server running on ad1.dcloud.cisco.com. Workstations used for configuration and demonstration are
provisioned to trust ad1.dcloud.cisco.com as a Trusted CA.
In addition, all Collaboration systems used in this lab are configured with Fully Qualified Domain Names and each is resolvable via
hostname lookup.
Cisco Jabber
Cisco Jabber is used exclusively for all UCCX Agent telephony functions.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 11 of 193
Cisco dCloud
Get Started
Follow the steps below to schedule your demonstration and configure your demonstration environment.
1. Browse to dcloud.cisco.com, choose the location closest to you, and then log in with your Cisco.com credentials.
4. Verify that the status of your session is Active in My Dashboard > My Sessions.
1. For best performance, connect to the workstation with Cisco AnyConnect VPN [Show Me How] and the local RDP client on
your laptop [Show Me How]
NOTE: You can also connect to the workstation using the Cisco dCloud Remote Desktop client [Show Me How]. The dCloud
Remote Desktop client works best for accessing an active session with minimal interaction. However, many users experience
connection and performance issues with this method.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 12 of 193
Cisco dCloud
Lab Orientation
NOTE: Read and Complete the Activities in this section before proceeding. Connections to lab hosts require an active
connection to the assigned Lab session via the Cisco AnyConnect VPN Client.
The student will be using a series of Remote Desktop Protocol (RDP) sessions to Microsoft Windows workstations and servers in
order to complete the following:
Interact with the Unified CCX Applications and Tools used in this lab
In this activity, the student will configure and connect the RDP sessions required and referenced throughout the lab.
NOTE: Connections to lab hosts require an active connection to the assigned session through the Cisco AnyConnect VPN Client.
The table below identifies the hosts, use cases, and credentials required when connecting.
Throughout this guide, steps will instruct the student to Open or Switch to the RDP session connected to one of the hosts
referenced above. These statements always reference the FQDN of the host accompanied at times by contextual information. All
FQDNs should be resolvable directly from the student workstation (while connected to session via VPN - required), however IP
addresses may be used as well.
o Use Cases: Workstation 1 is the primary anchor point for configuration activities in addition to hosting the Cisco
Supervisor Desktop client for lab user Charles Holland
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 13 of 193
Cisco dCloud
o Use Cases: Workstation 2 is assigned to lab user Anita Perez. Workstation 2 is used only for demonstration and
testing of features
o Use Cases: AD1 is used as part of Module 3 in order to host the Web Form for Unified CCX WebChat.
NOTE: These Steps will be repeated for each host specified, until an active connection has been created for each.
1. Click Start > All Programs > Accessories > Remote Desktop Connection.
2. Click Options.
6. Click OK.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 14 of 193
Cisco dCloud
9. Click the General tab and fill in the Computer and Username fields based on the table below, according to the host to which
you are connecting:
11. (Optional) Click Save and use the Save As file dialog to name and save the session definition to your computer.
13. When prompted, enter the Password: C1sco12345 and click Remember my credentials.
Activity Complete
This activity is complete when the student has three active RDP sessions to the hosts listed in the table above.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 15 of 193
Cisco dCloud
Module Overview
In this Module, we will explore the process for migrating a team of Unified CCX Agents and Supervisors who are using the Cisco
Agent and Supervisor Desktop applications to Cisco Finesse. This is a common situation for existing CCX installations, and is
required prior to upgrading to Unified Contact Center Express 11, which no longer maintains support for the CAD/CSD client
applications. In order to maintain consistency of service, CAD workflows and configuration elements must be migrated to Finesse
prior to an upgrade to Unified CCX 11.
Finesse is a browser based Single Customizable Desktop Interface for both Agents and Supervisors. The interface is a compilation
of customizable tables for various desktop layouts. It allows the Agent to change their state and interact with CRMs, 3rd Party
tools, Recording or reporting via customizable Gadgets.
Cisco Finesse can use third Party Gadgets to imbed applications into its interface or using REST API imbed the Finesses API into
a customers own application.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 16 of 193
Cisco dCloud
Mixed mode operation can be summarized as a situation in which at least one team(s) of Unified Contact Center Express
Agents/Supervisors are leveraging the CAD and CSD client tools to log in and accept ACD calls, while Cisco Finesse Desktop
services have been activated on the Unified CCX server or HA cluster.
Mixed mode operation is intended to facilitate Agent migration to the Cisco Finesse Desktop and first became available with
Unified CCX release 10.6(1). It requires the application of a Cisco Options Package to enable the functionality. With the
subsequent release of Unified CCX 10.6(1) SU1, the Cisco Options Package is no longer required (or available) and mixed mode
capability is included in the release.
NOTE: In order to run in Mixed Mode you must upgrade to Unified Contact Center Express 10.6(1)SU1 or greater.
When CAD Finesse Mixed Mode operation is enabled, the following functional caveats must be observed:
The Agent Web Chat feature is ONLY available when using Cisco Finesse Desktop.
The Agent E-mail feature is ONLY available when using Cisco Finesse Desktop.
Cisco Finesse supervisors CANNOT access recordings previously made with CAD or CSD. It is recommended to archive
the recordings made with CAD and CSD.
Because of these functional limitations when operating in mixed mode it is imperative that certain guidelines be followed when
enabling this mode of operation with the intention of migrating from CAD to Finesse.
A team is defined as one or more supervisors managing a group of agents receiving contacts from one or more Contact Service
Queues (CSQs).
Agents and supervisors should be migrated by team where all agents and supervisors within a single team use either
Finesse or CAD/CSD exclusively. Supervisors logged into CSD CANNOT manage agents logged into Finesse and
reverse is also true.
Prior to migration of a team, Cisco Finesse workflows matching those functional capabilities of the CAD workflow should
be created.
Move all Agents who handle Chat and Email to Finesse at the same time and as soon as possible after enabling Finesse
services. These functions will only be available when using the Finesse desktop.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 17 of 193
Cisco dCloud
Module Objectives
In this module, we will migrate the Customer Service agent team currently using the Cisco Agent Desktop and Cisco
Supervisor Desktop to Cisco Finesse by performing the following tasks:
Review the Unified CCX identifying active Teams and CAD workflows to be migrated to Cisco Finesse
Test current inbound call routing and CAD voice workflow and observe results
Charles Holland Acts as both a Supervisor and Agent for the 6018 cholland C1sco12345
Customer Service Team
Anita Perez Acts as the primary Agent for the Customer Service 6017 Aperez C1sco12345
team
Shannelle Macks Supervisor and Agent for Product Support (not used for 6019 smacks C1sco12345
feature demonstration)
1. Open or bring focus to the RDP session connected to wkst1.dcloud.cisco.com (Charles Holland).
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 18 of 193
Cisco dCloud
3. From the homepage, navigate to Collaboration Admin Links > Cisco Unified CCX 10.6.
7. Observe the entries for both Customer Service and Product Support.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 19 of 193
Cisco dCloud
10. From the menu, choose Subsystems > RmCm > Resources.
11. Confirm that the list of Resources matches the list below.
12. From the menu, choose Subsystems > RmCm > Contact Service Queues.
13. Confirm that the CSQs provisioned match the graphic below:
In a Unified CCX deployment using the legacy Cisco Agent Desktop (CAD) tool, we must access and navigate the Cisco
Desktop Administrator web interface to identify certain components of the voice contact workflow including:
Call Variable Data captured through the execution of a Unified CCX application script
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 20 of 193
Cisco dCloud
1. Use the menu in the upper right of the Unified CCX Administration page to choose Cisco Desktop Administrator.
2. Click Go.
3. From the navigation pane on the left, click the + (plus sign) next to the Services Configuration label.
4. Expand Enterprise Data by clicking the + (plus sign) directly to the left of the label.
6. Locate the Search For filter and type Call V. Click Find.
7. The following Custom Call Variables (also referred to as Peripheral Call Variables in the UCCX Script editor), are being
written for each incoming call:
Call Variable 1 The type of customer inquiry represented by a string of text is stored and set in this variable. This data
is both written to the CCX database and presented to the Customer Service agent. Possible options are:
o New Order
o Existing Order
o Other
Call Variable 2 The Unified CCX Script captures the Calling Number (ANI) of the incoming voice contact and the data
is both recorded in this variable and presented to the Customer Service agent.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 21 of 193
Cisco dCloud
NOTE: A full analysis of the data collected during Unified CCX application script execution and how certain data elements are
associated with a contact is part of Module 2: Advanced Unified CCX Scripting Techniques.
8. From the navigation pane on the left, click the + (plus sign) next to the Personnel label.
10. Confirm that both Charles Holland and Anita Perez are assigned to the Customer Service Workflow Group. This is how a
CAD Workflow configuration is applied to a Unified CCX Agent.
Next, we will use the Cisco Desktop Administrator application to review the assigned Workflow Configuration identified in the
previous step. Of particular importance will be the following:
Phone Books
Voice Contact Work Flow Actions (Macros) applied to members of the Customer Service team. These items will need
to be replicated as Cisco Finesse workflows.
1. Launch the Cisco Desktop Administrator utility by clicking on the icon in the taskbar of wkst1.dcloud.cisco.com.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 22 of 193
Cisco dCloud
2. Use the Left hand navigation pane to expand Call Center 1 > Work Flow Configuration > Work Flow Groups > Customer
Service. Click Reason Codes.
3. Observe that the following Reason Codes are assigned to the Logout function:
4. Click the Not Ready tab to review the assigned reasoned codes.
5. Confirm that the following Reason Codes are assigned to the Not Ready function:
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 23 of 193
Cisco dCloud
6. Review the configured Phone Book for this Workflow Group by clicking the Phone Book menu option from the menu tree.
8. As part of the Cisco Agent Desktop to Cisco Finesse migration process, any provisioned Phone Books should be
Exported as CSV files for later import into the Cisco Finesse Desktop Administration portal. Click Export.
13. From the left hand navigation pane expand CAD Agent and choose Voice Contact Work Flows.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 24 of 193
Cisco dCloud
15. From the Voice Contact Work Flow configuration editor, choose the entry for Answered under Events.
16. Under Rules highlight CallAnswered, and then choose Finesse Sample Gadgets.
17. Click Edit to view the actions associated with this rule.
18. Notice that this is a simple HTTP Get Action, the result of which is pushed to the main browser window of the Cisco Agent
Desktop. When a call is Answered by an agent, the integrated CAD browser will redirect to the Cisco Finesse Sample
Gadgets page hosted on Cisco DevNet.
19. The URL to which the browser is redirected is a concatenation of Protocol, Host, and Path. In our case:
https://developer.cisco.com/site/finesse/downloads/sample-gadgets.
20. Click Cancel to exit the HTTP Action Setup configuration dialog.
21. Close the Cisco Desktop Workflow Administrator application by clicking the X in the upper right-hand corner of the window.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 25 of 193
Cisco dCloud
1. From the desktop of wkst1.dcloud.cisco.com, launch the Cisco Supervisor Desktop application by clicking on the icon in
the taskbar.
2. If prompted regarding an incompatible JRE version for agent e-mail, click No.
3. In the Log in field type cholland. In the Password field, type C1sco12345.
4. Click OK.
6. From the Select Team drop down menu, choose Customer Service.
7. Note that there are currently no agents actively logged in and taking calls.
9. Launch the Cisco Agent Desktop application by clicking on the icon in the Windows taskbar.
NOTE: Cisco Jabber is used exclusively as the agent telephony endpoint for these lab exercises. Jabber is already running on
both wkst1.dcloud.cisco.com and wkst2.dcloud.cisco.com and is configured to launch and authenticate at Windows Login.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 26 of 193
Cisco dCloud
ID: aperez
Password: C1sco12345
Extension: 6017
12. Confirm that log in is successful and that Cisco Agent Desktop indicates that it is in Full Service and Anita Perez is in the
Not Ready state by default.
13. Observe that the CAD integrated browser tab is configured to use www.google.com as the start page.
14. Transition Anita Perez to a Ready state by clicking the associated icon on the CAD menu bar.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 27 of 193
Cisco dCloud
17. If necessary, bring the Cisco Supervisor Desktop application into focus.
18. Click the + (plus sign) to the left of Agents in the navigation pane on the bottom left. Observe that Anita Perez is now logged
in and in a Ready state.
Place a Test Call to the Customer Service Unified CCX Script Application
Next, we will place a test call to verify operation of the CAD application and the results of the configured Cisco Agent Desktop
workflow reviewed earlier. You may either use the Cisco Jabber client on wkst1.dcloud.cisco.com or dial through the PSTN
directly.
NOTE: The preferred method of UCCX script testing is via dial-in from the PSTN. This is to ensure clearer prompt playout and
higher overall call quality.
1. Locate the Session Details tab for your lab session in dCloud. This will list the automatically assigned DIDs for the session
and the Directory Number (DN) to which to the DID corresponds. In this case, you should locate the DID associated with
Directory Number 7800. Consult the graphic below for reference.
2. From a telephone with long distance dialing capability, dial the DID listed. In the example above (Figure 36) the number would
be +1(919) 474-5520.
3. Alternatively, from the Cisco Jabber client on wkst1.dcloud.cisco.com(Charles Holland) type: 7800 into the Call or Search
field and press Enter or click the green call button.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 28 of 193
Cisco dCloud
5. Press 1 on the telephone or Cisco Jabber keypad to continue. Based on the menu option you choose the icd.aef script sets
the value of the strInquiryType String variable to New Order.
6. Switch to the RDP session connected to wkst2.dcloud.cisco.com (Anita Perez) in order to answer the incoming call.
7. Click the Answer/Drop button on the Cisco Agent Desktop menu bar to answer the call.
8. Observe that the following call data is passed to the CAD client and that the integrated browser has performed a redirect to
the Finesse sample gadgets page on Cisco DevNet.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 29 of 193
Cisco dCloud
NOTE: Recall that in our configuration review we identified that Call Variable 1 is programmed to hold the value for Inquiry Type.
This is achieved by using a Set Enterprise Call Info step from within the Unified CCX Script Palette and setting that value equal to
the contents of the strInquiryType variable. Module 2 Advanced Unified CCX Scripting Techniques, provided detailed coverage
of this topic.
9. If the results of the test call are similar to those displayed in the graphic above then we have successfully confirmed the action
of the Unified CCX script application, parsing of call variables, and the expected behavior of the configured Cisco Agent
Desktop workflow actions associated with the workflow group is matched.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 30 of 193
Cisco dCloud
At this point, we are ready to activate Cisco Finesse services and enter Mixed Mode operation in preparation to migrate the
Customer Service team from CAD/CSD to Cisco Finesse.
In Unified CCX version 10.6(1) and earlier, Finesse services must be explicitly enabled by a system administrator. This process
requires authentication using the platform administrator account and access to the Unified CCX CLI interface.
3. Launch the PuTTY terminal emulator by clicking the icon [ ] in the windows taskbar.
5. Click Open.
7. Type the following command followed by the Enter key to validate that Cisco Finesse is currently deactivated:
8. Ensure that the status of the Cisco Finesse Tomcat service is [STOPPED] Service Not Activated.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 31 of 193
Cisco dCloud
9. Activate Cisco Finesse by typing the following command followed by the Enter key.
10. When prompted: Do you want to proceed? Type yes and press the Enter key.
11. The Cisco Finesse activation process will commence. You should be prompted as below.
NOTE: It may take several minutes for Cisco Finesse activation to complete.
12. Once complete, a message indicating successful activation and the requirement to reboot the Unified CCX server will be
displayed.
13. To finalize the Cisco Finesse activation, reboot the node by typing the following command:
15. After system shutdown, the active PuTTY session will be disconnected. Acknowledge any messages displayed and close the
PuTTY window.
1. Launch the PuTTY terminal emulator by clicking the icon in the windows taskbar.
5. Type the following command followed by the Enter key to list the state of all services with pagination to ensure that Cisco
Finesse has been activated:
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 32 of 193
Cisco dCloud
6. Press the Space Bar key to scroll through installed services until you see the entry for Cisco Finesse Tomcat.
7. Ensure that the status of the Cisco Finesse Tomcat service is [STARTED].
8. Close the PuTTY application and acknowledge the prompt to complete the exit process.
9. An additional validation check for the successful activation of Cisco Finesse can be performed using a web browser. Switch
application focus to Mozilla Firefox and open a new tab.
10. Type or paste the following URI into the browser window:
https://uccx1.dcloud.cisco.com:8445/finesse/api/SystemInfo
The browser will render an XML configuration file as demonstrated in the graphic below. Confirm that the status element is
populated as follows: <status>IN_SERVICE</status>.
11. Congratulations, Cisco Finesse is activated and Unified CCX is operating in Mixed Mode.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 33 of 193
Cisco dCloud
In order to complete the migration of the Customer Service team, a corresponding workflow in Cisco Finesse matching the
existing workflow in CAD must be configured to allow continuity of service through the migration process.
The Finesse Administrator builds the layout of the Finesse desktop, customizing it to provide Agents with all the necessary tools
at their fingertips. Finesse Administrator is used for Defining Call Variables, Desktop layouts, populating Phonebooks, defining
Reason Codes, Team Resources and finally Team Workflows.
Call Variables: Determine how call variables are set during Unified CCX script execution will appear in the Agent Desktop view.
You may define one Call Variable in the Call Header Layout and up to 20 in the two columns below the header.
Desktop Layout: Gadgets and Tabs are defined and uploaded to the Gadget repository.
NOTE: Module 4 Gadget Creation and Customization Tutorial explores in detail the feature and function of Finesse Gadgets
and how to customize and implement them within the Finesse Desktop Layout.
Phone Books: Administrators have the ability to create a single phone book for a single team or for all agents. These phone books
can be populated either via the Gadget or through CSV import. CSV export is also possible for backing up, updating an existing
phone book or creating a new phone book. Be aware of the following maximums:
Reason Codes: Admins can View, Add, Edit, and/or Delete reason codes on a global or team specific basis. Any changes or
additions take three (3) seconds to take effect and any logged in Agents must logout and log in again to see the changes.
1. From any tab of the Mozilla Firefox browser, click the Mozilla Firefox Start Page icon [ ].
2. From the homepage, navigate to Collaboration Admin Links > Cisco Unified CCX 10.6.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 34 of 193
Cisco dCloud
4. From the Navigation drop-down menu choose Cisco Finesse Administration and click Go.
NOTE: You can access Finesse Administration using the following URI directly: https://uccx1.dcloud.cisco.com:8445/cfadmin.
5. Log in to Cisco Finesse Administration with ID: administrator and Password: dCloud123!
Call Variables are used to display extra information to Agents on an accepted call. Displayed in three areas of the Manage Call
gadget on the Agents Finesse desktop, these can include but are not limited to Account numbers or a Callers Name. Both
columns, Call Body Left-Hand and Call Body Right-Hand, may be empty if desired.
Display Name: A label that describes the data expected to be contained in the variable. For example: Inquiry Type
Variabe: The name of a Unified CCX custom call variable (Peripheral Call Variable) or a user defined Extended Call
Control (ECC) variable.
Variables can be added or deleted based on the customer use case. There is a maximum limit of 10 variables configurable per
column. Once this maximum is reached, the Add Row button is disabled for that respective column.
We will now modify the default Call Variables layout to reflect the call data collected by our deployed Unified CCX script
application and presented via the CAD. Our goal is to match the current Agent experience as closely as possible.
1. Modify the Call Variables Layout from the default by deleting any unused variables from the Call Body Left-Hand Column
and Call Body Right-Hand Column layouts, leaving two variables in each.
2. Change the Display Name of the Call Header Layout to Inquiry Type. Use the drop-down menu to choose callVariable1
and set it as the value of the Variable field.
3. Change the Display Name of the first listed variable in the Call Body Left-Hand Column to Inquiry Type. Use the drop-
down menu to choose callVariable1 and set it as the value of the Variable field.
4. Change the Display Name of the second listed variable in the Call Body Left-Hand Column to Calling Number. Use the
drop-down menu to choose callVariable2 and set it as the value of the Variable field.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 35 of 193
Cisco dCloud
6. Click Save. A message indicating Successfully saved settings is displayed in the upper right-hand corner of the page.
Desktop Layout
The Desktop Layout configuration determines what the Agents Finesse client will display. This includes how to answer an
incoming call, record a call, and connect to any CRM integrations. Each functional element is called a Gadget. From this location,
the default behavior of the Cisco Finesse Desktop is defined. Changes to the default layout take 10 seconds to take effect. Any
agents / supervisors signed in must sign out and sign back in again to see the new changes. Changes are made in the Finesse
Layout XML area. Finesse will validate the XML file to ensure that it is valid XML syntax and conforms to the Finesse schema.
We will go into further depth regarding the configuration of Finesse Gadgets and modification to the default Finesse layout in
Module 4 Finesse Gadget Customization Tutorial.
NOTE: The Cisco Finesse Agent and Supervisor Layouts remain the default which disables all references to WebChat and Agent
Email gadgets. This is because Unified CCX WebChat and Finesse Agent Email provisioning are covered in Module 3.
Recall that during the validation activity we observed a Phone Book currently in use by the Customer Service team. As part of our
Cisco Desktop Administrator workflow configuration review, we exported the existing Phone book to a CSV file. In this exercise,
we will create a new Phone Book entry and populate it using an import from the CSV file saved earlier.
1. Click the hyperlink for Phone Books on the Cisco Finesse Administration webpage.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 36 of 193
Cisco dCloud
3. In the Name field, type Customer Service. From the Assign To drop-down menu, choose Teams. This will create a new
entry for a Phone Book that will be assigned to a particular agent team.
4. Click Save.
5. Click the Customer Service phone book to highlight it. This will open a list of contacts enabling an option to Import.
7. In the Import Contacts dialog, click the Browse button to launch a file explorer where the previously saved CSV file may be
selected.
9. Click Open.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 37 of 193
Cisco dCloud
In this exercise, we will add Reason Codes to Cisco Finesse that match those in use in the current Cisco Agent Desktop team
workflow. These Reasons will be assigned as resources available to members of the Customer Service agent team.
1. Click the hyperlink for Reasons on the Cisco Finesse Administration web page main menu.
2. Under the heading Manage Reason Codes (Not Ready), click the New button.
Setting Input
Global Un-Checked
4. Click Save.
5. Under the heading Manage Reason Codes (Not Ready), click the New button.
Setting Input
Global Un-Checked
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 38 of 193
Cisco dCloud
7. Click Save.
8. Under the heading Manage Reason Codes (Sign Out), click the New button.
9. Enter the following information to add the End Of Shift reason code:
Setting Input
Global Un-Checked
11. Under the heading Manage Reason Codes (Sign Out), click the New button.
12. Enter the following information to add the Lunch reason code:
Setting Input
Global Un-Checked
In this exercise, we will model a new Cisco Finesse Work Flow to match the HTTP GET action already in use by the Customer
Service agent team in CAD. This workflow will then be assigned as a Customer Service agent team resource.
1. Click the hyperlink for Workflows on the Cisco Finesse Administration webpage main menu.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 39 of 193
Cisco dCloud
2. Under the Manage Workflow Actions heading, click the New button.
3. Under the New Action dialog, enter the following information to create a Cisco Finesse Browser Pop action.
Setting Input
4. Click Save.
6. Under the New Workflow dialog, enter the following information to create a Cisco Finesse workflow for the Customer
Service agent team, which matches that currently configured for CAD.
Setting Input
8. From the Call Variable drop-down, choose callVariable2. From the Condition field drop-down, choose Is not Empty
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 40 of 193
Cisco dCloud
10. From the Add Actions pop-up, choose Finesse Sample Gadgets. Click on the X to close the pop-up.
11. Confirm that the values entered match the graphic below:
Now that all of the Workflow related elements have been provisioned via the Cisco Finesse Administration interface, we may
assign the configured elements to the Customer Service agent team, in order to complete the migration process.
1. Click the hyperlink for Team Resources on the Cisco Finesse Administration webpage main menu.
3. Observe that a Tabbed layout for resource assignment is visible at the bottom of the webpage.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 41 of 193
Cisco dCloud
6. From the Add Phone Books pop-up, choose Customer Service. Click on the X to close the pop-up.
8. Under the List of Reason Codes (Not Ready) sub-heading, click Add.
9. From the Add Reason Codes (Not Ready) pop-up, click both Break and Training to add these to the List of Reason Codes
assigned. Once finished, click on the X to close the pop-up.
11. Under the List of Reason Codes (Sign Out) sub-heading, click Add.
12. From the Add Reason Codes (Sign Out) pop-up, click both End Of Shift and Lunch to add these to the List of Reason
Codes assigned. Once finished, click on the X to close the pop-up.
15. From the Add Workflow pop-up, choose Customer Service. Click on the X to close the pop-up.
16. Scroll to the bottom of the page and click Save to activate team resource assignment.
17. This concludes the team Workflow Configuration and assignment activity.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 42 of 193
Cisco dCloud
Created a Cisco Finesse team workflow to support the Customer Service agent team.
Finalizing the process simply involves logging out of any active Cisco Supervisor and Cisco Agent Desktop application sessions
and logging in to Cisco Finesse.
1. Switch to or maintain focus on the RDP session connected to wkst1.dcloud.cisco.com (Charles Holland).
5. From the homepage, navigate to Collaboration User and Test Links > UCCX 10.6(1) Finesse Desktop.
ID: cholland
Password: C1sco12345
Extension: 6018
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 43 of 193
Cisco dCloud
8. Confirm successful log in and loading of Customer Service Agent team data (as seen in the graphic below):
NOTE: No configuration beyond specifying Supervisor permissions in Unified CCX is required to enable Supervisor functions as
well as enabling Agent functionality.
10. Bring focus the Cisco Agent Desktop application. Acknowledge any messages generated by the restart of
uccx1.dcloud.cisco.com as part of Cisco Finesse service activation by clicking OK.
12. Choose either Lunch or End of Shift as the reason code when prompted and click OK.
13. Launch Mozilla Firefox by clicking the icon in the Windows taskbar.
14. From the homepage, navigate to Collaboration User and Test Links > UCCX 10.6(1) Finesse Desktop.
ID: aperez
Password: C1sco12345
Extension: 6017
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 44 of 193
Cisco dCloud
1. Click the Not Ready menu item at the top of the Cisco Finesse Agent Desktop page.
2. Observe that the Not Ready reason codes configured as part of our migration are both present.
5. (Optional) you may choose Charles Holland from the list and click the Call button to test dialing capabilities.
6. Click the Not Ready menu item at the top of the Cisco Finesse Agent Desktop page.
7. Transition into a Ready state by choosing Ready from the Agent State menu items.
9. Observe that Anita Perez is now listed under Team Performance in a Ready state.
10. Click on Anita Perez under the Team Performance gadget. Click the Not Ready button to force Anita Perez to transition from
Ready to Not Ready. This confirms that our Finesse Supervisory functions are active.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 45 of 193
Cisco dCloud
11. From a telephone with long distance dialing capability, dial the dCloud session DID mapped to Directory Number 7800
(identified earlier in this lab).
13. Click the Not Ready menu item at the top of the Cisco Finesse Agent Desktop page.
14. Transition into a Ready state by choosing Ready from the Agent State menu items.
15. Click the Answer button to answer the incoming call. Observe that the Variable Layout changes to display call variable data
have been effective.
16. Notice that the Browser Pop Workflow action configured as part of this team workflow is successful as a new tab in Mozilla
Firefox has opened to https://developer.cisco.com/site/finesse/downloads/sample-gadgets/.
17. Switch back to Cisco Finesse Desktop by clicking browser tab labeled Cisco Finesse.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 46 of 193
Cisco dCloud
Module 1 Conclusion
We have now successfully completed the migration of the Customer Service agent team. All agents and supervisors are using
Cisco Finesse desktop to log in and handle incoming ACD contacts, with associated team workflows migrated from CAD.
With all active teams migrated to Cisco Finesse we are ready to upgrade to Unified CCX 11.0.1, and explore new features and
functions. All remaining modules in this Lab will use a Pre-Installed Unified CCX 11.0.1 instance, which matches the workflow
items reviewed in this exercise.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 47 of 193
Cisco dCloud
Module Overview
Voice contact workflows are powered by a collection of pre-defined steps and call handling logic instructions referred to as scripts.
In order to work with scripts, Cisco Unified CCX provides a powerful development environment, the Cisco Unified CCX Editor.
The Cisco Unified CCX Editor is a visual programming environment for creating, modifying, validating and debugging telephony
and multimedia application scripts in a Unified CCX System.
Using this tool a developer can create highly customized and feature rich end user experiences. Out of the Box Unified Contact
Center Express 11 provides a set of purpose driven script templates which can be used as-is or modified slightly to add
enhanced feature functionality.
In this module, we will review the currently deployed Customer Service voice workflow script (icd.aef) and highlight key
components of operation. Students will then add additional functionality to inform callers in queue of their expected wait time
(EWT).
NOTE: This module assumes previous development experience with the Cisco Unified CCX Editor application and previous
exposure to the basic concepts around creating and modifying Unified CCX application scripts.
For students new to the Cisco Unified Contact Center Express Editor or interested in furthering their current knowledgebase the
following reading is highly recommended:
Cisco Unified Contact Center Express Getting Started with Scripts, Release 11.0(1)
http://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/cust_contact/contact_center/crs/express_11_0/programming/g
uide/EditorSeriesVol1.pdf
Cisco Unified Contact Center Express Editor Step Reference Guide, Release 11.0(1)
http://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/cust_contact/contact_center/crs/express_11_0/programming/g
uide/EditorSeriesVol2.pdf
Cisco Unified Contact Center Express Expression Language Reference Guide, Release 11.0(1)
http://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/cust_contact/contact_center/crs/express_11_0/programming/g
uide/EditorSeriesVol3.pdf
NOTE: For students wishing to skip the script development process or those who encounter difficulty following the exercise, a fully
completed and updated version of the icd.aef script can be found in the Desktop\CCX-Enablement\Student-
Resources\Module2-Completed-Script folder on Workstation 1.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 48 of 193
Cisco dCloud
Module Objectives
In this module, we will use the Cisco Unified CCX Editor to modify the existing application script used for calls to the Customer
Service Team and enhance the caller experience using advanced script techniques.
Confirm the current caller experience when calling and executing the Customer Service application script
Launch the Cisco Unified CCX Editor 11.0(1) tool and review important interface elements
Open the current script and identify key elements that construct the current caller experience
Use the Get Reporting Statistic step from the Step Palette to collect Real-Time Queue information
With Data derived from the Result of the Get Reporting Statistic step, play a prompt to the caller estimating their
expected wait time
The following tables define the basic configuration of the system as part of the lab pre-configuration.
Charles Holland Acts as both a Supervisor and Agent for the 6018 cholland C1sco12345
Customer Service Team
Anita Perez Acts as the primary Agent for the Customer Service 6017 Aperez C1sco12345
team
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 49 of 193
Cisco dCloud
Next, we will log into Unified CCX and validate the current configuration of the Customer Service Script Application.
3. From the homepage, navigate to Collaboration Admin Links > Cisco Unified CCX 11.0.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 50 of 193
Cisco dCloud
2 Script SCRIPT[CCX_Enablement\icd.aef]
3 strCSQ CustomerService_Voice
The Unified CM Telephony Trigger is the Directory Number which when called will launch the Customer Service script
application. The Script defines the application script file executed when the trigger is called. The parameter strCSQ is a variable of
type String that is defined in the icd.aef script file. Because this variable is assigned the Parameter attribute, it may be modified
from within the application configuration.
NOTE: Using the Parameter attribute is an excellent way to make the most use of configured scripts. The same script may be
used for multiple applications, simply by modifying parameters at the Application level where necessary.
Locate and Download the current Customer Service Unified CCX Script File
In order to review and edit the current Unified CCX Script file we must first locate and download the file. In the following steps, we
will navigate to the Unified CCX Script repository, locate the file icd.aef and download a copy.
11. Click the hyperlink for the directory CCX_Enablement to browse to the target folder.
12. To initiate the download, left click on the icon to the left of the file named icd.aef.
13. When prompted by the Mozilla Firefox save file dialog, choose the radio button for Save File and click the OK button.
14. A copy of the icd.aef is downloaded to the default download folder: Desktop\CCX-Enablement\Downloads.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 51 of 193
Cisco dCloud
We will place a call to the CS_Voice_Main Unified CCX Application and validate the expected caller experience. In addition, we
will take on the role of a Unified CCX Agent and answer the call to observe certain data collected and configured to be presented
to the answering agent.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 52 of 193
Cisco dCloud
The baseline application script file (icd.aef) used throughout this lab is in fact a slightly modified version of the built-in Unified CCX
script queuing template freely accessible as part of the Unified CCX product installation. Elements modified include the addition of
some variables, use of custom-recorded prompts for menu and default queue messages and the addition of a basic Menu step
added as part of the initial call greeting. In addition, a Set Enterprise Call Info step is used to pass data obtained from the script to
the Cisco Finesse Desktop.
The following represents the voice contact workflow as depicted in the figure above.
2. The script answers the call using an Accept step from the Unified CCX Editor Palette.
3. A Get Call Contact Info step is used to assign the value of the calling party number (ANI) to a String variable named
strCallingNumber.
4. A Menu step is used to play the following prompt to the caller. Based on the callers keypad entry, the variable strInquiryType
is populated as described below.
Thank You for calling. For new orders, press 1. For calls regarding an existing order, press 2. For all other
inquiries, press 3 or remain on the line.
a. Caller Presses 1
b. Caller Presses 2
5. The call is sent to the CustomerService_Voice CSQ using a Select Resource script step. The target CSQ is defined within
the string variable strCSQ. As discussed earlier, this value is set as a parameter in the Unified CCX Application, the value of
which is the string CustomerService_Voice.
6. The Select Resource step checks to see if a Unified CCX Agent skilled to the CustomerService_Voice CSQ is in a Ready
state and able to take the call. The following represents the decision branch logical paths.
ii. A Play Prompt step is used to play the following generic queuing message:
All representatives are currently assisting other callers please remain on the line and your call
will be answer in the order it was received.
iii. A Call Hold step is executed to place the call on hold and begin playing the Music on Hold (MOH) audio
stream
iv. A Delay step is used to leave the call in the hold state for the number of seconds defined in the integer (int)
variable intQueueDelay (This is set to 30 seconds). After the specified interval is reached, processing
proceeds to the next defined script step
v. A Call Unhold step is used to resume control of the call and cease playing the Music on Hold audio
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 53 of 193
Cisco dCloud
vi. A GoTo step is used to send logical processing back to the beginning of the Queued execution branch,
effectively creating a loop
NOTE: If at any point during the execution of steps within the Queued branch of the Select Resource step an agent becomes
available to take the call, the call is offered regardless of the Call Hold step being invoked. The only exception to this logic is if the
Interruptible parameter of a step is explicitly set to a value of No.
vii. If an agent becomes available during the loop execution, the script will move to the Selected branch of the
Select Resource step
i. When an Agent in the specified CSQ is available and call processing moves to the Selected execution
branch of the Select Resource step
ii. A Set Enterprise Call Info step is used to assign the following script variable values to Unified CCX
Custom call variables, which may then be presented via the Cisco Finesse Desktop
1. Call.PeripheralVariable1: strInquiryType
2. Call.PeripheralVariable2: strCallingNumber
iii. A Connect step is used to route the call to the selected agent resource
1. If the call connects with the agent successfully, (Agent Answers) script execution ends at the End
step
2. If the agent fails to answer the call or a telephony system error occurs, script execution resumes at
the Queued branch
Place a Test Call to the Customer Service Unified CCX Script Application
Next, we will place a test call to confirm the caller experience and investigate the information dynamically passed from the Unified
CCX script icd.aef to the Cisco Finesse Desktop. You may either use the Cisco Jabber client on wkst1.dcloud.cisco.com or
dial through the PSTN directly. Make an effort to correlate the caller experience with the logical workflow defined above.
NOTE: The preferred method of UCCX script testing is via dial-in from the PSTN to ensure clearer prompt play out and higher
overall call quality.
1. Locate the Session Details tab for your lab session in dCloud. This will list the automatically assigned DIDs for the session
and the Directory Number (DN) to which to the DID corresponds. In this case, you should locate the DID associated with
Directory Number 6021. Consult the graphic below for reference.
2. From a telephone with long distance dialing capability, dial the DID mapped to DN 6021 as listed. In the example above, the
number would be +1(919) 474-5551.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 54 of 193
Cisco dCloud
NOTE: Each set of DIDs is unique to your lab and are assigned when the session starts. You must consult your dCloud session
details to obtain this information. The DIDs shown in this guide are examples only.
3. Alternatively, on the Cisco Jabber client on wkst1.dcloud.cisco.com (Charles Holland), type: 6021 into the Call or Search
field and press Enter or click the green call button. If Cisco Jabber is running minimized you may click on the Cisco Jabber
5. Press 1, 2 or 3 on the telephone or Cisco Jabber keypad to continue. Based on the menu option chosen, the icd.aef script
sets the value of the strInquiryType String variable as specified in the earlier call flow review activity. In our example, we
have selected option 2 for Existing Order.
NOTE: Recall that in our configuration review we identified that Call.PeripheralVariable1 is programmed to hold the value for
Inquiry Type via the strInquiryType variable. This is achieved by using a Set Enterprise Call Info step from within the Unified
CCX Script Palette and setting that value of Call.PeripheralVariable1 equal to the contents of the strInquiryType variable.
6. As there are no agent resources logged in to Unified CCX to take calls, we expect to encounter the Queued execution branch
of the Select Resource script step. Confirm that the following message played back through the telephone:
All representatives are currently assisting other callers. Please remain on the line and your call will be answered in
the order it was received.
7. Next, observe that the Music on Hold audio begins to play. This indicates the execution of the Call Hold script step. This will
continue for 30 seconds.
8. One may refer to the call flow diagram and observe that the call is now progressing through the Queuing Process portion of
the call flow. This will continue until an agent becomes available to take the call.
Log into Unified CCX as a Customer Service Agent and Accept the Call
To validate the call flow experience end-to-end, we will log in to Unified CCX as agent Anita Perez an agent skilled to the
CustomerService_Voice CSQ. We will transition to a Ready state, accept the queued call, and observe the data presented on the
Cisco Finesse Desktop.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 55 of 193
Cisco dCloud
3. From the homepage, navigate to Collaboration User and Test Links > UCCX 11.0.1 Finesse Desktop.
ID: aperez
Password: C1sco12345
Extension: 6017
6. Observe the Agent CSQ Statistics Report gadget on the Cisco Finesse Agent Desktop. Note that one call is currently in
Queue along with the total wait time. It may take several seconds to display the data at first log in. You will see a status of
Loading Report while Cisco Finesse connects to real-time reporting data and renders it.
NOTE: If the report fails to render within 30 seconds or an error is displayed, initiate a refresh of the browser page by clicking the
refresh [ ] icon directly to the right of the browser address bar.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 56 of 193
Cisco dCloud
7. To transition to a Ready state, click the Not Ready menu item at the top of the Cisco Finesse Agent Desktop page.
8. Choose Ready.
9. Observe that the queued call is offered to agent Anita Perez and that the data expected is presented via the Cisco Finesse
Agent Desktop.
10. Click the Answer button on the Cisco Finesse Desktop to answer the call.
11. Confirm that the Inquiry Type and Calling Number fields (CallVariable1 and CallVariable2 respectively) are populated with
data dynamically collected during script execution.
Inquiry Type: Existing Order (Option 2 selected at menu), or based on your choice during the menu
13. Transition to a Not Ready state, by choosing Not Ready Break from the reason code drop-down menu.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 57 of 193
Cisco dCloud
Observations
Through this testing process, we have observed that based on the Unified CCX script design the call flow and data elements
appear to be working as expected.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 58 of 193
Cisco dCloud
Cisco UCCX Editor lets you develop a wide variety of interactive scripts. Cisco UCCX Editor simplifies script development by
providing blocks of contact-processing logic in easy-to-use Java-based steps. Each step has its own unique capabilities, from
simple increment to generating and playing out prompts, obtaining user input, queuing calls, or performing database operations.
Although the steps are in Java, you do not need to understand Java to build a script. You can assemble a script by dragging step
icons from a palette on the left pane of the workspace to the design area on the right pane of the workspace. The Cisco UCCX
Editor supplies the code required to connect the steps. All you provide are the variable definitions and other parameters.
You can validate and debug the completed script to find and address logic errors directly in the Cisco Unified CCX Editor.
2. Launch the Cisco Unified CCX Editor application by locating and clicking the icon in the Windows taskbar.
3. At the Authentication form, enter the following data into the corresponding fields:
Password: dCloud123!
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 59 of 193
Cisco dCloud
6. Open the icd.aef script file by navigating to Desktop\CCX-Enablement\Downloads in the Open Script dialog.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 60 of 193
Cisco dCloud
The Cisco Unified CCX Editor window is comprised of four distinct workspaces or panes as depicted in the labeled figure below.
8. The table below provides a reference for the key areas of the Unified CCX Editor workspace. We will refer to these elements
numerous times through the following activities. Take a moment to become acquainted with these layout components before
proceeding.
1 Palette Pane Use the Palette pane to choose steps using the Unified CCX script.
2 Design Pane Use the Design pane to interact with a Unified CCX script file.
3 Message Pane Use the Message pane to view messages while validating or debugging
a Unified CCX script.
4 Variable Pane Use the Variable pane to create, modify and view variables used in the
Unified CCX script.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 61 of 193
Cisco dCloud
The table below specifies the variables used by steps within the Unified CCX Application script. Notice that some variables have
an explicit assigned value at runtime (start of script execution), while others are left with the default value. Those with assigned
values are intended to be used along with the Parameter attribute to allow certain script settings to be configurable by the
administrator. Those using default values are intended to contain data collected during script execution for processing.
intQueueDelay Int 30 An integer intended to represent Used to specify the timeout attribute of the
the desired length of the delay Delay step between the Call Hold and Call
between Call Hold and Call Unhold steps.
Unhold script steps.
pMenuPrompt Prompt P[CCX_Enablement\MainMenu.wav] Specifies the path to the wav audio Used as the prompt for the Menu step.
file to be played to a caller.
pQueuePrompt Prompt P[CCX_Enablement\QueuePrompt.wav] Specifies the path to the wav audio Provides a generic comfort message at call
file to be played to a caller. entry and between hold loops.
strCSQ String Value defined as an application CSQ route target for Select Used to define the CSQ Target value of the
parameter. Expected to be Resource step. Defined as a Select Resource step.
CustomerService_Voice at runtime. parameter on the application
strCallingNumber String This string variable is assigned the Assigned a value by the Get Call Contact
value of the contact calling number Info step. Passed to the agent as a custom
call variable using the Set Enterprise Call
Info step. (Call Variable 1)
strtInquiryType String This string variable is assigned a The value of this variable is set during
value based on caller menu execution of the Menu step based on caller
selection. input. Passed to the agent as a custom call
variable using the Set Enterprise Call Info
step. (Call Variable 2)
uAgentSelected User This variable represents the unique Derived during execution of the Select
agent id selected by the system Resource step, used by the Connect step to
during the Select Resource Step. offer the call to the specified agent extension.
There are four total data types represented by the variables defined for this script:
int
String
Prompt
User
Notice that each variable specified follows a specific and consistent naming convention:
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 62 of 193
Cisco dCloud
o Prefix in lowercase from one to three characters meant to represent the variable data type
o Descriptive name specifying the purpose of the variable or its intended data contents. This may be made up of
multiple distinct words in a single conjoined string in Camel Case notation (First Letter of each word capitalized)
CallingNumber: A descriptive name signifying this variable will hold the value of the incoming contact Calling Number
Our convention allows for consistency of execution and ease of reference given the variable Data Type and Intended purpose.
NOTE: While the Unified CCX Editor facilitates ease of script development, it is important to define conventions and standards
used in your Unified CCX scripts. Such conventions help to clarify the content of scripts when others review them and eliminate
many common programming errors and mistakes. You may use any convention for variable naming in your scripts, but ensure that
the convention is sensible and consistently applied throughout the script.
1. Change the size and position of the icd.aef script file currently open in the Design Pane to show all contents to be clearly.
2. Locate the Get Call Contact Info step and double-click to open the customizer and view the step properties.
3. Observe that as per our call flow design review the value of Calling Number attribute value is assigned to the variable
strCallingNumber.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 63 of 193
Cisco dCloud
5. Locate the Menu step. Right click anywhere on the step and choose Expand All from the context menu.
6. Observe that per our design review the strInquiryType variable is assigned a value based on selection of the caller at the
Menu step. Consult the graphic for reference.
7. Double-click the Menu step to open the customizer and view step properties.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 64 of 193
Cisco dCloud
9. Confirm that the Prompt for this step is represented by the variable pMenuPrompt. When this step executes during an active
call, the script will consult the assigned variable value and attempt to play the wav file at the path specified.
10. Click Cancel to close the properties window without making changes.
11. Scroll down slightly and locate the Select Resource step.
12. Double-click on the Select Resource step to open the properties dialog and review the applied configuration.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 65 of 193
Cisco dCloud
13. Observe the following attribute value assignments as illustrated in the figure below. Be sure to correlate these with the logical
call flow diagram reviewed earlier.
o This may also be set to Resource in the case of an Agent-based routing configuration
o The String variable strCSQ holds the value of the voice CSQ name CustomerService_Voice. Recall that an
application parameter is used to set this value from the application rather than hard-coding within the script.
o The User variable uAgentSelected stores the value of the selected Agent Resource. This value is used
immediately following in the Connect step.
15. To understand what happens when an agent is available to take a call we must analyze the Selected branch of the Select
Resource step.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 66 of 193
Cisco dCloud
16. Observe the steps defined in the Selected branch. Based on the logical call flow diagram, the following events occur:
A Set Enterprise Call Info step is used to assign the following script variable values to Unified CCX Custom call
variables which may then be presented via Cisco Finesse Desktop.
o Call.PeripheralVariable1: strInquiryType
o Call.PeripheralVariable2: strCallingNumber
A Connect step is used to route the call to the selected agent resource.
o If the call connects with the agent successfully, (Agent Answers) script execution ends at the End step.
o If the agent fails to answer the call or an error occurs, script execution resumes at the Queued branch.
17. Double-click the Set Enterprise Call Info step [ ] to open the properties dialog and review the configuration details.
NOTE: Set Enterprise Call Info is the script step that takes dynamic data stored in variables and sets the value of Custom Call
and Expanded Call Control variables. This data can now be presented along with the call to the answering agent and preserved
on subsequent transfers within Unified CCX. In addition, Call variables 1-10 are reserved within UCCX and are stored in the
Unified CCX Historical Database. Because of this property, custom reports may be run using these values to filter query results. In
Module 5, we explore how to use these custom variable values to drive custom report development.
18. Observe the following attribute value assignments as illustrated in the figure below. Be sure to correlate these with the logical
call flow diagram reviewed earlier.
This step, along with the Finesse Desktop layout allows both calling number and inquiry type data to be presented to the
agent for each call.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 67 of 193
Cisco dCloud
20. Observe the Connect step and its associated logical execution branches.
21. The Connect step is used to offer the active call to the selected Unified CCX agent selected by the system as the route
target. Observe that there are two possible branches of execution for the Connect step.
Connected: This branch of execution is taken when the call is successfully transferred to the target agent resource. The
script progresses to the End step and completes execution.
Failed: If the call is not successfully transferred to the target agent resource, because of a Ring No Answer condition or
other telephony failure the Failed execution branch is matched. Our script moves the call to a label entitled queueLoop,
which resides directly beneath the Queued branch of the Select Resource step. This is simple error handling, which
ensures that the call is not dropped but instead is re-queued and the Select Resource step permitted to search for
another suitable resource.
22. Finally scroll down to the Queued branch of the Select Resource step to review the configuration for the call queuing
experience.
queueLoop label: This label serves as an anchor point to which the call can be directed programmatically using a Goto
step. We saw an example of this earlier in the case that the call executes the Failed branch of the Connect step.
NOTE: Goto steps and Label steps work together to provide a means of moving the processing of a script based on conditional
execution. This is especially important because each Unified CCX script executes in a procedural way (Top Down) unless
explicitly directed to circumvent steps using a GoTo command.
Delay: A 1-second delay is added before the Play Prompt step. This is typically unnecessary, but due to performance
constraints of a lab environment, it is present to prevent un-intended clipping of audio play out during execution of the
Play Prompt step
Play Prompt: This step plays the wav file specified by the pQueuePrompt variable. All agents are currently assisting
other callers. Please remain on the line and your call will be answered in the order received
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 68 of 193
Cisco dCloud
Call Hold: This step places the call on hold and initiates Music On Hold (MOH) playback to the caller
Delay: A delay regulated by the value of the intQueueDelay variable ensures that the call remains on hold (playing Music
On Hold) for the number of seconds required before resuming the call and re-starting the loop. Recall that this value is 30
seconds
Call Unhold: This step resumes the call from hold and ceases the playout of Music On Hold to the caller
Goto: This command instructs script execution to jump to the queueLoop label of the script, thus facilitating a loop
behavior. Without the addition of this step, logical processing would continue to the End step
This concludes our script review. Feel free to re-read this section and compare the script steps analyzed with the expected logical
call flow. Before proceeding, you should have a high level of comfort with the mechanics of this script and be prepared to modify it
to enhance the caller experience.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 69 of 193
Cisco dCloud
Expected Wait Time (EWT) is a calculated field object available from the Get Reporting Statistic step of the Unified CCX Editor
Palette. A calculated object is value derived based on an algorithm applied to certain metrics available at the time of its calculation.
Unlike a static metric such as Longest Wait Time or Position in Queue, Expected Wait Time is a predictive value, which seeks
to present an estimate of the callers expected wait time based on several factors:
NOTE: The EWT calculation yields the most reliable result in a production system with well-established call volume patterns per
24-hr period. Because we are working in a lab with call volume generated only by calls we are placing as part of lab activities, the
values calculated may be inaccurate or seem arbitrary. Also, keep in mind that it is possible for the method to return an error
indicating that there is not enough data to calculate the value. This can happen when there are 1 or more calls in queue and no
agents in either Ready or Talking states. This is expected as the calculation is loosely (CallsInQueue +1) * AHT/Active Agents.
With no agents logged in or none in a Ready or Talking state when the call arrives, the algorithm cannot effectively calculate a
value (Division by zero condition). This is why we add error handling to the script to account for these cases and respond
appropriately.
On first arrival and during subsequent queue iterations (Call Hold, Call Unhold step cycles), the value of the callers current
expected wait time in seconds should be retrieved. If that value is greater than 0 seconds, the expected wait time should be played
back to the caller immediately following the standard comfort queue message. If the expected wait time is less than or equal to 0
seconds, the caller will hear only the standard queue prompt message.
Programmatic Requirements
Based on our stated functional objectives let us identify the programming logic or algorithm required to meet the stated
requirements.
Use the Get Reporting Statistic script step from the Unified CCX Editor palette. Using the CSQ IPCC Express Report
Object with a CSQ target of CustomerService_Voice, and a target field of Expected Wait Time
o The expected return data of the Get Reporting Statistic step is any positive integer, zero, or -1 in the case of an
erroneous result. We will use a new script variable of data type int (integer), and save the Get Reporting
Statistic result to this variable. The variable name will be intExpectedWaitTime
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 70 of 193
Cisco dCloud
2. If the calculated EWT is greater than 0 seconds, play back the value of the callers Expected Wait Time
The Get Reporting Statistic (Expected Wait Time) step returns an integer value that is calculated dynamically based on
the conditions discussed earlier; so we use a Create Generated Prompt step using Text to Speech (TTS) capabilities to
create a prompt dynamically by having the system speak the number of seconds in the intExpectedWaitTime variable.
The value generated is stored in a variable of type Prompt called pExpectedWaitTimeGenerated
To play a coherent message to the caller, which includes the generated prompt value dynamically created, we will use a
Create Container Prompt script to join or concatenate several prompts to create a continuous playback to the caller
o Use a pre-recorded prefix prompt which says Your Expected Wait Time Is
The result generated via Create Container Prompt is assigned to a variable of type Prompt named
pExpectedWaitTime, which will be activated using a Play Prompt step when desired
Use an If step to logically compare and determine if the value of intExpectedWaitTime is greater than 0 seconds
Do Nothing
Before variables can be used or referenced within script steps, they must first be defined. Based on the algorithm developed
above, it is clear that new variables must be added to the script to track and evaluate data dynamically as well as to hold the value
of a series of prompts. The following table represents the new script variables to be added and used within script steps.
intExpectedWaitTime Int 0 A variable holding integer data Store the result of a Get Report Statistic
representing the caller EWT in (Expected Wait Time) step. May be (-1, 0, any
seconds positive integer)
pExpectedWaitTimeGenerated Prompt P[] A prompt which will be a system Store the result of a Create Generated Prompt
spoken TTS prompt of numeric (intExpectedWaitTime). For example if
value of the intExpectedWaitTime is equal to 20 the system
intExpectedWaitTime variable will generate a TTS prompt which says Twenty.
pExpectedWaitTimePrefix Prompt P[CCX_Enablement\ Your expected wait time is Pre-recorded prompt used as the prefix to a
ExpectedWaitTimeIs concatenation of prompts intended to playback
.wav] expected wait time in seconds.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 71 of 193
Cisco dCloud
NOTE: Variable names and data types are case-sensitive. Ensure correct spelling and case of the names and data types above.
1. In the Unified CCX Editor application window, locate the Variable Pane and click the New Variable icon.
a. Type: int
b. Name: intExpectedWaitTime
c. Value: 0
3. Click OK.
a. Type: Prompt
b. Name: pExpectedWaitTime
c. Value: P[]
6. Click OK.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 72 of 193
Cisco dCloud
a. Type: Prompt
b. Name: pExpectedWaitTimeGenerated
c. Value: P[]
9. Click OK.
a. Type: Prompt
b. Name: pExpectedWaitTimePrefix
c. Value: P[CCX_Enablement\ExpectedWaitTimeIs.wav]
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 73 of 193
Cisco dCloud
a. Type: Prompt
b. Name: pExpectedWaitTimeSuffix
c. Value: P[CCX_Enablement\Seconds.wav]
16. Ensure the added variables are present in the Unified CCX Editor Variable Pane as shown below.
With all the required data variables defined, it is time to use the Unified CCX Editor step palette to add the script steps needed to
complete the algorithm defined earlier. Keep in mind that because a Unified CCX script executes in a procedural manner (top
down), the placement of script steps within the established logic is critical.
NOTE: When dragging and dropping steps from the Palette Pane to the Editor Window one must drag the new step and drop on
top of the step after which this new step should be executed.
The following script steps will added to the icd.aef script as part of this activity:
Use the Get Reporting Statistic step to access real-time information about agents, Contact Service Queues (CSQs), the
overall Cisco Unified CCX system, and contacts. We will use this step to obtain the projected Expected Wait Time in
seconds and save that value to the variable intExpectedWaitTime.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 74 of 193
Cisco dCloud
Use the Create Generated Prompt step to create prompt phrases from intermediate variables whose values are
dynamically determined based on run-time script information. We will use this step to create a system generated prompt
based on the value of the intExpectedWaitTime variable. We will save this prompt to the variable
pExpectedWaitTimeGenerated.
Use the Create Container Prompt step to combine multiple prompts into one larger prompt. We will use the Create
Container Prompt step to combine pre-recorded prompts with the result of the Create Generated Prompt step to
playback a coherent message to the caller. The output of this combination will be stored in the prompt variable
pExpectedWaitTime.
If Step
Use the If step to cause the script to go to one of two branches based on the evaluation of a specified Boolean
expression. We will use If/Then logic to determine whether to play the EWT prompt based on the value of the
intExpectedWaitTime variable.
Play Prompt
Use the Play Prompt step to play back specified prompts to the caller. We will use this step to play the
pExpectedWaitTime prompt.
1. Scroll to the bottom of the script file in the editor window and locate the Select Resource step.
3. From the Palette Pane of the Unified CCX Editor window, locate and expand the ACD folder by clicking the + directly to the
left of the folder name.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 75 of 193
Cisco dCloud
4. Left-click and hold the mouse on the Get Reporting Statistic step.
5. While continuing to hold the mouse, drag the cursor over the queueLoop Label step.
6. Release the mouse button to add the script step just below the queueLoop Label step.
7. Open the step customizer by double-clicking on the newly added Get Reporting Statistic script step.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 76 of 193
Cisco dCloud
10. From the Palette Pane of the Unified CCX Editor window, locate and expand the Prompt folder by clicking the + directly to
the left of the folder name.
11. Left-click and hold the mouse on the Create Generated Prompt step.
12. While continuing to hold the mouse, drag the cursor over the newly added Get Reporting Statistic step.
13. Release the mouse button to add the script step just below the Get Reporting Statistic step.
14. Open the step customizer by double-clicking on the newly added Create Generated Prompt script step.
16. From the Arguments table, choose the entry for number and click the Set button.
19. From the Arguments table choose the entry for play.full and click the Set button.
22. Locate the Output Prompt field and use the drop-down menu to choose pExpectedWaitTimeGenerated.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 77 of 193
Cisco dCloud
24. From the Palette Pane under the Prompts folder, left-click and hold the mouse on the Create Container Prompt step.
25. While continuing to hold the mouse, drag the cursor over the newly added Create Generated Prompt step.
26. Release the mouse button to add the script step just below the Create Generated Prompt step.
27. Open the step customizer by double-clicking on the newly added Create Container Prompt script step.
29. From the Add Prompt dialog, choose pExpectedWaitTimePrefix and click OK.
31. From the Add Prompt dialog, choose pExpectedWaitTimeGenerated and click OK.
33. From the Add Prompt dialog, choose pExpectedWaitTimeSuffix and click OK.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 78 of 193
Cisco dCloud
34. In the Output Prompt field, use the drop-down menu to choose pExpectedWaitTime.
36. From the Palette Pane of the Unified CCX Editor window, locate and expand the General folder by clicking the + directly to
the left of the folder name.
38. While continuing to hold the mouse, drag the cursor over the existing Play Prompt (pQueuePrompt) step.
39. Release the mouse button to add the script step just below the Play Prompt step.
40. Open the step customizer by double-clicking on the newly added If script step.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 79 of 193
Cisco dCloud
Recall: The If step is designed to evaluate a logical expression and return either a true or false (Boolean) result. The logical test
here is to determine whether the callers EWT in seconds, represented by the value of the integer variable intExpectedWaitTime,
is greater than 0. If the result is true, we will play the prompt pExpectedWaitTime. If the result is false because the value of the
intExpectedWaitTime variable is either 0 or -1, no prompt will be played.
43. From the Palette Pane of the Unified CCX Editor window, locate and expand the Media folder by clicking the + directly to the
left of the folder name.
44. Left-click and hold the mouse on the Play Prompt step.
45. While continuing to hold the mouse, drag the cursor over the true branch of the If step.
46. Release the mouse button to add the script step just below the true branch of the If step.
47. Open the step customizer by double-clicking on the newly added Play Prompt script step.
48. On the General tab of the step customizer, click the No radio button for Interruptible.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 80 of 193
Cisco dCloud
Prompt: pExpectedWaitTime
Barge in: No
52. Carefully compare your modified icd.aef script in the Unified CCX Editor with the image below to confirm the presence of
required steps and their precise placement.
With our intended modifications complete, we must now use the Validate function of the Unified CCX Editor to ensure that all
script step configuration and variable references are correct. After successful validation, we will save a copy of the update script
file. This new version of icd.aef will be used to update the Customer Service voice application.
NOTE: Script validation will catch errors involving missing variable references, incorrect Goto/Label references, and incorrectly
configured script steps. It will NOT detect logic mistakes made by the programmer.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 81 of 193
Cisco dCloud
1. From the Unified CCX Editor menu, choose Tools > Validate.
3. From the Unified CCX Editor menu, choose File > Save As.
4. Use the Save Script As file dialog to browse to the folder Desktop\CCX-Enablement\Module2.
5. Click Save.
6. Observe that the file path of the currently open script has changed to reflect the Save As operation.
7. Exit the Unified CCX Editor by choosing File > Exit from the menu.
In order to make our changes active we must upload our saved script to the Unified CCX Script Repository.
9. From the homepage, navigate to Collaboration Admin Links > Cisco Unified CCX 11.0.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 82 of 193
Cisco dCloud
10. Click the Cisco Unified Contact Center Express Administration hyperlink.
14. Click the hyperlink for CCX_Enablement to browse to the CCX_Enablement folder.
17. Use the File Upload dialog to browse to the folder Desktop\CCX-Enablement\Module2.
18. Choose the file icd.aef (saved in the previous activity), click Open.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 83 of 193
Cisco dCloud
20. When prompted to overwrite the existing script file, click OK.
21. In order to refresh both the script and the application, click Yes when prompted. This will make the uploaded script active.
NOTE: Overwriting and Refreshing a script application is a service impacting event. While the script is updated and loaded into
memory, incoming calls to the affected Unified CCX script application will fail with an error. The time duration for a refresh is
extremely narrow, but it is important to perform such changes during a scheduled maintenance window.
With all modifications to enable EWT play back to callers made and the updated icd.aef script file in place, we are ready to place a
test call to our application and verify that our advanced script update has been successful.
Recall that earlier in our activity we discussed the nature of the Expected Wait Time data field as being predictive and dependent
on having enough data to perform a calculation. In a production system with a volume of incoming calls and one or more personnel
actively taking calls, we could expect that our change would produce instant results. However because the only call traffic
generated toward this Unified CCX system is that created during the course of our lab exercises, we will need to take steps to
create the environment required for the EWT calculation to return a result.
We will begin by placing a test call from the jabber client on wkst1.dcloud.cisco.com to the Unified CCX application trigger. We
will answer the call as an Anita Perez. While leaving the conversation active we will place a second call via the PSTN to the
assigned DID. It will be from this queued call that we will observe the result of our changes in action.
2. From an earlier exercise, agent Anita Perez should be logged into the Cisco Finesse Desktop and in a Not Ready state.
NOTE: If either of the Live Data Report gadgets indicate a timeout error, simply click the [ ] icon to renew the connection.
3. In order to transition to a Ready state, click the Not Ready menu item at the top of the Cisco Finesse Agent Desktop page.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 84 of 193
Cisco dCloud
4. Choose Ready.
5. Anita Perez is now in a Ready state and will immediately receive the next incoming call.
7. In the Cisco Jabber client, type 6021 into the Call or Search field and press Enter or click the green call button. If Cisco
Jabber is running minimized you may click on the Cisco Jabber taskbar icon [ ] to bring the application into focus.
10. Switch focus to the RDP session connected to wkst2.dcloud.cisco.com (Anita Perez).
11. Click the Answer button on the Cisco Finesse Desktop to answer the call.
12. Locate the Session Details tab for your lab session in dCloud. This will list the automatically assigned DIDs for the session
and the Directory Number (DN) to which to the DID corresponds. In this case, you should locate the DID associated with
Directory Number 6021. Consult the graphic below for reference.
13. From a telephone with long distance dialing capability dial the DID mapped to DN 6021 as listed. In the example above (See
Figure 144) the number would be +1(919) 474-5551.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 85 of 193
Cisco dCloud
16. Because the only logged in agent, is currently talking, we expect to encounter the Queued execution branch of the Select
Resource script step. Our newly modified script will determine the value of the EWT CSQ statistic and if greater than 0
seconds we should hear the following:
All representatives are currently assisting other callers. Please remain on the line and your call will be answered in
the order it was received.
Your expected wait time is.. <system generated prompt for the number of seconds> seconds.
17. Next, observe that the Music on Hold audio begins to play. This indicates the execution of the Call Hold script step. This will
continue for 30 seconds.
18. The same series of messages is repeated to the caller during each queue iteration until an agent answers the call. The EWT
will be re-calculated on each iteration thus providing an update.
21. End the current call by clicking the End [ ] button on the Cisco Finesse Desktop.
Module 2 Conclusion
We have now successfully applied advanced scripting techniques to enhance the caller queuing experience by playing back the
Estimated Wait Time value. Through the completion of this activity, you analyzed and observed logical Call Workflow operations
and learned how tools available in the Unified CCX Editor make this functionality possible.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 86 of 193
Cisco dCloud
Module Overview
In the preceding lab modules, we have focused exclusively on exploring Cisco Unified Contact Center Express within the
context of voice contact workflows. Cisco Unified CCX is an incredibly robust and feature-rich customer collaboration solution,
offering not only best in breed voice contact management, but also multi-channel support for Email, Web Chat, and Social Media
contact management.
In this Module, we will explore extending the capabilities of Unified CCX through the addition of both Agent Email and Web Chat
capabilities to an existing Unified CCX voice deployment. In tandem with the power of Cisco SocialMiner it has never been easier
to provision and deploy these capabilities for your customer.
Unified CCX WebChat allows Unified CCX agents to handle customer chat requests using the agent Web Chat gadget in Cisco
Finesse. This feature requires Cisco SocialMiner to accept and relay the contact requests from a customer website.
One typical deployment scenario would involve the placement of the customer web-server and Cisco SocialMiner in the customer
DMZ. Our lab topology most closely emulates this methodology.
2. Generated html code referencing the Unified Social miner is hosted on the website, which relays the customer request to
the Cisco SocialMiner.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 87 of 193
Cisco dCloud
3. Cisco SocialMiner is configured via Unified CCX to accept the incoming request and relay it to the Cisco Unified CCX
server.
4. A ready agent receives the customer chat request in the WebChat gadget in Cisco Finesse.
Unified CCX allows email contacts to be routed to agents based on the email addresses to which customers send them. The
Cisco Finesse Agent Email feature uses skill-based routing and last-agent email routing.
Like Unified CCX WebChat, Cisco Finesse Agent Email requires the deployment of Cisco SocialMiner to handle the email and
relay the contact requests from a mail server.
The Cisco Finesse Agent Email feature requires the use of a third party mail server (Microsoft Exchange 2010 and 2013 are
supported). Cisco SocialMiner uses secure IMAP (for message retrieval) and secure SMTP (for message sending) on the
Exchange Server.
Separate CSQs are required for Email. You must associate each Email CSQ with a separate email account on the mail server.
This account must be dedicated to the Cisco Finesse Agent Email feature and may not be used for other purposes. Agent
association with Email CSQs is configured in the same manner as Voice CSQs by assigning skills and competency levels to the
CSQ.
2. The Microsoft Exchange server where the mailbox CustomerService@dcloud.cisco.com resides accepts the incoming
message.
3. Cisco SocialMiner is configured (via Unified CCX) to monitor the CustomerService@dcloud.cisco.com mailbox using
IMAP.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 88 of 193
Cisco dCloud
4. When a new message arrives this information is relayed to Cisco Unified CCX where it is routed based on the CSQ
configuration.
5. An agent in a Chat/Email ready state receives the customer email and may manage the contact in with the Cisco
Finesse Agent Email gadget.
NOTE: This is a lab environment without firewall security implemented. As such, all hosts reside on the same LAN segment. In a
production scenario, firewall rules and IP routing must be configured to allow required communication between components.
Module Objectives
In this module, we will:
Review the requirements and pre-requisites for deploying Cisco Finesse Agent Email and Unified CCX WebChat
Use the Cisco Unified CCX Administration interface to provision Cisco Finesse Agent Email and Unified CCX
WebChat
Use the Cisco Finesse Desktop Administration interface to enable the Agent Email and WebChat gadgets
Topology
Table 24. Cisco Finesse Agent Email and Unified CCX WebChat Components
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 89 of 193
Cisco dCloud
Cisco Unified CCX is installed and provisioned with an agent team and voice contact workflow as defined in the following tables.
The Customer Service team will serve as the Line of Business for which we will deploy Cisco Finesse Agent Email and Cisco
Unified CCX WebChat. Unified CCX 11.0(1) is running on uccx2.dcloud.cisco.com (198.18.133.20).
Charles Holland Acts as both a Supervisor and Agent for the 6018 cholland C1sco12345
Customer Service Team
Anita Perez Acts as the primary Agent for the Customer Service 6017 aperez C1sco12345
team
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 90 of 193
Cisco dCloud
Cisco SocialMiner 11
Cisco Social Miner is installed and is running in the environment in an un-provisioned state. You will configure the connection
between Cisco SocialMiner and Cisco Unified CCX as part of the activities in this lab. Cisco SocialMiner 11 is running on ccx-
sm1.dcloud.cisco.com (198.18.133.21).
Microsoft Exchange Server has been installed with the following configuration to accommodate Cisco Finesse Agent Email:
Secure IMAP4 communications on port 993 using an SSL certificate signed by AD1.dcloud.cisco.com.
AD1.dcloud.cisco.com is a trusted CA on all hosts in the environment including Cisco SocialMiner and Cisco Unified
CCX
Secure SMTP relay on port 587 using an SSL certificate signed by AD1.dcloud.cisco.com
Mailbox and User account for CustomerService@dcloud.cisco.com created in order to accept incoming email contacts on
behalf of the CustomerService_Email Contact Service Queue created later in the module
IIS will serve as the Web Server, which will host the Unified CCX WebChat form to accept incoming chat requests and relay to the
Cisco SocialMiner server. IIS is running on ad1.dcloud.cisco.com (198.18.133.1).
All components of this lab environment are configured with SSL certificates signed by Microsoft Windows Server 2008
Certificate Services running on ad1.dcloud.cisco.com. Workstations used for configuration and demonstration have been
provisioned to trust ad1.dcloud.cisco.com as a Trusted Certificate Authority (CA).
In addition, all Collaboration systems used in this demonstration are configured with Fully Qualified Domain Names and each is
resolvable via hostname lookup.
NOTE: All communications between components and hosts comprising the Cisco Finesse Agent Email and Cisco Unified CCX
WebChat features are secured using SSL. In a production environment, the installation of valid SSL certificates is required as a pre-
requisite to feature deployment. Certificate management for this lab has been performed using an internal Enterprise Certificate
Authority (CA). In a production environment, it is recommended to use a trusted third party Certificate Authority to secure
communications.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 91 of 193
Cisco dCloud
Unique CSQs for Chat and Email routing are required. These are Skill based CSQs and will require the creation and assignment
of particular skills which then be assigned to agents in order to make them eligible to receive incoming Chat and Email contacts.
3. From the homepage, navigate to Collaboration Admin Links > Cisco Unified CCX 11.0.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 92 of 193
Cisco dCloud
As specified earlier, we will use skill based routing for both Finesse Agent Email and WebChat contacts on this Unified CCX
System. Before configuring the Cisco Finesse Agent Email and Unified CCX WebChat features we will create the skills used to
determine agent eligibility to receive Email and Chat contacts.
To avoid confusion and best illustrate the Skill > CSQ relationship, we will create one skill for Email and one for Chat. We will
name these skills match the CSQ to which they will be assigned. See the table below for details.
3. In the Skill Name field, type: CustomerService_Chat and then click the Save button to add the new skill.
5. In the Skill Name field, type: CustomerService_Email and then click the Save button to add the new skill.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 93 of 193
Cisco dCloud
The first step in provisioning both Cisco Finesse Agent Email and Cisco Unified CCX WebChat is to define the Cisco
SocialMiner server to which this Unified CCX application cluster will pair. All configuration will be performed from the Unified
CCX Administration web interface. Unified CCX will automatically perform the provisioning operations on Cisco SocialMiner
enabling it to handle and route incoming Chat and Email requests.
NOTE: There is a one to one relationship between Cisco SocialMiner and a Cisco Unified CCX Cluster. This is to say that a
single Cisco SocialMiner server may pair with only one Cisco Unified CCX Cluster and vice-versa.
1. From the menu, choose Subsystems > Chat and Email > SocialMiner Configuration.
Figure 155. Subsystems > Chat and Email > SocialMiner Configuration
2. We will specify the details on this page to indicate the hostname and administrative username and password required to
enable Unified CCX to connect to the target Cisco SocialMiner instance.
Setting Input
Password dCloud123!
4. Click Save.
5. Observe the status message indicating that SocialMiner has been configured and the data has been saved successfully.
This confirms that the Cisco SocialMiner server joined to UCCX successfully and two-way communication established.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 94 of 193
Cisco dCloud
NOTE: After saving this data you should notice a green checkmark [ ] next to Campaigns. However, Feeds may take up to 2
minutes to transition from an alarm state. You may proceed to the next activity and check back later. Notifications will only
transition to green after having received one email and/or web chat request.
In order to provision elements of the Cisco Finesse Agent Email feature we must first specify the connection details for the
Microsoft Exchange email server where the mailboxes for Email CSQs will reside.
6. Use the menu to navigate to Subsystems > Chat and Email > Mail Server Configuration
Figure 157. Subsystems > Chat and Email > Mail Server Config
Setting Input
8. Click Update.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 95 of 193
Cisco dCloud
As with voice contacts in Unified CCX, to accept and route incoming Chat and Email contacts, CSQs are defined for the purpose.
Recall: We created two skills CustomerService_Chat and CustomerService_Email earlier in this exercise. These will be used to
specify the assigned skill requirements to be eligible to receive contacts routed to our Chat and Email CSQs.
1. From the Unified CCX Administration menu, navigate to Subsystems > Chat and Email > Contact Service Queues.
Figure 159. Subsystems > Chat and Email > Contact Service Queues
3. To create the CustomerService_Chat Contact Service Queue, enter the following values:
Setting Input
4. Click Next.
6. Click Add.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 96 of 193
Cisco dCloud
7. This operation assigns the CustomerService_Chat skill, with a required competency of 5. This means that agents must be
assigned this skill at a competency level of 5 or higher to be eligible to receive chat contacts.
8. Click Save.
9. From the Contact Service Queues (CSQs) page, click the Add New button.
Setting Input
Poll Interval 10
NOTE: The Poll Interval specifies the interval frequency in seconds that Cisco SocialMiner will attempt to fetch new mail for this
account. Valid range is from 10 to 86400. We configured this at the minimum value of 10 to ensure that email is retrieved quickly
during our testing and validation.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 97 of 193
Cisco dCloud
14. This operation assigns the CustomerService_Email skill with a required competency of 5. This means that agents must be
assigned this skill at a competency level of 5 or higher to be eligible to receive email contacts.
16. Confirm that the list of CSQs matches the graphic below:
Assigning Chat and Email CSQs to the Customer Service Agent Team
In the next section, we will associate the newly created CustomerService_Chat and CustomerService_Email Contact Service
Queues with the Customer Service agent team. This affects whether queue data is presented in the various team reporting
interfaces and supervisor tools in the Cisco Finesse Supervisor Desktop.
17. From the Unified CCX Administration menu, navigate to Subsystems > Chat and Email > Teams.
18. Click the hyperlink for Customer Service to edit the Customer Service team properties.
19. In the Available CSQs list, click the entry for CustomerService_Chat.
20. Hold the Shift key and click the entry for CustomerService_Emal to choose multiple items.
21. Click the left arrow [ ] to assign the selected CSQs to the Customer Service team.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 98 of 193
Cisco dCloud
In order to make our agents eligible routing targets for both Chat and Email contacts within the CustomerService_Chat and
CustomerService_Email Contact Service Queues, we must assign these skills to agents with competency greater than or equal
to the minimum skill competency specified by our CSQ configuration.
We will use the Assign Skills wizard to assign both Charles Holland and Anita Perez the CustomerService_Chat and
CustomerService_Email skills at a competence of 5 (the default).
1. From the menu choose Subsystems > RmCm > Assign Skills.
2. Place a checkmark in the boxes to select Charles Holland and Anita Perez.
5. Hold the Shift key and click the entry for CustomerService_Emal to choose multiple items.
6. Click the left arrow [ ] to assign the selected Skills at the default Competence Level of 5.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 99 of 193
Cisco dCloud
7. Click the Update button to assign these skills to the selected agents.
9. The CustomerService_Chat and CustomerService_Email skills are assigned a Competence Level of 5. Charles and Anita
are considered active resources in the CustomerService_Chat and CustomerService_Email Contact Service Queues.
Predefined Responses
Use the Predefined Responses page to configure and manage chat and email predefined responses. You can add a maximum of
500 chat and email responses. These responses are available in the Manage Chat and Email gadget on Finesse Agent Desktop.
You can configure the responses to be available either to all the agents or only to the agents that are associated with specific
CSQs. In this activity, we will create a pre-defined chat response for later observation.
1. From the menu, choose Subsystems > Chat and Email > Predefined Responses.
Figure 171. Subsystems > Chat and Email > Predefined Responses
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 100 of 193
Cisco dCloud
3. Create a predefined Chat response to simplify the initial agent greeting. Use the table below to complete the form:
Setting Input
Type Chat
Response Thank You for contacting us. How may I assist you today?
4. Click Save.
5. This predefined response will now be available from the Unified CCX WebChat gadget on Cisco Finesse Desktop when
replying to incoming Chat requests.
Next, we will create a Chat Web Form and Chat Widget combination. The Chat Web Form provides a mechanism for customers
to enter pertinent information regarding the reason (Problem Statement) for their contact along with contact details. This
information is then posted to the Chat Widget hosted on Cisco SocialMiner. It is used to route the contact to an assigned Chat
CSQ. As part of the creation of a Chat Widget the wizard will generate html code for a matching Chat Web Form to be hosted on
a customer website accessible from the internet. For this lab, we will use this generated code and host the resulting Web Chat
Form on the Web Server running on ad1.dcloud.cisco.com.
1. From the menu, choose Subsystems > Chat and Email > Chat Widget List.
Figure 173. Subsystems > Chat and Email > Chat Widget Llist
2. From the List Chat Web Forms configuration page, click the Add New button.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 101 of 193
Cisco dCloud
Widget Wait Message Message displayed to the customer when the customer starts a chat session.
Join Time-out Message Message displayed to the customer when a chat request is not handled within the set time.
Error Message Message displayed to the customer when CCX or chat service is not available to handle chat requests.
User Form Fields Customer Details A list of pre-defined fields, which a customer will be prompted to provide. This data will be available to
an answering agent in the Finesse WebChat gadget.
Setting Input
5. Under the User Form Fields heading from the Available Fields list, click the entry for Name.
6. Hold the Ctrl key and click the entry for Email and the entry for PhoneNumber to choose multiple items.
7. Click the right arrow [ ] to assign the selected Fields to the Web Form.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 102 of 193
Cisco dCloud
9. Next, create a Problem Statement to be used by the WebChat Widget to route the request to a specified CSQ. Use the
parameters in the table below:
Setting Input
11. The next page displays a preview of the Web Form generated during the configuration process. Notice that the Name, Email,
and Phone Number fields are present. A single problem statement entitled Product Order Support is available via the drop-
down menu.
13. The final page of the Chat Web Form Configuration wizard displays the generated html code for the Web Form created
through the configuration process.
14. Use your mouse to select all text within the Generated Code window between the <html> and </html> tags.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 103 of 193
Cisco dCloud
15. With your mouse positioned anywhere over the highlighted text, right-click and choose Copy from the context menu.
16. Open the Notepad application on wkst1.dcloud.cisco.com by clicking the icon [ ] in the windows taskbar.
17. Anywhere within the Notepad application window, right-click with your mouse and choose Paste from the context menu.
NOTE: We will use the generated code in a later step to complete the process of hosting an html web form.
19. Switch application focus back to the Mozilla Firefox browser and click the Done [ ] button.
The settings defined here allow administrators to customize the behavior of the Chat and Email contact channel parameters. These
are global values applied to ALL Chat and Email Contact Service Queues created. Let us take a moment to review the channel
configuration options.
1. Click the Mozilla Firefox browser tab connected to the Cisco Unified CCX Administration web page.
2. From the menu, choose Subsystems > Chat and Email > Channel Parameters.
3. Review the parameters listed in the table below to understand their purpose.
Chat No Answer Timeout (Seconds) The time allotted for an agent to respond to the chat request after which, the chat request is routed back to the
chat queue.
Chat Join Timeout (Minutes) The time after which the customer initiates a chat and, if an agent is not joined, the customer gets a message
indicating that chat is currently unavailable. An agent may still join the chat after this timeout expires.
Chat Inactivity Timeout (Minutes) The customer inactivity time after which, the system ends the chat. (Customer side only)
Chat Offer Chat Contact When On Choose Yes to allow agents to handle an incoming chat while on a voice call.
Voice Call
Chat Offer Voice Call When On Chat Choose Yes to allow agents to handle an incoming voice call while in an active chat session.
Chat Maximum Number of Chat A range of 1-5, specifying how many concurrent chat sessions an agent is allowed to handle.
Sessions Per Agent
Email Maximum Number of Email A range of 1-5, specifying how many concurrent email sessions and agent is allowed to handle.
Sessions Per Agent
Email Sticky Email Timeout (Hours) Specify the amount of time for which an email message waits for a reply from a specific agent. Sticky email
routing (Last-agent email routing) is a mechanism to route an email message to the agent who handled the last
leg of the email conversation. When an email message, which is part of an ongoing conversation, comes in
and the agent who handled the last leg of the conversations is not available, the email will wait for the time
specified by this parameter. Valid ranges are 1-120 hours.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 104 of 193
Cisco dCloud
NOTE: These parameters should be reviewed and set based on the business case for a particular contact center environment. For
example, the Sticky Email Timeout value would be much higher in cases where consistency of ownership of a particular email
contact (usually based on the nature of the contact) is of higher importance than the speed at which a reply is generated to back to
a customer. These values allow you to customize the behavior of the system to meet the business objectives of your customer.
All Chat and Email provisioning needed to enable Cisco Finesse Agent Email and Cisco UCCX WebChat is now complete.
1. From the Navigation menu of the Cisco Unified CCX Administration web page, choose Cisco Finesse Administration.
2. Click Go.
NOTE: Finesse Administration can be accessed directly using the following URI: https://uccx1.dcloud.cisco.com:8445/cfadmin.
7. Log in to Cisco Finesse Administration with ID: administrator and Password: dCloud123!.
4. The default Cisco Finesse Desktop layout includes code to enable the WebChat and Agent Email gadgets; however, it is
commented out and therefore ignored by the rendering engine.
5. Observe near the top of the current layout there is a commented section of code for the WebChat and Email gadget. The
beginning of a comment is denoted by a <!-- including all text until the comment end denoted by -->.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 105 of 193
Cisco dCloud
Removing the comment markers as well as the comment text and leaving only the gadget delimitations enables the gadget. There
are six distinct commented areas within the layout file and two locations where the hostname of the Cisco SocialMiner server
must be inserted. To save time, a pre-edited copy of the Finesse Desktop Layout file has been created for use in this activity.
6. Locate the pre-configured Finesse Desktop layout file by double-clicking on the folder CCX-Enablement folder on the
windows desktop of wkst1.dcloud.cisco.com (Charles Holland).
9. Use the Ctrl + A key combination to choose the contents of the file.
10. Use the Ctrl + C key combination to copy the selection to the clipboard.
12. Switch application focus back to the Cisco Finesse Administration web page.
13. Place your mouse cursor within the Finesse Layout XML frame.
14. Use the Ctrl + A key combination to select all text within the frame.
15. Use the Ctrl + V key combination to paste the code copied from the clipboard earlier.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 106 of 193
Cisco dCloud
17. Observe the status message indicating that the layout modification is saved successfully.
1. Switch focus to the Notepad application where the generated code was copied to in our earlier exercise.
3. In the Save As dialog, expand Computer and choose the Mapped Network drive letter Z.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 107 of 193
Cisco dCloud
4. Enter the following values to save the generated code as an html file.
Setting Input
Encoding ANSI
5. Click Save
NOTE: By saving the file to the mapped network drive, we have actually placed it in the IIS web root directory on
ad1.dcloud.cisco.com (C:\inetpub\wwwroot).
Restart IIS
8. Launch the IIS Manager application by clicking the icon [ ] in the windows taskbar.
9. In the Connections pane of the IIS Manager window, choose the entry for AD1 (DCLOUD\administrator).
10. In the Actions pane, click Restart to restart the web server and make the chat.html file actively available.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 108 of 193
Cisco dCloud
With the configuration to the Web Form chat.html complete we will test to ensure that the file is accessible in a web-browser
before moving on to the next configuration activity.
12. Bring focus back to Mozilla Firefox and click the + next to the current open tab to open a new tab.
13. From the dCloud Homepage, choose Collaboration User and Test Links > UCCX 11.0.1 Agent Chat Widget. You may
also type or paste the URL http://ad1.dcloud.cisco.com/chat.html into the new web browser tab to access the form directly.
14. Observe the newly hosted Web Form displayed. It should match the graphic below.
Log in to Cisco Finesse and Transition to Ready for Chat and Email
3. From the homepage, navigate to Collaboration User and Test Links > UCCX 11.0.1 Finesse Desktop.
ID: aperez
Password: C1sco12345
Extension: 6017
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 109 of 193
Cisco dCloud
6. Notice that based on the changes made to the Finesse Desktop Layout, a new tab named Manage Chat and Email is
present. Also, note the state change gadget for Chat and Email.
7. Transition to Ready for Chat and Email by clicking the down arrow to the right of the Not Ready for Chat and Email control.
NOTE: There are two distinct agent states, which are managed independently of one another. An agent may be ready for either
Voice or Chat and Email or both simultaneously. Transitioning to a Ready state for one has no effect on the other.
2. Switch focus to the tab connect to the newly created Web Chat Form. If Firefox is closed, you may navigate directly to the
Web Form by browsing to the following URL: http://ad1.dcloud.cisco.com/chat.html.
3. In the chat form enter the following values or appropriate text of your choice:
Setting Input
Email cholland@dcloud.cisco.com
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 110 of 193
Cisco dCloud
4. Click Submit.
5. Observe that the browser is connected to the Chat Widget hosted on Cisco SocialMiner.
6. The welcome message will continue to be presented until either the chat session is connected to an available agent or the
timeout value specified in the Channel Parameters has been reached.
8. Notice that an incoming chat notification is displayed on the Home tab in Cisco Finesse.
10. Observe that the Cisco Finesse Desktop switches application focus to the Manage Chat and Email tab.
11. Use the Select Predefined Response button [ ] at the far right of the chat response box.
12. Click Initial Greeting from the Predefined Response list to copy the predefined response text into the chat window.
13. Press the Enter key to paste this text into the chat.
15. Into the chat window, type any response text of your choice. Press Enter to post the reply text into the chat session.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 111 of 193
Cisco dCloud
17. Type another reply of your choice and press Enter to post the reply into the chat session.
18. Feel free to continue replying back and forth. When finished choose End from the Finesse Desktop.
20. Observe the message to the customer that the chat session has ended. The customer is offered the option to save the chat
transcript as a PDF file.
25. Double-click the saved PDF file to open and review it if desired.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 112 of 193
Cisco dCloud
1. Continuing from the RDP session connected to wkst1.dcloud.cisco.com, launch Microsoft Outlook via the icon [ ] on the
Windows Taskbar.
2. Click the New Email icon [ ] located in the top left of the Microsoft Outlook application window.
3. Compose a message to the Customer Service email CSQ using the following parameters:
Setting Input
To CustomerService@dcloud.cisco.com
4. Click Send.
6. Because Anita Perez is already in a state of Ready for Chat and Email, when the incoming message is routed to her,
Finesse Desktop will automatically switch focus to the Manage Chat and Email tab. The new message will be displayed
along with a space for the agent to reply to the message.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 113 of 193
Cisco dCloud
9. Confirm that a reply message from CustomerService@dcloud.cisco.com is present in the email inbox. It may take a minute or
two for the email response to arrive.
One of the capabilities of Cisco Finesse Agent Email is to ensure that the agent, who handles the initial customer contact, is the
preferred target for replies on that email thread. This is Last-agent routing or Email Stickiness. The amount of time that Cisco
Unified CCX waits until releasing these replies back into the queue is specified by the Sticky Email Timeout value under Chat
and Email > Channel Parameters, discussed earlier in the lab. This value can be a minimum of 1hr and up to 120 hours.
In our final test, we will have Charles Holland assigned to the CustomerService_Email CSQ, with a competence level equal to
Anita, and then he will log in to Cisco Finesse and transition to a Ready for Chat and Email state. Meanwhile agent Anita Perez
will then transition to a Not Ready for Chat and Email state. The customer will then reply to the same email thread.
Based on your learning in this module, what do you expect the result to be?
2. Transition to Not Ready for Chat and Email by clicking the down arrow to the right of the Ready for Chat and Email control.
4. If not already running, launch Mozilla Firefox by clicking the icon [ ] in the Windows taskbar. Otherwise, open a new tab.
5. From the dCloud homepage, navigate to Collaboration User and Test Links > UCCX 11.0.1 Finesse Desktop.
ID: cholland
Password: C1sco12345
Extension: 6018
8. Transition to Ready for Chat and Email by clicking the down arrow to the right of the Not Ready for Chat and Email control.
9. From the Cisco Finesse Supervisor Desktop menu, click the Queue Data tab.
10. Scroll to the bottom of the page to view the data presented by the Chat CSQ Summary Report live data gadget.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 114 of 193
Cisco dCloud
11. Confirm that there are 2 agents logged in and 1 in a Ready state.
13. Locate the Email reply from CustomerService@dcloud.cisco.com generated through the previous exercise.
15. Leaving the Subject and To fields intact, compose a brief reply of your choice.
18. Observe that the email is not routed to Charles Holland. This is because the system will hold this message in reserve for
Anita Perez until she becomes available to reply as long as it is within the timeout value of 4 hours per the currently
configured Sticky Email Timeout of 4 hours.
20. From Cisco Finesse Agent Desktop, transition to a Ready for Chat and Email state.
21. Confirm that the reply email message is immediately presented to Anita Perez.
22. Feel free to reply if desired. When finished, move on to the next step.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 115 of 193
Cisco dCloud
Module 3 Conclusion
Through the completion of this activity, we accomplished the following learning objectives:
Review the requirements and pre-requisites for deploying Cisco Finesse Agent Email and Unified CCX WebChat
Use the Cisco Unified CCX Administration interface to provision Cisco Finesse Agent Email and Unified CCX
WebChat
Use the Cisco Finesse Desktop Administration interface to enable the Agent Email and WebChat gadgets
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 116 of 193
Cisco dCloud
Module Overview
In this Module, we will learn how to add a custom Finesse Gadget to the Cisco Finesse Agent Desktop to meet a stated
business need. Cisco has made available certain Sample Gadgets on the Cisco Developer Network (DevNet) website. We will
be using the WebService Sample Gadget from this site, performing customization to make it suit our requirements. Through this
process, we will explore how Cisco Finesse Gadgets operate and how to deploy one in our lab environment.
NOTE: For students wishing to skip the gadget development process or encountering difficulty following the exercise, a working
version of the customized WebService Sample Gadget is in the Desktop\CCX-Enablement\Student-Resources\Module4-
Completed-Gadget folder of wkst1.dcloud.cisco.com.
Finesse is a browser based Customizable Desktop Interface for both Agents and Supervisors. The interface is a compilation of
customizable tables for various desktop layouts. It allows the Agent to change their state and interact with CRMs, 3rd Party tools,
and Recording or reporting via customizable Gadgets.
Cisco Finesse can use third Party Gadgets to imbed applications into its interface or using the REST API, imbed the Finesses API
into a customers own application.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 117 of 193
Cisco dCloud
Cisco Finesse Gadgets are mini web pages (HTML JavaScript, Cascading Style Sheets) contained in an xml wrapper. In
essence, a containerized WebApp that is intended to perform a certain function and runs within Cisco Finesse. Cisco Finesse
Gadgets are architected using the OpenSocial specification.
The OpenSocial specification defines a component-hosting environment (container) and a set of common application
programming interfaces (APIs) for web-based applications. It has become widely adopted as a general use runtime environment
for allowing untrusted and partially trusted components from third parties to run in an existing web application.
Cisco provides Sample Gadgets and a JavaScript library for use in creating custom Gadgets. While Gadgets are quite simple, the
easiest way to get started is to download a sample, deploy it to your Finesse Server, and see it in action.
Ultimately, Cisco Finesse Gadgets are intended to provide the optimal set of tools, features, and data needed to effectively
handle customer collaboration from within a single user interface: Cisco Finesse Agent Desktop. The overall architecture of
Cisco Finesse enables partners to help customers quickly and efficiently realize benefits of Unified CCX by adding required
features as needed to Cisco Finesse in the form of gadgets.
Module Objectives
In this module, we will explore and work through the process of downloading, customizing, and implementing a new Cisco
Finesse Gadget, which solves for a potential business problem. We will use freely available editing tools and sample code to
demonstrate and work through this process.
Understand the fundamentals of the operation and components of Gadgets in Cisco Finesse
Identify a theoretical business problem that can be solved using a custom gadget
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 118 of 193
Cisco dCloud
Topology
Table 44. Cisco Finesse Agent Email and Unified CCX WebChat Components
1 UCCX2 Unified Contact Center Express 11.0.1 uccx2.dcloud.cisco.com 198.18.133.20 administrator dCloud123!
Cisco Unified CCX has been installed and provisioned with an agent team and voice contact workflow as defined in the tables
below. The Customer Service team will serve as the Line of Business for which we will customize and deploy a new Cisco
Finesse Gadget.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 119 of 193
Cisco dCloud
Charles Holland Acts as both a Supervisor and Agent for the 6018 cholland C1sco12345
Customer Service Team
Anita Perez Acts as the primary Agent for the Customer Service 6017 aperez C1sco12345
team
IIS will serve as the Web Server, which will host an xml file that our custom gadget will fetch. IIS is running on
ad1.dcloud.cisco.com (198.18.133.1).
All components of this lab environment are configured with SSL certificates signed by a Microsoft Windows Server 2008
Certificate Services server running on ad1.dcloud.cisco.com. Workstations used for configuration and demonstration are
provisioned to trust ad1.dcloud.cisco.com as a Trusted Certificate Authority (CA).
In addition, all Collaboration systems used in this demonstration are configured with Fully Qualified Domain Names and each is
resolvable via DNS hostname lookup.
OpenSocial specification
The Cisco Finesse Desktop Layout instructs Cisco Finesse to render a gadget by providing the location of the XML file
associated with the gadget
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 120 of 193
Cisco dCloud
Cisco Finesse fetches the XML file specified from a third party web server or directly within Cisco Finesse Web Server
Finesse will then render the contents of the Gadget as HTML in a gadget container on the Cisco Finesse Desktop
The Gadget includes a JavaScript file that references Web Services to provide it with data. The JavaScript executes
defined data collection processes
Finally, the result of the data collection process is passed along to the Finesse Desktop in the Gadget container
The WebService Sample Gadget shows how to retrieve and render an Extensible Markup Language (XML) file hosted on any
web server. By default, this is an XML file containing the text Hello World. While simplistic in terms of operation, this gadget allows
us to explore the anatomy of a Cisco Finesse Gadget and understand how we can customize existing code samples to meet the
business needs of our customers.
In our scenario, the Customer Service agent team provides ordering support for an Organization that manufactures high quality
Widgets. Calls into the Customer Service team may be to place a New Order or provide support for an Existing Order.
The marketing group for the Organization determined that information regarding current product promotions is not effectively
being provided to the Customer Service representatives while speaking with customers. Agents taking new product orders are
missing an opportunity to provide callers with promotional offers resulting in a loss of potential revenue.
The marketing team posts promotion sheet called CurrentPromotions.xml on a nightly basis to the intranet web server.
We will customize the WebService Sample Gadget to retrieve the contents of the promotions list and render it in the Cisco
Finesse Desktop, providing agents with the most recent promotional offering when fielding customer calls.
In the following steps, we will access the DevNet site and download the code for our WebService Sample Gadget.
4. Click Log In at the top of the page and log in with your CCO credentials.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 121 of 193
Cisco dCloud
NOTE: To get the WebService Sample Gadget, you need to log in to the DevNet website with your Cisco.com credentials. If
you do not have those, please use this link to the download the gadget: https://cisco.box.com/WebServiceSampleGadget.
5. On the Finesse Sample Gadgets page, type Ctrl + F to open the Find window at the bottom of the browser.
6. Search for WebService. Doing so will bring you directly to the entry for the Sample Gadget WebService gadget.
8. Click OK to Save File. This will download to the default directory at Desktop\CCX-Enablement\Downloads.
10. Use Windows File Explorer to navigate to the following directory > Desktop\CCX-Enablement\Downloads.
11. Right-click the file WebServiceSampleGadget-2.0.zip and choose 7-Zip > Extract to WebServiceSampleGadget-2.0\.
12. This extracts the contents of the archive to a folder in the current directory named WebServiceSampleGadget-2.0.
1. In the File Explorer window currently open in the Desktop\CCX-Enablement\Downloads folder, browse to
WebServiceSampleGadget-2.0\WebService.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 122 of 193
Cisco dCloud
2. Observe the files listed therein. A brief explanation of each file and its function is available in the following table.
HelloWorld.xml Sample XML content file which comes as part of the Sample Gadget. We will be modifying the contents of this file as part of our gadget
customization process. We will create a file called Current Promotions.xml to meet our customer requirement.
WebService.xml Gadget definition file containing the HTML content the gadget and references to files containing business logic,jQuery and Finesse
JavaScript libraries and visual styles.
WebService.js A JavaScript file containing the business logic for the gadget. The JavaScript file provides the logic to run the HTTP request to the Web
Server, which hosts the content XML file to be retrieved. It then returns the result as HTML which is rendered on the Finesse Desktop.
WebService.css This file defines the HTML styles used when the Gadget renders HTML content. The WebService.xml file references this explicitly.
NOTE: The Unified CCX server ships with installed copies of both the jQuery and Finesse JavaScript libraries located in the
/opt/cisco/desktop/finesse/webapps/desktop/assets/js/ directory. The JavaScript file, which contains the business logic of the
gadget, will leverage these libraries. They are referred to in the WeService.xml file. When developing your custom gadgets, you will
also use these libraries. They are finesse.js and jquery.min.js.
We will use the Hello World.xml file as the starting point and edit it to suit our needs.
NOTE: If presented with the notice of an update package being available, click No.
2. Observe that the XML data structure and tags are not optimal for providing promotional data.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 123 of 193
Cisco dCloud
3. Clear the current data by highlighting all the text beneath the XML version reference tag <?xml version = 1.0?>.
5. Type or paste the following to create an XML data structure with appropriate promotion data:
<promotions>
<productname>Super Deluxe Widget Bundle</productname>
<promotion>Buy 2 Get 1 Free</promotion>
</promotions>
To simplify file transfer operations, a mapped network drive (Z:) has been configured on wkst1.dcloud.cisco.com in advance.
This network share is actively connected to the Web Root directory on ad1.dcloud.cisco.com and path is C:\inetpub\wwwroot.
We will save our new CurrentPromotion.xml file directly to the Web Server.
6. From the Notepad ++ editor menu, choose File > Save As.
8. In the File name field, change the name from HelloWorld.xml to CurrentPromotion.xml.
9. Click Save.
17. Launch the IIS Manager application by clicking the icon [ ] in the Windows taskbar.
18. In the Connections pane of the IIS Manager Application window, choose the entry for AD1 (DCLOUD\administrator).
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 124 of 193
Cisco dCloud
19. In the Actions pane, click Restart to restart the web server and make the CurrentPromotion.xml file active.
With the configuration to the current promotion XML file complete, we will test to ensure that the file is accessible in a web-browser
before moving on to the next configuration activity.
22. Click the + next to the current open tab to open a new tab.
23. Type or paste http://ad1.dcloud.cisco.com/CurrentPromotion.xml into the new web browser tab to access the form directly.
24. The newly hosted CurrentPromotion.xml file should be displayed and match the graphic below.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 125 of 193
Cisco dCloud
5. This will bring you to the location in the file where the Uniform Resource Indication (URI), from which this gadget will fetch
data, is specified. This should be Line 90 of the WebService.js file.
7. The method gadgets.io.makeRequest is defined in the finesse.js JavaScript library file. It expects to be passed a valid URI
to which it will attempt to make a connection. Observe the code and comments in the file directly before the
gadgets.io.makeRequest method is invoked.
8. Replace both occurrences of the string https://10.88.194.158:8080 with http://198.18.133.1:8080 (include the quotes).
NOTE: Microsoft IIS on ad1.dcloud.cisco.com is configured to listen on port 8080 for incoming requests by IP Address.
9. By modifying the value of the IP address specified in the URI, we have effectively instructed the gadgets business logic to use
ad1.dcloud.cisco.com as the web server host with which it is expected to connect with.
10. Next, we will specify the actual file path relative to the webserver root directory (/).
11. Use the Ctrl + F keystroke combination to open the Find window.
14. This will bring you to the location in the file where the file path to the relevant XML file is defined. This should be Line 56 of the
WebService.js file.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 126 of 193
Cisco dCloud
16. Observe the code and comments in the file directly before the this.myrestRequest method is invoked.
17. Replace the string /userContent/HelloWorld.xml with /CurrentPromotion.xml. In order to specify our target XML file for
rendering in the gadget.
19. From the Notepad ++ Editor menu, choose File > Save. This will save modifications to the WebServices.js file.
2. Let us identify the three key sections of the file and their function with respect to the operation of any Cisco Finesse Gadget.
The Figure below provides a visual aid to the data provided in Table 49.
1 Gadget Header Controls the visual display of the Gadget Header such as Title
2 File Associations Contains a list of all pertinent reference files required for this Gadget to operate (CSS Style Sheets, jQuery and
Finesse JavaScript libraries, Business Logic)
3 Gadget Body Layout Layout of the Gadget Body including the way in which data will be presented when returned in addition to any
controls (buttons, search boxes) to be displayed.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 127 of 193
Cisco dCloud
In this case, the elements enclosed within the <moduleprefs></moduleprefs> tags specify the Title and Description of the
gadget. In the following steps, we will change the title to reflect our use case.
3. Within the <ModulePrefs> tag, locate the text Sample Gadget WebService and replace the two occurrences (title,
description) with the text Current Product Promotions.
NOTE: When editing values, ensure that quotes () around the text are preserved. Omitting quotes for text fields will cause
erroneous output.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 128 of 193
Cisco dCloud
Our next series of edits will modify cosmetic elements within the body of the Finesse Gadget. We will change the heading text of
the table and the button label to suit our use case.
5. Scroll down to the Body section shown in the next figure below.
6. Replace the current text between the <legend> and </legend> tags with the text Current Promotion.
7. Replace the current text between the <button onClick> and </button> tags with the text Get Data.
Edit the Cascading Style Sheet (CSS) Associated with the Gadget
Finally, we will make changes to the style of text displayed when the gadget retrieves marketing updates from the
CurrentPromotions.xml file. This is done by editing the WebService.css file that is referenced in the gadget definition file
WebService.xml.
2. Currently the there is only a single entry specifying the visual styles associated with the body element of the HTML document.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 129 of 193
Cisco dCloud
NOTE: To better understand the relationship between an HTML Document and an associated CSS let us examine an HTML
code snippet and a CSS directive intended to influence visual styles pertaining to it.
Referring to the table above observe the <body> and </body> tags. The entry in the linked CSS file specifies that a visual style
will be applied to all elements within the body tags of the associated HTML document.
Our goal is to provide differentiation between the rest of the body and the result returned from the CurrentPromotions.xml file.
To do this we must add an entry that specifies the visual style to be associated and the HTML object that pertains to this data.
Based on the graphic above we can see that the data returned when the Get Data button is clicked is displayed within a <span>
element specified by an id named result. We can therefore create a CSS entry pertaining to an HTML span object and specify
the styles to be applied to each occurrence of the object.
3. Using the Notepad ++ editor, copy or paste the following text directly beneath the current entry for body.
span {
background-color: #66CCFF;
color: red;
}
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 130 of 193
Cisco dCloud
The hexadecimal code #66CCFF specifies a shade of light blue. The background-color directive applies this color to the
background of the defined element. The color directive refers to text displayed within the specified element. In this case, we simply
use the value red. We can therefore expect that data returned by our gadget will be displayed in red text on blue background.
Set the password for the Cisco Unified CCX 3rd Party Gadget Directory
The transfer process requires the use of an SFTP client and the built-in 3rd Party Gadget SFTP account. This password must be
configured before an SFTP connection can be made for file transfer into the 3rd Party Gadget Directory.
1. Launch the PuTTY terminal emulator by clicking the [ ] icon in the Windows taskbar.
3. Click Open.
5. Using the Unified CCX OS Administration CLI, we will issue the commands required to reset the 3rd Party Gadget SFTP
account. Type the following command followed by the Enter key to set the password for the 3rd Party Gadget SFTP account:
utils reset_3rdpartygadget_password
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 131 of 193
Cisco dCloud
The 3rd Party Gadget SFTP account is now ready for use in uploading Cisco Finesse Gadget files.
9. Type exit followed by the Enter key to close the PuTTY session.
Upload Gadget Files to the Cisco Finesse 3rd Party Gadget Directory
NOTE: Certain 3rd party gadgets may cause an upload error indicating insufficient permissions. To work around this issue, the os
secure mode may be set to permissive temporarily to allow for upload. We already set the os secure mode to permissive as
part of the pre-configuration of this lab.
Next, we will use an SFTP client, WinSCP, to transfer the WebService gadget files to the 3rd Party Gadget Directory.
1. Launch the WinSCP client by clicking the [ ] icon in the Windows taskbar.
Setting Input
Port number 22
Password dCloud123!
4. Click Login.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 132 of 193
Cisco dCloud
5. When challenged to accept the host key provided by uccx2.dcloud.cisco.com click Yes to continue connecting.
6. The WinSCP client interface is broken into two panes. The left pane represents local files, while the right provides a
visualization of the remote host file system.
7. Click the Open Directory icon in the Local Filesystem pane to browse to the directory where the extracted WebService
Sample Gadget files reside.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 133 of 193
Cisco dCloud
12. In the Remote Filesystem pane of the WinSCP application window, double-click the files directory.
13. In the local file system pane, select all the files excluding HelloWorld.xml. Consult the graphic below for reference.
14. Click the [ ] icon or drag and drop the files to the remote destination to initiate the file transfer process.
16. Confirm that the three selected files have transferred and appear in the /files directory on the remote file system.
3. From the dCloud homepage, navigate to Collaboration User and Test Links > UCCX 11.0.1 Finesse Desktop.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 134 of 193
Cisco dCloud
ID: aperez
Password: C1sco12345
Extension: 6017
6. Observe the available Tabs in the default Cisco Finesse Agent Desktop layout Home, My Statistics, and Manage
Customer.
NOTE: Those students continuing on to this exercise after completing Module 3 will observe, that in addition to the Cisco Finesse
Agent Desktop tabs displayed in the figure below, a Manage Chat and Email tab is also visible.
8. Choose the End Of Shift reason code to complete the sign out process.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 135 of 193
Cisco dCloud
1. Launch the Unified CCX Administration web page by opening a new tab in Mozilla Firefox.
2. From the dCloud homepage, choose Collaboration Admin Links > Cisco Unified CCX 11.0.
2. From the Navigation menu of the Cisco Unified CCX Administration webpage, choose Cisco Finesse Administration.
3. Click Go.
8. Log in to Cisco Finesse Administration with ID: administrator and Password: dCloud123!.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 136 of 193
Cisco dCloud
4. From the menu, choose Desktop Layout. The current Finesse Desktop Layout in xml format is displayed in an editable
format in the Manage Desktop Layout gadget.
5. To better illustrate the modification we intend to make, we will copy the current contents of the Desktop Layout XML file from
the Manage Desktop Layout gadget and perform edits in Notepad ++. Bring focus to the Manage Desktop Layout gadget
by clicking your mouse anywhere within the gadget body.
NOTE: It is acceptable to make modifications to the Finesse Desktop Layout data structure by typing and/or copying and pasting
text into the appropriate section of the file directly within the gadget. However, unless highly familiar with the document structure
the rendering of the file within the gadget may lend itself to confusion.
6. Use the Ctrl +A keystroke combination to select all contents displayed within the Manage Desktop Layout gadget.
7. Use the Ctrl + C keystroke combination to copy all selected text to the Windows clipboard.
8. Launch the Notepad ++ text editor application by clicking the icon [ ] in the Windows taskbar.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 137 of 193
Cisco dCloud
10. Use the Ctrl + V keystroke combination to paste the contents of the Windows clipboard into the editor window.
11. In order to instruct Notepad ++ to consider this an XML file we must first save it with the file extension .xml.
12. From the Notepad ++ menu, choose File > Save As....
15. Choose All Types (*) from the Save as type drop-down menu.
17. Scroll so that Line 19 is at the top of the editor window. This section defines the Tabs and their gadget content for the Cisco
Finesse Agent Desktop Layout.
NOTE: If any previous Modules were completed, you may need to start on Line 8. The tage <id>home</id> can be used to
ensure you are in the right place.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 138 of 193
Cisco dCloud
18. We will insert a new tab along with configuration to display our WebService Sample Gadget between the Home and My
Statistics tabs of the current Finesse Agent Desktop Layout. Copy and paste the following between Lines 31 and 32, or in
between the closing tab for the home tab and the start of the myStatistics tab, of the current layout file.
<tab>
<id>MarketingUpdates</id>
<label>Marketing Updates</label>
<gadgets>
<gadget>https://uccx2.dcloud.cisco.com:8445/3rdpartygadget/files/WebService.xml</gadget>
</gadgets>
</tab>
19. Your layout should appear as below, with the new tab running from Lines 32-38 (or lines 21 to 27).
20. From the Notepad ++ editor menu, choose File > Save to save changes to the file.
21. Use the Ctrl + A keystroke combination to select the entire contents of the file.
22. Use the Ctrl + C keystroke combination to copy the file to the Windows clipboard.
24. Return to the Mozilla Firefox browser tab connect to the Cisco Finesse Desktop Administration page.
25. Place your cursor anywhere within the body of the Manage Desktop Layout gadget and left-click.
26. Use the Ctrl + A keystroke combination to select and highlight all text within the gadget.
27. Use the Ctrl + V keystroke combination to replace the current layout text with your edited copy.
28. Scroll to the bottom of the web page and click the Save button to apply your changes.
29. Confirm that a message indicating that the save was successful is displayed in green text directly above the editor window.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 139 of 193
Cisco dCloud
You have completed the final configuration step to make the new gadget available to our Customer Service agent team.
10. Re-launch Mozilla Firefox by clicking the icon [ ] in the Windows taskbar.
11. From the homepage, navigate to Collaboration User and Test Links > UCCX 11.0.1 Finesse Desktop.
12. Log Anita Perez into the Cisco Finesse Agent Desktop as follows:
ID: aperez
Password: C1sco12345
Extension: 6017
14. Observe, based on our modifications, that the list of available Tabs is altered to include the new Marketing Updates tab.
NOTE: Those students continuing from Module 3 will observe that in addition to the Cisco Finesse Agent Desktop tabs
displayed in the figure below, a Manage Chat and Email tab will also be visible.
16. Let us correlate the gadget display components with the changes that we have made through our customization process.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 140 of 193
Cisco dCloud
Image Tag UI Object Gadget File/Object Modified Configuration Changes to Render Object
1 Finesse Tab Desktop Layout.xml As part of the modification to the Finesse Desktop Layout used to add the gadget, we
added a new tab entitled Marketing Updates.
2 Gadget Title WebService.xml/<Module Prefs> Recall that we modified the WebService.xml file to set the title equal to Current Product
Promotions
3 Legend Text WebService.xml/<Legend> We modified the legend text to provide an appropriate description of the gadget.
17. Click the Get Data button to retrieve the current product promotions specified in the CurrentPromotion.xml file.
18. Confirm that the current Super Deluxe Widget Bundle product promotion is displayed with the special visual customization
that we added: Red Text on Blue Background.
19. Feel free to continue exploring the Cisco Finesse Desktop and Gadget functionality. When finished, move on to the next
step.
22. Close any active File Explorer, Notepad ++, Win SCP, and Mozilla Firefox application windows.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 141 of 193
Cisco dCloud
Module 4 Conclusion
Through a series of straightforward customizations to a freely available gadget available from Cisco DevNet we delivered a new
capability to solve for a business problem. Agents now have access to current product promotion data at all times. Whether on an
active call or at a Ready state, an agent can easily browse to the Marketing Updates tab and click the Get Data button to retrieve
the latest promotion detail.
We invite students to take the learning begun here to the next level. There is incredible power in the toolset offered for the creation
of Cisco Finesse Gadgets. The best way to explore these capabilities is to become familiar with HTML, JavaScript, and the
jQuery library, which offer multiple built-in functions for data manipulation and UI interaction capabilities.
We hope through the completion of this module that you have gained an understanding of the modular architecture of Cisco
Finesse and begin to think about how simple tools can in fact be incredible assets when solving for business challenges.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 142 of 193
Cisco dCloud
Module Overview
Reporting is perhaps one of the most important features of a comprehensive customer collaboration platform. Unified CCX comes
with a robust reporting tool called the Cisco Unified Intelligence Center (CUIC). This is a co-resident version of a standalone
product, which had its genesis as a reporting tool for use with Cisco Unified Contact Center Enterprise. The co-resident version
of CUIC is referred to as CUIC Standard while the standalone tool is CUIC Premium.
The version of CUIC packaged with Unified CCX is customized to operate with Unified Contact Center Express in a co-resident
server deployment and is referred to as CUIC Standard.
Cisco Unified Intelligence Center Standard is a co-resident tool running in tandem with Unified CCX and is a comprehensive,
end-to-end reporting solution for Unified CCX. It can be used to access Historical and Live Data reports.
With Unified Intelligence Center, you can complete the following tasks:
Cisco Unified Intelligence Center Premium is a standalone CUIC deployment licensed for Premium functionality. In addition to
the features and capabilities provided by CUIC Standard, CUIC Premium offers these capabilities:
Create or modify the underlying data structure of CUIC reports (Report Definition)
Create custom Value Lists for use in populating report filter options
Customize data display and calculated fields for reports and package reports for use with CUIC Standard
NOTE: Some understanding of Standard Query Language (SQL) is helpful for a deeper understanding of report writing concepts
in the custom report creation section of this module.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 143 of 193
Cisco dCloud
For students new to the Cisco Unified Intelligence Center and/or Custom Report Writing and those interested in furthering their
current knowledgebase the following reading is highly recommended:
Cisco Unified Contact Center Express Report User Guide, Release 11.0(1)
http://www.cisco.com/c/en/us/td/docs/voice_ip_comm/cust_contact/contact_center/crs/express_11_0/user/guide/UCCX_B
K_U36B58A5_00_uccx-report-user-guide-11.html
Cisco Unified Contact Center Express Historical Reporting Guide, Release 11.0(1)
http://www.cisco.com/c/en/us/td/docs/voice_ip_comm/cust_contact/contact_center/crs/express_11_0/user/guide/UCCX_B
K_UA808DBF_00_uccx-historical-reporting-guide-11.html
http://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/cust_contact/contact_center/crs/express_11_0/reference/guid
e/Unified_CCX_Database_Schema_Guide_Release_1101.pdf
NOTE: For students wishing to skip the custom report creation process or who encounter difficulty following the exercise, a fully
completed custom report package Call Summary By Inquiry Type.zip can be found in the Desktop\CCX-Enablement\Student-
Resources\Module5-Completed-Report folder.
Module Objectives
In this module, we will explore the interface and capabilities of the Cisco Unified Intelligence Center Standard tool to perform
initial provisioning and create Dashboards and customized versions of the stock report packages. We will then integrate a Cisco
Unified Intelligence Center Premium standalone application server with Unified CCX and deliver superior business outcomes by
designing and creating a custom report for use in CUIC Standard.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 144 of 193
Cisco dCloud
Charles Holland Acts as both a Supervisor and Agent for the Customer Service Team, and 6018 cholland C1sco12345
carries the Reporting Role (Required for CUIC access/functionality)
Anita Perez Acts as the primary Agent for the Customer Service team 6017 Aperez C1sco12345
CustomerService_Voice Voice Contact CSQ for Customer Service Calls Customer Service Minimum - 5
CS_Voice_Main Voice Contact CSQ for Customer Service Calls CCX_Enablement/icd.aef 6021
NOTE: Each call into the CS_Voice_Main script application collects data from the caller and sets the custom CallVariable1 based
on the type of call. This will be important because the report we will later construct will incorporate this information. For a detailed
analysis of the Unified CCX Application script used in this lab, refer to Module 2 Advanced Unified CCX Scripting Techniques.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 145 of 193
Cisco dCloud
4. From the homepage, navigate to Collaboration User and Test Links > UCCX 11.0.1 Finesse Desktop.
ID: aperez
Password: C1sco12345
Extension: 6017
7. In order to transition to a Ready state, click the Not Ready menu item at the top of the Cisco Finesse Agent Desktop page.
8. Choose Ready.
CUIC Administration
Access to CUIC is controlled initially by the Application Administration User specified during the Unified CCX install process. This
control can later be assigned to one or more users by giving them the Security Administrator role. This role allows for:
Assign Permissions User Roles are associated with people. Permissions are associated with Dashboards, Reports,
Report Definitions, Data Sources, Value Lists, and Collections
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 146 of 193
Cisco dCloud
The menus items on the left are called Drawers. When clicked, drawers reveal their contents on the right side of the screen.
2 Dashboards Opens the Dashboards tab, which allows users to create custom dashboards with reports, widgets, sticky
notes, etc.
3 Reports Opens the Reports tab, which contains the Historical and Live Data reports. It also allows for custom sub-
categories and custom report creation
4 Data Sources Provides read-only access to the configured data sources. In CUIC Premium new data sources may be
configured.
5 Value Lists Defines pre-defined ID/Value combinations, used to simplify report filter criteria.
6 Security Opens the Security tab, which allows for the assignment of CUIC system privileges.
7 Scheduler Opens the Scheduler tab where scheduled report execution may be configured.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 147 of 193
Cisco dCloud
In the next activity, we will create a series of Dashboard and Report folders also referred to as Sub-category elements to which
our report system end users will have write access in order to create and customize these elements. These are the first steps
toward leveraging the power of the CUIC application in a customer environment.
3. From the homepage, navigate to Collaboration User and Test Links > Cisco Unified CCX 11.0. Alternatively, you may
access the CUIC interface directly at the following URL: https://uccx2.dcloud.cisco.com:8444/cuic.
Caution: Do not navigate to Cisco Unified Intelligent Center! We are working from the co-resident CUIC platform accessible via
the UCCX splash screen.
In the next activity, we will create a set of sub-categories (folders) to create a workspace where Unified CCX reporting system
users may create and modify dashboards and reports.
8. Under Available Dashboards, highlight the Dashboards folder and right-click to open the options menu.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 148 of 193
Cisco dCloud
14. In the Right hand pane, under Available Reports, highlight the Reports folder and right-click to open the options menu.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 149 of 193
Cisco dCloud
As mentioned earlier, a user must be explicitly granted privileges to create or modify certain items and to leverage the full
customization capability present in CUIC. We will assign administrative privileges to Charles Holland in order to allow this user to
create dashboards and customize reports.
3. Click the radio button next to CCX\cholland and then click Edit.
4. Scroll down and from the list of available Roles; check System Configuration Administrator, Security Administrator,
Report Definition Designer, and Value List Collection Designer.
5. Check the boxes for Execute and Write under the My Group and All Users permissions headings.
7. Move all Available Groups to the Selected Groups box by clicking the >> button.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 150 of 193
Cisco dCloud
8. Click Save.
User Charles Holland has now been delegated permissions to create new reports and dashboards in the Customer Service
folders created for the purpose. In addition, the necessary permissions we assigned to allow Charles to perform customization and
supervisory management.
1. On the CUIC log in page, enter Username: cholland and Password: C1sco12345.
1. Click the Reports drawer in the left pane [ ]. This will open the Reports tab in the right pane.
2. In the right pane under Available Reports, navigate to Reports > Stock > Unified CCX Live Data > Supervisor.
3. Right click the Team State Report and choose Save As.
NOTE: In order to modify the report in any way, a copy of the stock report must be saved. We will save this to the Customer
Service reports category created earlier.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 151 of 193
Cisco dCloud
4. Enter the following parameters to save an editable copy of the Team State Report.
Setting Input
5. Click OK to save the new report to the Reports > Customer Service Sub-category.
6. The configuration editor for the newly saved report is launched in a new tab.
The View assigned to a report represents the logical instruction for which data collected during the SQL query underlying a report
is displayed. In addition, data thresholds can be defined within the View to provide alerts for when a threshold value is met.
In the following section, we will edit the view for our custom report to change the fields that are displayed when executed and finally
add a threshold, which will dynamically change the color of certain data rows based on the thresholds defined.
2. Click the radio button for the entry Team State Report to choose it.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 152 of 193
Cisco dCloud
4. Observe that there are two panes. The left pane lists Available Fields or data points collected by the underlying SQL query
structure of the report (Defined in the Report Definition). The right pane lists Current field order in the grid. This specifies
not only the selected fields from those available but in what order they are presented.
NOTE: From an order of display perspective keep in mind that Top > Bottom in the Current field order in the grid pane is
rendered Left > Right in the data grid of the report when run.
As you can see, all five available fields are present in the current grid view and displayed in order from left to right: Agent Name,
Agent ID, Log in Duration, Current State, Duration (of the current state). We will customize the view to achieve the following
Remove the Agent ID field, we wish to see only the Agent Name field
Modify the order of displayed fields by listing Current State directly after the Agent Name field
Add a Threshold to the Agent State value to force data-grid background and foreground color to change dynamically
when the agent is in a Not Ready state. Giving the supervisor a quick-glance reference to a suboptimal situation
5. To remove the Agent ID field, click the Agent ID entry in the Current field order in the grid window.
6. Click the Remove Selected button to remove this data field from the grid view.
7. To change the display order such that Current State appears directly after the Agent Name field, choose the Current State
data field entry in the Current field order in the grid window.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 153 of 193
Cisco dCloud
8. Use the up arrow [ ] to move the field so it is positioned directly under Agent Name.
9. Finally, to add a threshold, right click the entry for Current State in the Current field order in the grid window.
12. Use the table below to set the parameters for this threshold.
Setting Input
Type Equal to
Bold Checked
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 154 of 193
Cisco dCloud
In addition to modifying the data viewable when the report is run, we can modify the default report filter to automatically apply
report filters pertinent to our use case. In this case, we are interested in data for the Customer Service agent team exclusively.
We will modify the report view to specify that returned data should be for the Customer Service agent team only.
3. In the Basic Filters tab, locate the Choose Collection list box.
5. Observe that this filters the report to include only resources assigned to the Customer Service team (aperez, cholland).
6. Click Save to save changes and close the Default Filter editor dialog.
Finally, we will run both the stock and customized versions of the Agent Team State report to view the impact of our changes.
Recall that in an earlier step we logged in to the Cisco Finesse Agent Desktop on wkst2.dcloud.cisco.com as agent Anita
Perez, we will therefore expect to see data related to her current state.
2. To refresh the reports list and incorporate our changes, click the Refresh button [ ].
3. Browse to Reports > Stock > Unified CCX Live Data > Supervisor.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 155 of 193
Cisco dCloud
6. Notice that no filter criteria for the report are selected. From the Choose Collection list box choose the entry for Customer
Service.
Note: If you encounter an error indicating a failed connection to Live Data, refresh the browser page and re-run.
8. Observe that state data for Anita Perez is returned. The data is ordered per the original grid design specified in the data View.
11. Click the report entry for Customer Service Team State.
12. A new tab for the Customer Service Team State report opens.
13. Observe that the Default Filter we created earlier is in effect and that the Customer Service team is already selected as the
filter criteria.
15. Confirm that the report returns state data for Anita Perez. Observe that only 4 data fields are listed and their order differs from
that of the stock report: Agent Name, Current State, Log in Duration, Duration.
16. Switch back to the RDP session connected to wkst2.dcloud.cisco.com (Anita Perez).
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 156 of 193
Cisco dCloud
17. From the Finesse Desktop, transition to a Not Ready Break state.
18. Switch back to the RDP session connected to wkst1.dcloud.cisco.com (Charles Holland).
19. Observe that based on the configured threshold value for the Agent State field, the background color of the Agent State field
displayed in the report has changed to Red.
NOTE: The Not Ready reason code has no effect on the behavior of the configured threshold, which simply checks for a state
value of Not Ready. Any Not Ready state will trigger this threshold.
Create a Dashboard
A Dashboard in CUIC terminology is a collection of data elements that you view from a single page. You can create multiple
dashboards and choose whether they remain private or become available to other users/viewers using the permissions system.
As part of the previous exercise, we created a custom version of the Agent Team State report. Recall that we modified the report
to include a default filter, which limits the report results to members of the Customer Service agent team. We will further modify
the report for use in a dashboard to enable a run without prompting the user with a filter dialog.
3. Right-click the report entry for Customer Service Team State and choose Edit.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 157 of 193
Cisco dCloud
5. Click Save.
6. Click the Dashboards drawer [ ] in the left pane. This will open the Dashboard tab in the right pane.
7. In the right pane, under Available Dashboards, click the + to the left of the Dashboards category to expand (if not already
expanded).
8. Right click the entry for Customer Service and choose Create Dashboard.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 158 of 193
Cisco dCloud
11. Click the newly created dashboard item named Customer Service Supervisor Dashboard.
12. A new tab titled Customer Service Supervisor Dashboard opens, presenting a blank canvas for dashboard customization.
When first created, a dashboard is essentially a blank slate. In the next activity, we add items to the dashboard to make it usable.
13. Click the Add icon [ ] to add a new item to the dashboard.
16. Under the Dashboard Item Content section, browse using the arrows [ ] to browse to Reports > Customer Service.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 159 of 193
Cisco dCloud
19. Click and hold the black box [ ] at the lower right of the dashboard item and resize until all contents of the item are visible.
20. Observe that because the customized Agent Team State report implements a pre-configured default filter and uses the
Bypass Filter Dialog parameter, there is no user intervention required to view the dashboard item.
NOTE: Ideally, one would add multiple stock reports or custom reports and create a Single Pane Of Glass for tracking critical
real-time metrics.
21. Feel free to continue adding items to the dashboard as you explore the Dashboard feature.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 160 of 193
Cisco dCloud
The Report Definition specifies the data source such as a SQL query, Anonymous Block query, or even a Stored Procedure. The
data source specifies filter parameters as well as the data fields returned. In addition, the formatting of returned data and the
addition of footer rows are controlled from within the Report Definition.
A single Cisco Unified Intelligence Center server may be installed to supplement a Unified CCX deployment by providing a
comprehensive platform for administrators and report writers to create new or fully customize existing reports. These reports may
then be packaged and imported for use on the co-resident Unified CCX server.
In the following activity, we will integrate a standalone instance of CUIC Premium with our Unified CCX server. We will use this
CUIC instance to create an entirely new report that solves for a particular business objective. We will save this new report and re-
import it into the CUIC Standard on Unified CCX for use there.
1. Launch the Unified CCX Administration web page by opening a new tab in Mozilla Firefox.
2. From the dCloud homepage choose Collaboration Admin Links > Cisco Unified CCX 11.0.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 161 of 193
Cisco dCloud
NOTE: In a Unified CCX High Availability deployment, this operation must be performed on both servers before proceeding.
The password information is NOT automatically synchronized between Unified CCX nodes.
12. From the dCloud homepage, choose Collaboration Admin Links > Cisco Unified Intelligence Center Premium 11.0.
Alternatively you may navigate to the following URL: https://cuic1.dcloud.cisco.com:8444/cuic.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 162 of 193
Cisco dCloud
15. Choose the Data Sources drawer. This will launch the Data Sources tab in the right pane.
NOTE: In order to validate SQL queries for new or modified reports and access value lists, CUIC Premium must be able to use
Unified CCX as a Data Source. This capability is necessary in order to create custom reports for Unified CCX.
17. Configure the fields per the table below to configure Unified CCX as an accessible Data Source. Bear in mind that we are
actually setting up a SQL connection between Unified Intelligence Center Premium and Unified CCX.
Name Unified CCX Unique name by which the new Data Source will be referenced within CUIC Premium.
Type Informix Database Type to which the CUIC premium instance will communicate (MS SQL or Informix)
Data Source Host uccx2.dcloud.cisco.com Hostname or IP address of the host on which the database resides. In this case Unified CCX.
Port 1504 TCP Port on which the SQL data connection will be made. 1504 for Informix on Unified CCX.
Database Name db_cra Target database name. db_cra is the name of the Historical Reports database on Unified CCX.
Instance uccx2_uccx Unique database instance name this is determined using the following formula. [uccxHostname]+_uccx.
Because our Unified CCX hostname is uccx2 the db_cra instance name is uccx2_uccx. If the Unified CCX
hostname contains dashes -, these are converted to underscores during database installation. For Example if
the hostname were uccx-2, the instance name would be uccx_2_uccx.
Timezone Leave Blank Not Required as both cuic1.dcloud.cisco.com and uccx2.dcloud.cisco.com are provisioned in the same timezone
UTC. By default CUIC will assume that will use its timezone when running reports specifying date and time
ranges
Database User ID uccxhruser This is the built-in user id of the Historical Reporting User.
Password dCloud123! Password assigned to the Unified CCX Historical Reporting User.
Confirm Password dCloud123! Password assigned to the Unified CCX Historical Reporting User.
Charset UTF-8 Character set used in the Unified CCX Informix database.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 163 of 193
Cisco dCloud
NOTE: For more information on the schema of the db_cra instance used to view tables, fields, and data within the Unified CCX
Historical Reports database, the fields defined above can be used to create a SQL connection to the dbcra from a database
visualization tool of your choice. We recommend that you use a lab environment for this access, but a deep understanding of the
data structures contained within will allow you to become adept at creating new or customized reports for your customers. In
addition, the Stored Procedures referenced by the stock report definitions can be viewed and used as a baseline for report
creation, where a simple single return query cannot achieve the reporting objective.
21. Click the Save button to add the new Data Source.
22. Verify that the UCCX data source is in the Data Sources tab with a green checkmark in the Connected Node status field.
This concludes the integration of Unified CCX with CUIC Premium as an available data source. In the next exercise, we will
discuss use cases for custom reporting and use the CUIC Premium toolset to create a completely new report.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 164 of 193
Cisco dCloud
The Unified Contact Center Express instance configured for this lab is designed to support a Customer Service line of
business. As part of the voice contact workflow, every customer that calls the CS_Voice_Main application is presented with a 3-
choice menu to specify the reason for his or her call. As part of the configured icd.aef script file, the menu option that the caller
selects is saved to CustomCallVariable1. This is one of 10 reserved call variables for which data is written to the Unified CCX
Historical Reporting database along with call contact detail.
New Order
Existing Order
Other Inquiry
NOTE: For students wishing to review the icd.aef script, Module 2 of this lab guide provides in depth coverage of both the
designed workflow and programmatic elements of the script.
Because we are recording caller selections and saving the derived data into the customVariable1 field of the ContactCallDetail
table (using a Set Enterprise Data script step), we know that data is available for each call record and we can perform reporting
operations against it.
The operations manager of the Customer Service Line of Business has asked you to provide a report which summarizes all calls
placed to the Contact Center during a given time interval and broken out by Inquiry Type.
In analyzing the stock report definitions available within Unified CCX, to find a ready-made solution, we discover one option for
reporting on data stored in Custom Call Variables, a report titled Call Custom Variables.
The Call Custom Variables report accepts filter parameters such as Time Range and even a particular Call Variable value.
However, the report returns a unique report row for each row of data matching the report filter. Report output as displayed below.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 165 of 193
Cisco dCloud
This output would be ideal if we wished to drill down into the specifics of each call specified by the customer inquiry type as stored
in the database as CustomCallVariable1. Unfortunately, this report does not provide the capability to summarize call data by
custom call variable type. A possible course might be manually exporting the data to CSV format and parse it using a spreadsheet
or similar tool. This method would be cumbersome and time consuming and a better solution by far is to harness the power of
CUIC Premium to write a simple but effective report to deliver the required results.
The problem statement as supplied by the Customer Service operations manager in the section above gives us a start but now
that we have identified the need to create a new report, let us expand on those requirements to arrive at a true report definition.
Provide a report which summarizes all calls placed to the Contact Center during a given time interval and broken out by
Inquiry Type. Call Totals, Inquiry Type, and Average Handle Time (AHT) for calls grouped per Inquiry Type should be provided
as part of the report output. In addition to filtering by time interval, the report should have the ability to filter by Unified CCX
Application Name in case additional voice applications are deployed in the future.
Based on the requirements specified our report data set should include the following viewable data:
Field Description Data Format Unified CCX db_cra Table and Field Name[tableName.FieldName]
Application Name Specifies the Line Of Business for which the report is being run. STRING ContactCallDetail.applicationname
Inquiry Type Loosely the Call Reason, can be one of (New Order, Existing STRING ContactCallDetail.customVariable1
Order, Other Inquiry)
Total Calls The number of calls for each distinct Inquiry Type over a DECIMAL Count of all records meeting the filter criteria
specified time range
Average Talk Time Average of talk time for all calls specified by a particular inquiry Hh:mm:ss Average of the values in the ContactCallDetail.connecttime field.
type
Based on the requirements specified, our report should allow for the following filter criteria:
Filter Description CUIC Data Type Unified CCX db_cra Table and Field Name[tableName.FieldName]
Begin Date/Time Specifies the beginning of the time range for which data will DATETIME Filter is tested against the ContactCallDetail.startdatetime
be collected
End Date/Time Specifies the end of the time range for which data will be DATETIME Filter is tested against the ContactCallDetail.startdatetime
collected.
Application Name Unified CCX Voice Application String Filter tested against the ContactCallDetial.applicationname field
Visual Presentation
Let us review our intended design by creating an example of the data displayed when our report is run.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 166 of 193
Cisco dCloud
NOTE: All custom reporting solutions require an understanding of the logical layout and location of data fields within the database.
This is called a schema. The activities in this lab make use of schema definitions documented in the Cisco Unified CCX
Database Schema Guide, Release 11.0(1). Refer back to the beginning of this module for a link to the documentation.
While it is far beyond the scope of this lab document to teach Standard Query Language (SQL) programming we will review in
brief the required SQL SELECT statement needed to gather the required data fields, and sort results based on filters specified.
As indicated earlier, all of the data required to provide this report output resides in the ContactCallDetail table of the db_cra
database on Unified CCX. In addition, we identified the following database field (column id) values that specify return data and will
provide the basis of our SELECT statement: applicationname, customVariable1, connecttime.
Also, recall that we are providing filtering capability to limit the result set based on the value of the startedatetime field being
greater than or equal to the interval start time and less than or equal to the interval end time. In addition, we will check to ensure
that the applicationname field matches that specified in the report filter.
Finally, we wish to group results by Inquiry Type, which is the value present in the customVariable1 field.
In the WHERE clause of this statement there are 3 elements preceded by a colon :. These are Parameters supplied by the end
user when executing the report. CUIC parses the SQL syntax and recognizes this must be provided by the end user. When the
parameters are configured and the report is Run, CUIC will dynamically replace these tags with the value provided by the user.
This is a function of an Anonymous Block SQL query, which we will use as our data source value for the Report Definition.
For Example, :StartTime will be replaced with a Data/Time value based on what is selected using a calendar control on the report
filter screen. :VoiceApplicationName will be replaced by a string containing a valid voice application name chosen by the user.
NOTE: Use caution when constructing SQL statements for new reports. Database performance can be severely impacted if an
improperly written query is executed against the Unified CCX database. This is especially true when creating more complex
iterative queries using Stored Procedures.
With requirements gathered and defined and SQL logic compiled to retrieve our data set, we are ready to begin the report creation
process. A Report Definition in CUIC contains the data source for the report (SQL, Anonymous Block, Stored Procedure). It
allows us to set the expected format of return (field data), and to configure parameter data types and formats. Some visual
formatting may be done here, but the vast majority of aesthetic modification can be done later when Editing Report Views.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 167 of 193
Cisco dCloud
1. In the browser tab connected to the CUIC Premium instance on cuic1.dcloud.cisco.com click on the Report Definition
drawer [ ] in the left pane.
7. Left-click the Custom Report Definitions Sub-category, choose Create Report Definition.
8. Configure the Report Definition using the parameters listed in the table below.
Setting Input
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 168 of 193
Cisco dCloud
9. Click OK.
10. A new tab titled Call Summary By Inquiry Type is opened in the right pane.
12. Double-click the file name Call_Summary_By_Inquiry_SQL.txt file to open in Notepad. This file contains a copy/paste
version of the SQL statement developed earlier in the lab.
13. Use the Ctrl + A keystroke combination to select all contents of the file.
14. Use the Ctrl + C keystroke combination to copy the selection to the Windows clipboard.
16. Switch focus back to the Call Summary By Inquiry Type tab in CUIC.
17. On the [ ] tab, enter the values specified in the table below.
Setting Input
19. Place your cursor in the Anonymous Block editor window, use the Ctrl + V keystroke combination to paste the SQL text.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 169 of 193
Cisco dCloud
The Create Parameters function instructs CUIC to parse the entered SQL statement and search for any specified parameters. In
our case, the values :StartTime, :EndTime, and :VoiceApplicationName are identified and displayed below the Anonymous
Block editor window. This is the first SQL query validation step performed by CUIC during Report Definition creation.
21. Scroll to the bottom of the page and configure the detected parameters using the table below.
@StartTime DATETIME
@EndTime DATETIME
23. Confirm that a success message is displayed to the right of the Create Fields button.
The Create Fields function performs a SQL validation test against the data source Unified CCX to ensure that the query is
executable as written based on the Unified CCX database schema.
27. Use the drop-down menu to set the Footer value to Sum. This will automatically create a calculated footer column totaling the
values for all returned data rows.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 170 of 193
Cisco dCloud
31. In the Format field, use the drop-down menu to choose Minutes and Seconds (hh:mm:ss).
32. Use the drop-down menu to set the Footer value to Avg. This automatically creates a calculated footer returning the average
for the ATT values for all returned data rows.
35. Choose the entry for @StartTime and click the Edit button.
Setting Input
38. Choose the entry for @EndTime and click the Edit button.
Setting Input
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 171 of 193
Cisco dCloud
41. Choose the entry for @VoiceApplicationName and click the Edit button.
Observe: there is an option to assign a Value List to this parameter. A value list displays a list of available valid choices from
which the report end-user may choose. Value Lists are generated by running a simple SQL query to identify valid values present in
particular database fields. Because we have not yet defined a value list we will leave the parameter as is and return to finish the
configuration after the creating a value list.
As specified in the previous step, we want to provide the end-user a list of valid options for use with report filter parameters. This
ensures consistent results and delivers a superior end-user experience by making the report filter interface more intuitive.
Value lists use simple SQL queries to return pertinent data as filter choices for a particular report. In this case, because all of the
data for our report is derived from the db_cra.ContactCallDetail table, we want to determine the list of valid Unified CCX
Application names by issuing a simple query to select unique instances of application names, which occur in records in the
db_cra.ContactCallDetail table. Rather than listing every application configured within Unified CCX, we are presenting only the
names of those applications, which have generated call traffic based on records stored in the db_cra.ContactCallDetail table.
This query will seek through the first 30000 rows of data and identify distinct values for the applicationname field where the value
is something other than an empty string. It will then return this list of distinct Application Names. This list will be used by CUIC in
the Run report interface to populate the available selections from which the end-user may choose.
2. Double-click the file named Value_List_SQL.txt file to open in Notepad. This file contains a copy/paste version of the SQL
statement developed earlier in the lab.
3. Use the Ctrl + A keystroke combination to select all contents of the file.
4. Use the Ctrl + C keystroke combination to copy the selection to the Windows clipboard.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 172 of 193
Cisco dCloud
9. In the Value List > Create dialog, enter the values specified in the table below.
Setting Input
Version 1.0
10. Clear all text from the Value List Query field.
11. Place your cursor in the empty Value List Query field and copy SQL command using the Ctrl + V keystroke combination.
16. Scroll down and place a checkmark in all available Permissions fields.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 173 of 193
Cisco dCloud
Complete the report configuration by assigning the Voice Application Name Value List to the @VoiceApplicationName
parameter in the Call Summary By Inquiry Type Report Definition.
2. To synchronize the newly added Value List click the Refresh button [ ].
5. Click Edit.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 174 of 193
Cisco dCloud
Setting Input
Set Values for the Default Report Filter or Even Bypass the filter dialog altogether
1. Click the Reports drawer [ ] in the left pane to open the Reports tab.
2. Under Available Reports, highlight the Reports folder and right-click to open the options menu.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 175 of 193
Cisco dCloud
7. Right-click on the newly create Custom Reports Sub-category and choose Create Report from the menu.
Setting Input
Report Definition Report Definitions > Custom Report Definitions > Call
Summary By Inquiry Type
9. Click OK. An editor tab titled Call Summary By Inquiry Type will launch in the right pane.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 176 of 193
Cisco dCloud
Recall that in an earlier activity we developed a proposed visual layout for the Call Summary By Inquiry Type report which
specified the order in which columns would be displayed. We will now customize the default report data view using the mock-
design developed.
1. With application focus on the Call Summary By Inquiry Type report editor tab, click the Edit Views [ ] button.
2. Click the radio button for the view item named Call Summary By Inquiry Type grid data view.
4. Use the Up and Down arrows to re-order the fields displayed in the Current field order in the grid pane from top to bottom
as follows:
voiceapplication
inquirytype
totalcalls
averagetalktime
5. Ensure that your data field grid order matches the graphic below.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 177 of 193
Cisco dCloud
6. Next, we will edit the Grid Display Name property of all fields presented in the data grid.
7. Right-click the voiceapplication field in the Current field order in the grid pane. Choose Properties.
9. Click OK.
10. Right-click the inquirytype field in the Current field order in the grid pane. Choose Properties.
13. Right-click the totalcalls field in the Current field order in the grid pane. Choose Properties.
16. Right-click the averagetalktime field in the Current field order in the grid pane. Choose Properties.
17. In the Grid Display Name field, type Average Talk Time.
19. Confirm that data fields have been modified such that your configuration matches the graphic below.
NOTE: The operation above affects only the cosmetic display of data when the report is run, making it easier for a viewer to
understand by assigning a standard text representation of the field name.
Finally, we take our reporting package to the next level and provide an At a Glance Pie Chart view, which will display the
Percentage By Volume based on Inquiry Type. This view will then become an optional data view when the report is run.
1. From the Views of Call Summary By Inquiry Type tab, click Create.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 178 of 193
Cisco dCloud
Setting Input
Setting Input
7. Click Next.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 179 of 193
Cisco dCloud
10. Observe that both configured views are now associated with the Call Summary By Inquiry Type report.
Note: As this is a lab system with Call Volume generated for testing purposes and on specific dates we will always use the
Relative Date Range of Year to Date when running the report to ensure that a dataset is returned. You may wish to generate test
traffic and sample the report results based on your testing.
2. Click the Refresh icon [ ] to incorporate changes to the Call Summary By Inquiry Type report (made during the
previous exercise).
3. Expand the Custom Reports sub-category by clicking the + directly to the right of the item.
4. Left-click the Call Summary By Inquiry Type report to launch the report filter.
5. For Interval set the Relative Date Range field to Year to Date using the drop-down menu.
6. Observe that the Voice Application Name parameter displays a single available item in the Available pane.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 180 of 193
Cisco dCloud
7. Choose CS_Voice_Main and use the [ ] to bring this item into the Selected pane.
Recall: The available items for the Voice Application Name filter are rendered based on the Value List defined earlier.
8. Click Run.
9. Observe that the report runs successfully and returns data similar to the following:
1 Column Headers and Order Column Header Names Configured based on the Grid Display Name value. Columns are presented in
the desired order from left to right.
2 Average Talk Time Format Formatting value specified for the averagetalktime field is correct (hh:mm:ss)
3 Footer Columns A Footer with Total Calls and Average Talk Time is displayed at the bottom of the report page.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 181 of 193
Cisco dCloud
We have confirmed that the output of the report data grid view aligns with our design. Let us observe the output of the chart data
view.
10. Locate the Data View selection menu at the top right of the Call Summary By Inquiry Type report window. You may need to
11. Use the drop-down menu to choose Call Percentage By Inquiry Type.
12. Confirm that the pie chart data view presents total call volume sorted by inquiry type.
13. Observe that based on our configuration settings, the values are displayed inside the chart wedges.
This is a relatively straightforward process, which involves exporting the created report from CUIC Premium and then importing
the report to a target category in CUIC Standard.
1. Click the Reports tab if already open, or Click the Reports drawer to launch the tab.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 182 of 193
Cisco dCloud
2. Right-click the Call Summary By Inquiry Type report item. Choose Export from the menu.
3. Leave the default name for the archived report Call Summary By Inquiry Type.zip.
4. Click OK.
5. When prompted in the Opening File dialog, click the Save File radio button and then click OK.
6. The file Call Summary By Inquiry Type.zip file will be automatically save to Desktop\CCX-Enablement\Downloads.
7. Switch to the Mozilla Firefox browser tab connected to CUIC Standard on uccx2.dcloud.cisco.com. If prompted to log in,
do so with the credentials Username: cholland and Password: C1sco12345.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 183 of 193
Cisco dCloud
11. In the File Upload dialog, browse to Desktop\CCX-Enablement\Downloads and choose Call Summary By Inquiry
Type.zip.
13. In the Save To field, use the arrow to expand the Reports category. Click the radio button for Customer Service.
15. CUIC opens the archive file and examines the report components. It will detect that it does not have an installed Report
Definition that matches the one referenced by this report. You will see what appears to be an error message but is actually
informational and a new dialog opens to allow the user to choose the data source associated with this report.
16. From the Data Source for Report Definition drop-down menu, choose UCCX.
17. From the Data Source for Value List drop-down menu, choose UCCX.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 184 of 193
Cisco dCloud
18. The Save To field preserves the selection from the previous dialog, which was Reports > Customer Service. Verify this is
correct.
20. A message indicating that import was successful is displayed in the upper left corner of the import dialog. You will
automatically be re-directed back to the Reports tab once complete.
21. The Call Summary By Inquiry Type report should now be available in the Customer Service reports Sub-category.
Run the newly imported report to ensure that report filters and return data render as expected.
1. Left-click the Call Summary By Inquiry Type report item in the Reports tab.
2. For Interval, set the Relative Date Range field to Year to Date using the drop-down menu.
3. Observe that the Voice Application Name parameter displays a single available item in the Available pane.
4. Select CS_Voice_Main and use the [ ] to bring this item into the Selected pane.
5. Click Run.
6. Confirm that both the data grid and pie chart views are accessible and display identically as with the previous report execution
on CUIC Premium.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 185 of 193
Cisco dCloud
Module 5 Conclusion
Through the completion of this module, you have become familiar with the features and capabilities of CUIC Standard and CUIC
Premium. You have explored reporting requirements and identified situations where cosmetic customization is not sufficient to
meet customer needs. You have translated requirements into a report design and then harnessed the capability of CUIC Premium
as a platform to create custom reporting for Unified CCX end users and to package and deliver this functionality so that it is readily
available from within CUIC Standard and available to end-users.
While this concludes the lab modules, we invite you to take your learning to the next level and explore the creation of additional
reports using the baseline custom report example provided.
Lab Conclusion
This concludes our lab learning exercises. We invite students with additional time to re-visit modules of interest or to complete
those that may have been skipped and further explore the capabilities of Cisco Unified Contact Center Express.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 186 of 193
Cisco dCloud
NOTE: The CAD to Finesse migration utility can be used with any version of UCCX supported for direct upgrade to 11.0(1). Check
the Compatibility Matrix for versions supported for direct upgrade to 11.0(1).
What is Migrated?
Workflow Group HTTP Actions associated with non-Default Workflow Lists are not migrated. Only actions associated with the
Default Workflow List are migrated by this utility.
The Workflow Group configuration is migrated to the Finesse Team ONLY if the Finesse Team name matches the Workflow Group
name.
If the Workflow Group name matches the Finesse Team name, the Workflow Group specific configuration will be associated with
the Finesse team. If the Workflow Group name does not match the Finesse Team name, the configuration will be migrated to
Finesse, but will have to be assigned manually to the Finesse Team.
If the Finesse Team has configuration associated with it, the utility will append the newly migrated configuration to the Finesse
Teams configuration.
1. Open or bring focus to the RDP session connected to wkst1.dcloud.cisco.com (Charles Holland).
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 187 of 193
Cisco dCloud
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 188 of 193
Cisco dCloud
5. Give consent for the utility to run by typing Yes as shown below.
Next, we need to choose the phase to run. Export allows us to extract the CAD LDAP and serialize it on the disk where the utility is
being run. Import phase uses the previously serialized information to configure Finesse.
NOTE: The import phase must be run by the utility in the same location (PC, folder etc.) as the export phase.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 189 of 193
Cisco dCloud
6. We will first export the configuration from UCCX1. At the Select the phase to run (export/import): type export.
7. When prompted to enter the IP address of the CAD server, enter 198.18.133.19.
8. When prompted to Begin export? (Yes/No) type Yes. This action will close the utility and create the extracted CAD
configuration.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 190 of 193
Cisco dCloud
We must now import the extracted CAD information to UCCX2 so that it can be added to the Finesse configuration.
4. When prompted with This script send anonymous data back to Cisco. Do you concent? (Yes/No), enter Yes.
5. When prompted with Enter Finesse FQDN in hostname.domain.suffix for, enter uccx2.dcloud.cisco.com.
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 191 of 193
Cisco dCloud
http://www.cisco.com/c/en/us/td/docs/voice_ip_comm/cust_contact/contact_center/crs/express_10_6/design/guide/UCCX
_BK_CBB99111_00_cisco-unified-contact-center-express/UCCX_BK_CBB99111_00_cisco-unified-contact-center-
express_appendix_0111.html
http://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/cust_contact/contact_center/crs/express_11_0/programming/g
uide/EditorSeriesVol1.pdf
Cisco Unified Contact Center Express Editor Step Reference Guide, Release 11.0(1)
http://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/cust_contact/contact_center/crs/express_11_0/programming/g
uide/EditorSeriesVol2.pdf
Cisco Unified Contact Center Express Expression Language Reference Guide, Release 11.0(1)
http://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/cust_contact/contact_center/crs/express_11_0/programming/g
uide/EditorSeriesVol3.pdf
http://www.cisco.com/c/en/us/td/docs/voice_ip_comm/cust_contact/contact_center/crs/express_11_0/config/guide/UCCX_
BK_U2F148AE_00_unified-ccx-administration-guide/UCCX_BK_U2F148AE_00_unified-ccx-administration-
guide_chapter_010000.html
http://www.cisco.com/c/en/us/td/docs/voice_ip_comm/cust_contact/contact_center/crs/express_11_0/user/guide/UCCX_B
K_U36B58A5_00_uccx-report-user-guide-11.html
Cisco Unified Contact Center Express Historical Reporting Guide, Release 11.0(1)
http://www.cisco.com/c/en/us/td/docs/voice_ip_comm/cust_contact/contact_center/crs/express_11_0/user/guide/UCCX_B
K_UA808DBF_00_uccx-historical-reporting-guide-11.html
http://www.cisco.com/c/dam/en/us/td/docs/voice_ip_comm/cust_contact/contact_center/crs/express_11_0/reference/guid
e/Unified_CCX_Database_Schema_Guide_Release_1101.pdf
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 192 of 193
Cisco dCloud
2016 Cisco and/or its affiliates. All rights reserved. This document is intended for Cisco Partner Training. Page 193 of 193