CPM 0602 SP4 Implementation Guide
CPM 0602 SP4 Implementation Guide
Implementation Guide
Version 6.2 SP4
Copyright 2012
Pegasystems Inc., Cambridge, MA
This document describes products and services of Pegasystems Inc. It may contain trade
secrets and proprietary information. The document and product are protected by copyright
and distributed under licenses restricting their use, copying distribution, or transmittal in
any form without prior written authorization of Pegasystems Inc.
This document is current as of the date of publication only. Changes in the document may
be made from time to time at the discretion of Pegasystems. This document remains the
property of Pegasystems and must be returned to it upon request. This document does not
imply any commitment to offer or deliver the products or services described.
This document may include references to Pegasystems product features that have not been
licensed by your company. If you have questions about whether a particular capability is
included in your installation, please consult your Pegasystems service consultant.
For Pegasystems trademarks and registered trademarks, all rights reserved. Other brand or
product names are trademarks of their respective holders.
Although Pegasystems Inc. strives for accuracy in its publications, any publication may
contain inaccuracies or typographical errors. This document or Help System could contain
technical inaccuracies or typographical errors. Changes are periodically added to the
information herein. Pegasystems Inc. may make improvements and/or changes in the
information described herein at any time.
www.pega.com
Using the CPM Service Process Accelerator to Create New Service Processes ..... 6-13
Setting up the CPM Service Process Accelerator ....................................................... 6-14
Running the Accelerator.................................................................................... 6-14
Testing and Fine Tuning the New Process ................................................................ 6-19
Troubleshooting ................................................................................................... 6-19
1-1
“One-and-Done” Service Process Automation
Through automated best-practice service workflows that are directly integrated with
your legacy and back-end systems in real time, you can resolve customer issues
quickly — without transferring or calling back customers, and without passing service
fulfillment to the back office. The result is more efficient and effective service. Other
capabilities such as automatic correspondence and service request audit trails
minimize manual work and reduce time-consuming work transfer.
Multi-Channel Support
Customer Process Manager includes integrated, multi-channel support capabilities for
managing telephone, e-mail, and Web-based service interactions. Using PegaCALL,
Customer Process Manager provides robust CTI support including adaptive screen
pops, desktop telephony controls, and enhanced call-out facilities. By leveraging the
business rules engine architecture, you can re-use your business processes and rules
across channels — from the IVR to the Web.
1-2
capabilities enable you to travel from a summary view of your entire operation down
to the details of a single service-request case.
The call waits in queue and is ultimately answered by a CSR. The PBX provides
information at this time, which drives screen pop processing at the CSR’s workstation
to display the caller information as the call arrives. The screen-pop information
displays in a concise window that highlights the key information required to begin
servicing the call.
The connection between the ACD and the PegaCALL application also allows CSRs to
issue telephone switch commands from the workflow for controlling the call. Examples
of such commands are hanging up on a call, transferring a call, and making the CSR
phone ‘not ready’ for calls.
For information about installing PegaCALL, see the PegaCALL™ Installation and
Upgrade Guide.
For information about configuring PegaCALL, see the PegaCALL Configuration and
Operations Guide.
1-3
PegaCHAT and Customer Process Manager
PegaCHAT provides a pre-configured foundation of rules for the integration of
Customer Process Manager with third party chat applications.
PegaCHAT rules are installed with CPM. You must be licensed to use PegaCHAT in your
environment.
For information about configuring PegaCHAT, see the PegaCHAT Configuration and
Operations Guide.
Business Managers — responsible for evaluating the Framework solution and possess a general,
non-technical understanding of its features and capabilities
Project Managers / Business Analysts — responsible for implementing a Framework solution that
can be applied to specific business requirements, ensuring compliance and continuous
improvement across organizations
System Architects / Application Developers — responsible for building, maintaining, modifying, and
extending the Framework
System and Database Administrators — responsible for the installation, security, and ongoing
operational functions of the Framework such as access, tuning, and troubleshooting; presumed to
be experienced with system operations.
1-4
Documentation Set
In addition to this document, the Customer Process Manager documentation set
includes:
Customer Process Manager™ User Guide — describes how to use Customer Process Manager and
intended to be used by users and their managers. This document is included on the media.
Customer Process Manager™ Installation Guide — describes how to install Customer Process
Manager in your environment. This document is included on the media.
Customer Process Manager™ Upgrade Guide — describes how to upgrade Customer Process
Manager from a previous release. This document is included on the media.
PegaCALL™ Configuration and Operations Guide — describes how to configure and operate
PegaCALL in your telephony environment.
PegaCALL™ Installation and Upgrade Guide — describes how to install PegaCALL to work in your
telephony environment.
PegaCHAT Implementation Guide — describes how to implement PegaCHAT for customer service
via web-based chat.
All sources are available on the Pega Developer Network (PDN) — a section of the
Pegasystems Support Network located at pdn.pega.com. In addition, configuration
details, technical notes and how to articles for using PegaRULES Process Commander
can be accessed in the Application Developer Help and on the PDN.
1-5
Chapter 2: Deploying the CPM Framework
This chapter provides information about what is already set up in the system and what
changes you need to make to begin deployment of the CPM Framework.
Default Work Groups, Workbaskets, Operators, Access Groups, Access Roles and
Privileges
Operator ID:CASysAdmin
Password: install
2-1
The Application landing page provides access to information about your application.
Multiple features allow you to document your application and its use cases, obtain an
inventory or rules, review recent changes and developer activity, and more.
As you extend your Framework, complete the Full Description and Usage fields on the
History tab of each rule form. Enter information in these fields that explains what the
rule is for and how it is used. This information is displayed in some landing pages for
reference, and you can then create a list view report that shows the information you
entered for each rule.
RuleSet Hierarchy
You can view a list of the RuleSets in CPM from the Designer Studio by selecting the
> Application > Structure > RuleSet Stack landing page option.
The RuleSet Stack tab displays the high level RuleSet stack for each application rule
defined in CPM. Expand an application to list its RuleSets.
RuleSets are arranged hierarchically with the more general rules at the bottom and
more specific rules at the top.
2-2
The RuleSets at the bottom are standard in all applications and control the underlying
Process Commander operations; while the rules towards the top control CPM
application functions. RuleSet order is critical to rule resolution. To find the appropriate
rule, Process Commander begins with the top RuleSet in the list, and if the rule is not
found moves to the next RuleSet.
MyCoCA — CPM sample rules for such things as dialog scripts, campaigns, and knowledge content
Note: This RuleSet is typically removed from the hierarchy before production deployment.
PegaSCM-CPM — CPM Infrastructure rules which are necessary to run a service case that exists
outside CPM
CPM — top-level RuleSet for CPM functions;your site-specific RuleSets should use the CPM RuleSet
as a pre-requisite
PegaAppCA — base rules for the CPM processes and data definitions
Pega-FW-OAuth — functions to build the OAuth authorization parameters required for Social Media
Integrations with CPM
2-3
CPM Application Definitions
Application rules contain use case details and specific configuration for applications
defined using PRPC. CPM ships with several pre-defined applications. Applications are
arranged hierarchically and inherit from each other. To extend CPM’s features, you
create applications that inherit from CPM applications.
MyCoCA
Built on application: CPM
MyCoCA is a sample application built on the core CPM application that provides samples
configuration and extensions. MyCoCA should not be part of your production CPM application
hierarchy.
CPM
Built on application: PegaChannelServices
CPM contains the core application RuleSets required to use CPM and defines the standard use
cases and classes for interactions and service processes. Your site specific applications should
inherit from the CPM application in order to extend its features.
PegaChannelServices
Build on application: SCM
PegaChannelServices contains base RuleSets for Pega frameworks and integration RuleSets,
classes and use cases for CTI and Chat integrations.
SCM
Build on application: PegaRULES
SCM contains the core application RuleSets that contains all the CPM infrastructure rules that are
required to execute the service cases that exists outside the CPM. Your service cases application
should inherit from the SCM application in order to use them in CPM Interactions.
2-4
Key CPM Work Classes
The Classes in PegaCA-Work contain the CPM specific work related rules. Work classes
organize the different types of work required by users. You can view the CPM work
class structure in CPM from the Class Explorer.
• Work- class.
2-5
Note: PegaCA-Work, Interaction, and Quality Review are class groups.
@baseclass
• Data-Party
2-6
Inheriting from CPM Classes
When you deploy CPM in your environment, it is important that your class structure
inherit from the CPM class structure. The following table provides an example of how a
company named Acme inherits from CPM work classes using both directed and pattern
inheritance. See the Application Developer Help and the PDN for more about setting
up directed and pattern inheritance at your site.
As an example, from the Class Explorer select the PegaCA-Work class. Scroll down to
the Interaction class and right-click the 3-box symbol to the left of the label.
2-7
Configuring CPM Application Settings
In CPM version 6.2, application configuration settings have been consolidated into a
single map value rule to simplify configuration. You must configure this map value in
order for your CPM-based application to execute properly at runtime, and in order for
your application configuration to be reflected in the CPM landing pages within the
developer desktop.
Each application built on the CPM application can maintain separate configuration
settings, allowing for multiple applications in the same environment to maintain their
own behaviors.
To update these settings, copy the CAApplicationSettings map value rule into an open
RuleSet defined within your application .
Edit the values in the ‘Response’ column to meet your site’s class structure and
preferences:
2-8
Field Name Description
DialogClass Specify the class used to store dialog rules. This setting will be updated
by the ‘Dialog Options’ landing page. See “Chapter 4 – Landing Pages” for
details
KnowledgeContentClass Specify the class used to store Knowledge Content rules. For more details
on Knowledge Content rules, see Chapter 6 – Service Processes.
SiteSpecificPrefix Specify a prefix to be used with the CPM Service Process Accelerator. The
accelerator will add this prefix to flow rules and SLA rules created for
easier identification
DialogMethod Specify ‘flowaction’ to associate dialog rules with each flow action in a
process. Specify ‘assignment’ to associate dialog rules with assignments
in a process. These values can also be configured using the Dialog
General Options landing page.
CompositeSearchDefault Controls the default tab that displays when the search interaction and
service items are selected from the composite.
Setting this to ‘Service Items’ will set the service item search as
the default tab
AutoRefreshMyWork Setting this option to true will refresh the user’s worklist on the dashboard
whenever they return to the dashboard if they have completed an
interaction or work item/case.
Default leave this value blank
Each work object has a unique property, .pyID, that is computed by combining a
system assigned number and a prefix, .pyWorkIDPrefix, defined by the work object
model. The table below lists the prefixes used by CPM.
2-9
ID Prefix Work Object Class Description
pxcpmA- PegaCA-Work-CPMAccelProject Used by the CPM Service Process Accelerator for
creating new service processes
S- PegaCA-Work Used for all non-interaction customer service
work objects
The table below lists the default work groups, workbaskets, and worklists used by
CPM.
Work Groups
Default
Workbaskets
AccountException Account Maintenance
CoachingSession Complaints
CPMAccelBasket GeneralService
2-10
InboundCorrespondence IncompleteConnections
KnowledgeUpdate MaterialFulfillment
OpenNewAccount Opportunities
OutboundCorrespondence PhotocopyRequest
Quality Review Survey Review
SystemEnhancements Transfers
Worklists
CACSR CASalesManager
CAManager CASysAdmin
CASalesRep CAAccountManager
The table below lists the default operators and their access groups.
CASalesManager CASalesManager
CASysAdmin CASysAdmin
CAAccountManager CAAccountManager
The table below is a matrix of CPM access roles and privileges assigned to those roles.
Roles
CAAccountManager
CASalesManager
CASysAdminr
CASalesRep
CAManager
CACSR
Privileges
Perform x x x
2-11
Roles
CAAccountManager
CASalesManager
CASysAdminr
CASalesRep
CAManager
CACSR
Privileges
Update x x x
Reopen x x x
AssignExpertSkills x x
AssignKnowledgeContent x x
QualityReview x x x
SelectUITheme x x x x x x
UpdateDialog x x x
UpdateCampaigns x x x
UpdateCoachingTips x x x
UpdateHotKeys x x x x x x
UpdateHotKeysAdmin x
UpdateNavigation x x x x x x
ViewManagerContent x x x
NOTE: CPM 6.2 introduced new user portals and a new user interface that allows greater
customization and branding and an improved user experience. The old style CPM UI and
portals (CACSRPortal, CAManagerPortal, CASalesRepPortal, CASalesManagerPortal and their
derivatives) are no longer supported. CPM operators must use the new UI and portals
provided with CPM 6.2 (listed above)
2-12
CPMCSR_Portal
CPMCSR_Portal Gadgets
Area Gadget/Functions Portal Controls
Home/Dashboard Dashboard Graphs New Work Menu
My Work Search
Home/Analytics Interaction Reports Channel Tools Menu
Throughput Reports Reference Tools Menu
Quality Reports User Preferences/Profile
Logout
2-13
CPMManager_Portal
CPMManager_Portal Gadgets
Area Gadget/Functions Portal Controls
Home/Dashboard Dashboard Graphs New Work Menu
My Work Search
Home/Analytics Interaction Reports Channel Tools Menu
Throughput Reports Reference Tools Menu
Quality Reports
Ageing Reports User Preferences/Profile
Customer Satisfaction Logout
Knowledge
Management
Home/Manager Quality Review
Tools Management
Campaign
Management
Business Analyst Tools
Reassign Work
2-14
CPMSalesRep_Portal
CPMSalesRep_Portal Gadgets
Area Gadget/Functions Portal Controls
Home/Dashboard Dashboard Graphs Search
My Work Reference Tools Menu
Home/Analytics Opportunity Reports User Preferences/Profile
Throughput Reports Logout
Quality Reports
2-15
CPMSalesManager_Portal
CPMSalesManager_Portal Gadgets
Area Gadget/Functions Portal Controls
Home/Dashboard Dashboard Graphs Reassign Work
My Work Search
Home/Analytics Opportunity Reports Reference Tools Menu
Throughput Reports User Preferences/Profile
Quality Reports Logout
Ageing Reports
Customer Satisfaction
Home/Manager Campaign
Tools Management
2-16
CPMAccountManager_Portal
CPMAccountManager_Portal Gadgets
Area Gadget/Functions Portal Controls
Home/Dashboard Dashboard Graphs Search
My Work Reference Tools Menu
My Favorites
Home/Events Calendar User Preferences/Profile
Home/Analytics Opportunity Reports Logout
Throughput Reports
Quality Reports
Ageing Reports
Customer Satisfaction
The schemas for these databases can be viewed and modified via the Database
Schema wizard that is launched from the Tools menu by selecting Database > Modify
Database Schema. See Application Developer Help topic About the Modify Database
Schema Wizard.
2-17
Work tables
pca_work — interaction and service work objects
pca_intent_summary – roll-up of intent context and usage data; used for adaptive suggestions
PegaCALL tables
pa_CTI_CALL — call data from the telephony environment
2-18
Note: Consult your database administrator to customize and tune the database tables for optimal
performance.
For a list of those tables and details about the data stored in each table, see the
Integrating CPM chapter.
2-19
Chapter 3: Modifying the CPM User
Interface
This chapter describes how to configure CPM user interface components. Sections are:
CPM Interaction Portal – designed for contact center personnel who manage multiple-simultaneous
customer interactions (such as phone, email, chat), and manage post-interaction and other work.
CPM Customer Case Portal – designed for other front-office personnel that need to manage
customer requests and obligations.
3-1
Interaction Tabs
CPM supports multiple navigation methods during customer interactions — Classic and
Tabbed. These navigation modes let you select the best user experience for your
employees that match their skill levels, work style, and role. For further information,
refer to the topic Choosing Interaction Navigation Methods later in this chapter.
At any point, the CSR can perform or review post-interaction and other work, or
research customer information through the General Work area (General Tabs) of the
portal.
General Tabs
CSRs can access dashboard, graphs, and other portal gadgets through their Home
area.
3-2
Home Area
General Tabs
Users can access dashboard, graphs, and other portal gadgets through their Home
area.
3-3
Home Area
3-4
Understanding CPM Interaction Navigation Options
CPM supports multiple navigation methods for managing customer interactions.
Organizations can choose to utilize one or both methods of navigation depending on
their needs.
Classic
Tabbed
3-5
Tabbed Interaction Navigation Method
This navigation method is optimized for complex processes with dense screens. This
navigation model may feel more similar to other desktop applications because users
select and launch processes from the left panel of the display. This method allows
multiple service processes to be in-flight at the same time during an interaction. Each
new service process opens a new tab under the interaction dialog thumbnail display.
Note: These navigation methods apply only to the CPM Interaction portal and also apply only to
work that occurs during an interaction. Navigation and processing of work post-interaction or
research session is the same for either portal.
3-6
User-level control is implemented via the UpdateNavigation privilege. This privilege is
included in all standard CPM roles (example: PegaCA:CSR).
To disallow users from determining their own navigation method, delete the
UpdateNavigation privilege from the user role. Conversely, to allow user selection of
navigation method, add the privilege to any new roles created for your
implementation.
3-7
Understanding CPM Portal Skins and Themes
CPM portals are designed to work with the CPMBrand portal skin.
Use the PRPC Branding Wizard to modify styles in this skin, or to add custom styles.
Refer to PRPC Developer help for more information on the PRPC Branding Wizard.
CPM portals have also been designed to accommodate multiple UI themes. A theme is
a background image and highlight colors that will override the baseline portal skin.
End users can select from multiple themes to change the appearance of their desktop.
3-8
For more information on creating themes, refer to the topic CPM Themes in Chapter 4.
For more information on selecting themes via user preferences, refer to the CPM Users
Guide.
a. Check it out.
b. Save it.
c. Check it in.
3-9
Configuring CPM Portals
This section includes the following topics.
Body — is the container for the interaction area, general work area, and home areas of the portal
The following table lists the header and body sections used within each of the standard
CPM portals:
To customize the functions that are available on the portal headers, access the header
for your portal, such as CPMInteractionHeader and Save into your RuleSet.
Select a control on the heading, and then click the magnifying glass to display
parameters.
3-10
Search for the name of the navigation control (e.g., CPMInteractionPortal_ NewWork)
from the PRPC search area, and then modify the control according to your site’s needs.
For information on customizing the New menu option for interaction objects, refer to
the Configuring Interactions chapter.
CPMGeneralWorkGadget — controls the behavior and display of the general work area
3-11
The sections below describe how to configure gadget parameters and options.
You can control the function and display of the CPMPortalGadget by specifying various
parameters. These include:
Specifying tab and work types
3-12
To specify tab and work types:
The Start Up and Supported areas of the CPMPortalGadget parameters display
specify the type of work that can be processed. Options include:
Field Description
Start Up – used for Home and General work areas
Selected ? Check a single item in the start-up category to set as the default portal
tab
Tab Type Enter one of the following options:
Tab Hidden Check this box if the tab is to be hidden until there is work to be
processed
Show Close Check this box if the tab should include an X icon, that allows the user to
close the tab manually
Interaction Class Specify the class name the harness/section field below.
Use Section Check this box if you are using a section, rather than a harness for this
tab type
Harness/Section Specify the name of the harness or section for this tab type
Full Height Check this box.
Min Height Reserved for future use.
Thread Name Enter the text value for the thread name CPM will use to process work of
this type
Supported – used for interaction work types (e.g., phone call, chat)
Tab Type Enter one of the following values:
Show Close Check this box if the tab should include an X icon, that allows the user to
close the tab manually
Interaction Class Enter the name of your site specific interaction class that inherits from
the appropriate CPM class
Use Section Reserved for future use.
Harness/Section Reserved for future use.
Full Height Reserved for future use.
Min Height Reserved for future use.
3-13
To control tab behavior and limits:
In the top portion of the CPMPortalGadget parameters screen, you can specify the
behavior and appearance of interaction tabs. Options include:
Field Description
Thread Family Enter the text value for the thread family name
Tab Width Enter a pixel value for the width of interaction tabs in regular (wide)
mode
Tab Visible Choose whether interaction tabs:
Start with small (start small then widen to full width based
on conditions specified below)
Start with regular. Using this options, tabs will start in a full
(wide) state and remain that way.
Start small when (start small then widen based on the when
condition specified below)
Small Tab Width Enter a pixel value for the width of interaction tabs in small
(condensed).
Start small when This option is only visible if the “Start small when” option is selected in
the Tab Visible field. Enter the name of a when rule.
Max Number of Tabs Specify the maximum number of interaction tabs that a user can open
at the same time. This number will include the number of tabs
specified in the start-up area. For example, if you have 3 start-up
tabs, and enter 10 as the maximum value in this field, the user will be
able to open 7 additional interaction tabs before receiving an error.
Switch to Regular Tabs When
Have the following tab Switch to regular (wide) interaction tabs, when there is work of the
types following types. Enter one or more Tab Type values, separated by
commas
3-14
Field Description
Have more than one tab Switch to regular (wide) interaction tabs, when there is more than one
of type of the following work types. Enter one or more Tab Type values,
separated by commas
Return to Small Tabs Return from regular (wide) tabs to small tabs when the above
when conditions have conditions (have the following tab types, have more than one tab of
not been met type) are no longer met.
3-15
Access the advanced parameters for this gadget to configure the gadget. Choose
options as needed for your implementation, such as the maximum number of open
tabs.
3-16
Configuring the My Favorites Gadget
The MyFavoritesGadget enables a user to view their list of favorites from the
dashboard area of their user portal and:
1. On the Detail tab of your data source rule, check the Use As Favorites? box.
2. Specify the name of the Portal Smart Info Activity and the Favorite Keys. The
Smart Info activity is called when the user expands an item in their list of
favorites.
3-17
Configuring RSS News Feeds
CPM provides the ability to associate Really Simple Syndication (RSS) feeds with data
source instances. The RSS feed is available in the CPM user portal in the composite
area for the data sources that have been configured with this capability for users with
the appropriate privilege.
3-18
2. Install the PegaFW-NewsFeed:06-02 rule set and add it to appropriate
applications for your users.
3. Users must have the EnableNewsConfig privilege to edit news feeds.
When the user selects a result from the list, CPM opens a tab in the general work area
to either display the work object (case), or the data source. Portal search does not
start new interaction objects or work types.
3-19
Configuring Portal Search for External Data Sources
CPM uses Data Source rules to configure portal search functions for external data
sources. For any external data source you wish to include in the CPM portal search,
complete the following procedure.
1. On the Search tab of your data source rule, check the Use in Portal Search?
box and specify the name of the integration activity CPM should call to perform
the search query.
2. On the Retrieval tab of your data source rule, enter the information in the
table below.
Field Description
Default Interaction Enter the name of the your site -specific class that inherits from the
Container PegaCA-Work-Interaction-Research class. CPM will use this class to
create a temporary work object to display data source results
Display Harness Enter the name of the harness in the default interaction container
class that CPM should use to display data source information once
the user selects a result of this type from the portal search results list
Retrieval Activity Enter the name of the integration activity (in the default interaction
container class) that CPM should use to retrieve any additional
information needed to populate the display harness view
3-20
Configuring Search for Cases/Work Objects
CPM uses the PRPC Lucene search facility for work objects/case data. CPM will search
for your work types/objects only if they are listed on your Application rule, or an
inherited Application rule.
When the user selects a work object/case from the portal search results list, CPM will
open a tab in the general work area using the Review harness for that work type.
For more information on enabling Lucene search of work data for your application,
refer to PRPC Developer Help.
3-21
Harness Type Scripts
Work Perform Harnesses CAToolsNavigation
(e.g., PegaCA-Work-Interaction.CPMPerform)
Main Portal Harnesses pega_cpm_dialogmanager
(e.g., CPMManager_Portal) pega_cpm_callchatdialog
pega_cpm_menuactions
pega_cpm_tabbedinteraction
pega_cpm_callchat
testcallchatemulator
CPMCTICallTimer
Cpmchatsendevents
pega_cpm_chattabeventhandler
Portal “Home” page Harnesses CPM_gadgetscript
(e.g. CPMManager_Home)
pega_cpm_tabbedInterface
When dialog should be displayed (a phone interaction) versus when no dialog should be displayed
(inbound correspondence interaction)
CPM makes extensive use of the following When rules to vary the display of sections
and containers within harnesses.
CAInCall, CANotInCall (used to evaluate whether work is occurring during an interaction or post-
interaction)
CATabbedNavigation, CANotTabbedNavigation
CAInteractionTypeForDialog, CAInteractionTypeForNoDialog
Note: While customizing CPM harnesses, it is important to be aware of conditional displays and
incorporate any differences needed to meet your requirements.
3-22
Conditional display within Harness controlled by the Visible When reference.
While the harnesses used to display customer composite information share the same
included sections, the harnesses vary by navigation method.
For the classic interaction navigation method, the composite can be customized by modifying
the CAComposite harness shown below.
For the tabbed interaction navigation method, Each tab of the composite uses a separate
harness. To modify composite display options, you can use one of two methods:
3-23
• Use the CPM Composite landing page ( > CPM > Customer Data Management > CPM
Composite), as shown in the image below. In the Data Display section for each category,
enter the name of your harness rule and specify other options as needed.
• Modify the CPM Interaction Driver rule for your interaction class directly, by saving a copy of the rule into
your RuleSet and modifying details on the Composite tab. The system will present the tabs in the order
as listed on the driver rule. You can also specify a condition to display the tab conditionally, and can
specify whether to defer load for the tab.
• You can configure tabbed navigation to anchor one or more composite tabs to the main window
whenever a user clicks the tear-off icon to display the composite in a separate window.
On the Composite tab of the Driver rule, expand the tab and check the Stay-Back box if you want that
tab to remain anchored during the tear-off. Repeat for each tab you want to anchor.
3-24
See Adding Workflows as Interaction Tasks in the Configuring Interactions chapter for
more information about interaction driver rules
For a view of the standard composite sections and the composite mapping detail, see
Appendix A: Composite Screen Data Mapping.
3-25
Using Other CPM UI Configuration Controls
This section describes:
The following are examples of localized Field Values and how they can be applied to a
user interface in CPM. In this example, changing the localized label of the
ReasonForInteraction field value results in a universal text change when the value is
referenced during processing.
3-26
Note: If you do not need to support multiple user languages, enter the field text directly on the
user interface form or through an update to the Field Value instance — this is the preferred
method for changing text universally in the application. For more information about localized Field
Values, see Application Developer Help and the PDN article "Localizing an Application".
3. On the Matrix tab, edit the List Max values for the ItemHistory and
ReviewItems types.
4. Click Save.
3-27
Chapter 4: Using CPM Landing Pages
This chapter describes how to use CPM landing pages to view and configure your
application. Topics are:
4-1
The following table describes the function of each CPM landing page.
Interactions
Interaction Types Configure processing options for interaction work types. Add new
interaction types.
Interaction Driver Configure CPM interaction driver processing options for each
interaction type, including interaction task categories
Interaction Tasks Configure interaction task options. View tasks by interaction type
and task category.
Service Cases
Service Types Configure processing options for service work types.
Service Accelerator Launch the CPM service process accelerator to create new service
types. View open or pending accelerator processes
Customer Experience
Intent and Content View the intent criteria used to suggest processes and content to
Suggestions users
Customer Data Management
CPM Composite Configure CPM composite data retrieval and display options for your
application
CPM Data Sources View the CPM data sources used within your application including
those sources used for CPM composite displays, dialog property
references, and portal search functions
Dialog Management
Dialog Cross Reference View the dialog scripts associated with processes and flow actions
within your application
General Options Configure general dialog options used by your application, including
dialog method and greetings
Knowledge Management
Content Inventory View and search for knowledge content
Content Cross View the knowledge content associated with processes and flow
Reference actions within your application
Hot Topics View and analyze most frequently used and highest rated
knowledge content
Content by Author View knowledge content by author
Knowledge Updates View and analyze requests for changes to knowledge content
Quality Management and Coaching
Coaching Tip Inventory View coaching tips defined by work type and process action
Quality Review Analysis View a summary of quality reviews by overall score and work type
User Experience
CPM Themes Configure user interface themes
4-2
Common Landing Page Controls
This section describes common user controls within CPM landing pages:
My Application (default) — limits the display to results defined in the top-level application’s
RuleSets.
All Inherited — displays results defined in the top level application RuleSets, as well as those
defined in inherited (or ‘built-on) applications for the current user.
Your user id has check-out authority (if your application RuleSets use check-out)
None of the rules that will be updated by the landing page are marked as final.
Class definitions are not in locked RuleSets (if the landing page requires an update to a class
definition).
On landing pages that allow for updates, you may see the following buttons:
Update — Click this button to check-out any rules needed by the landing page and enter your
changes. You may be prompted to perform a Save As function to add the rules needed to
another RuleSet and version. If one or more of the rules needed by the landing page is either
checked out by another user or is marked as final — or if your user id does not have check-out
authority, the Update button will be disabled and appears with an error icon.
Save — This button appears if all the rules needed by the landing page are in an unlocked
RuleSet that does not use check-out.
4-3
The information icon displays the list of rules that are being modified including the rule
name, RuleSet and RuleSet version.
Save — saves the work in progress, but does not perform the check-in operation
Cancel — deletes any checked out rules and clears pending rule updates.
Note: If you use standard PRPC rule check-in functions to check-in a rule while it is being
modified on a landing page, you may not be able to complete Save or Check-in functions from
the landing page. In this situation, the Update button will be disabled, and you must manually
check-in any remaining rules.
Warnings indicate configuration that does not adhere to CPM best practices.
Errors indicate missing or incorrect configuration that will result in incorrect or unanticipated
system behavior.
4-4
Configuration alerts may appear:
At the top of the landing page. Landing page-level alerts are used to evaluate general
configuration conditions.
For an entry within a landing page list. List-level alerts appear when you expand a row on a list,
or when you click the Check Configuration button on the landing page. List-level alerts are used
to evaluate the configuration a particular row.
The configuration alerts that may be displayed within each of the CPM landing pages
are described in Configuring Your Application Using Landing Pages topic in this
chapter.
Interaction Types
The CPM Interaction Types landing page lets you view, add, and modify interaction
work types defined within your application. Interaction work types will only be visible
on this landing page if:
The work type is identified on the Details tab of your Application rule, or an Application rule from
which your application inherits
The work type is defined in a RuleSet that is listed in the Application or inherited Applications (i.e.,
not specified in an access group).
For each interaction work type used within your application, such as phone call or
inbound correspondence, you can view the number of total and currently open
interactions. You can also view and modify general and interaction start options.
4-5
To add or update an interaction type:
1. Click Add to add a new interaction type. To update an existing interaction type,
expand the row to show detail and click Update.
Field Description
Short Description The short description for this interaction work type. For
example: “Inbound Correspondence”
Interaction Type The default interaction type value for this work type. For
example: “email”
Inherits From Select the class from which this interaction inherits. When
adding a new interaction type, CPM will default this value to your
application’s interaction class group.
Class The class of this work type. This field can only be selected when
the interaction type is being added. CPM will default this value
by appending your short description value (above) to the
Inherits From value selected above.
Overall SLA Select the SLA for this interaction type.
Starting Activity Select the starting activity for this interaction type.
Starting Workflow Select the starting workflow for this interaction type.
Configuration Alerts
CPM verifies your configuration to check for the following conditions that may cause
unexpected results.
Configuration Alerts
There is no CPM system settings (CAApplicationSettings map value rule) defined in the current
Application RuleSets. As a result, this landing page may not display your interaction types properly.
There is no corresponding Interaction Driver rule for this interaction type nor is there an Interaction
Driver rule for this class group.
There is no corresponding Interaction Driver rule for this interaction type. The Interaction Driver for
the interaction class group will be used.
There is no corresponding work type defined in the Application for this interaction type.
Missing starting activity for this interaction type
Missing starting workflow for this interaction type
Missing model for this interaction type
Missing SLA definition for this interaction type
Missing starting workflow for this interaction type
4-6
Interaction Driver
The Interaction Driver landing page lets you configure the way in which tasks and task
categories appear in the CPM Interaction Driver during a customer interaction. You
can also configure other Interaction Driver display and behavior options.
Field Description
4-7
Default Category Select the default task category to display. This category will appear by
default in the Other processes area of the CPM Interaction Driver.
Check for Campaign Check this box to evaluate campaign definitions for this interaction type. If
Offers? unchecked, CPM will not evaluate any campaign rules configured for
suggested offers.
Tabbed Navigation Options
Allow Queuing of Check this box to enable operators to select and queue processes. This
Tasks? option is only used for the Tabbed navigation method.
Display Interaction Check this box to display the interaction log. This option is only used for the
Log? Tabbed Navigation method.
Interaction Driver Categories
Category Name The name to appear in the category list in the interaction driver
Data Source Select the data source for this task category.
Behaviors Show Tasks Only – This category will be included in the Interaction Driver.
Tasks in this category will not be evaluated for suggestions and will not
appear in the Suggested processes area of the Interaction Driver.
Show Tasks & Suggestions - This category will be included in the category
list of the Interaction Driver. Tasks in this category will also be evaluated for
suggestions and will be included in the Suggested processes area of the
Interaction Driver if conditions are met.
Display When Optional. Specify a condition to display this category of tasks.
Interaction Tasks
The Interaction Tasks landing page lets you view, add, and modify the tasks that
appear in the CPM Interaction Driver.
4-8
To add or update an interaction task:
1. Click Add to add a new task. To update an existing task, expand the row for
that task and click Update.
Field Description
Task Properties
Starting Activity (standard task) Select a starting activity for this task.
Available in Task List? Uncheck this box to prevent the task from showing in
the list of available tasks in the CPM Interaction
Driver.
Task Suggestion
Suggest When Optional. Select one or more suggestions (Intent
When rules) to cause this task to appear in the
suggestions area of the CPM Interaction Driver.
Reason for Suggestion This field displays the short description for any
suggestion selected above.
Service Types
The CPM Service Types landing page lets you view, add, and modify service work
types defined within your application.
Service work types will only be visible on this landing page if:
The work type is identified on the Details tab of your Application rule, or an Application rule from
which your application inherits
The work type is defined in a RuleSet that is listed in the Application or inherited Applications (i.e.,
not specified in an access group).
You can view the service work types used within your application, such as Address
Change or Dispute Transaction, as well as the number of total and currently open
cases. For each service type, you can also view configuration details.
4-9
To add or update a service type:
1. To update an existing service type, expand the row to show detail and click
Update.
2. Enter the following:
Field Description
To add a service type, select the Add button. This will start the Service Accelerator.
For more information on the Service Process Accelerator, see Using the CPM Service
Process Accelerator to Create New Service Processes in the Configuring Service
Processes chapter.
Configuration Alerts
CPM verifies your configuration to check for the following conditions that may cause
unexpected results.
Configuration Alerts
Model rule for this class does not exist and must be created for this process to function correctly.
Service type is missing a starting activity.
There is no SLA defined for this service type.
4-10
Configuration Alerts
The system settings definition for your application must be configured in order to view your site-
specific service types in this landing page.
Service Accelerator
The CPM Service Accelerator landing page displays the service types that are in the
process of being configured, and lets you start the CPM service process accelerator to
configure new service types.
To continue work on a service process accelerator work object, double click on the
row. This resumes the wizard and brings you to the current object assignment.
4-11
Intent and Content Suggestions
During a customer interaction, CPM presents the user with suggestions for tasks and
knowledge content based on criteria configured in your application. The CPM Intent
and Content Suggestions landing page helps you identify the suggestions that are
defined within your application, and which suggestions are applied to tasks and
content.
Viewing suggestions
The Suggestions list displays the name of each suggestion, as well as the reason for
suggestion and the work type for which the suggestion is applicable. This list also
identifies the total number of references to the suggestion within your configuration.
To view the logic criteria configured for this suggestion, click the suggestion name.
To view task or content details, click the name of the task or content. To view the
logic criteria configured for the suggestion, click the suggestion name.
4-12
CPM Composite
The CPM Composite landing page displays the data sources that make up the
composite display for each interaction type. For each data source, you can view data
retrieval details, such as associated list view and declarative data definitions.
Additionally, you can view and update options data display options.
4-13
Field Description
Data Retrieval
Data Source Select, the data source for the composite data context. The
dropdown displays data source rules that are designated as
‘composite’ in the data source rule forms.
Data Display (these options used only for the Tabbed Navigation method)
Display When Optional. Select a condition (when rule) that determines when the
composite tab is displayed.
Harness Select a harness to use to display the data source.
Defer Load of Tab? Indicates whether to defer load on this tab until the user selects
the tab
Pre Display Activity Optional. The activity needed to pre-process data.
To add new data sources to your composite, update the CPM Interaction Driver rule for
your interaction class directly. For more information, see the topic on Customizing the
CPM Composite in the chapter Modifying the CPM User Interface.
Configuration Alerts
CPM verifies your configuration to check for the following conditions that may cause
runtime errors or unexpected results.
Configuration Alerts
No data source has been defined for this composite tab. You may want to
update your driver rule.
4-14
Dialog Cross Reference
The Dialog Cross Reference landing page identifies the dialog scripts associated with
processes and flow actions within your application.
For any work type and process, expand the row to view the dialog scripts associated
with process actions. Click on the process or dialog name to be directed to that rule
form.
4-15
General Options
The Dialog General Options landing page lets you view and configure general dialog
options defined within your application.
Field Description
General Options
Dialog Method Choose Flow Action-Based or Assignment-Based
Dialog Class Select the class name to be used for dialog rules. CPM will use this
class to create new dialog rules. CPM will also look for dialog
instances in this class during interaction processing.
Greeting Options
Tabbed Interaction Greeting – Select the name of the dialog rule instance to be used as the initial
Initial customer greeting during interaction processing. This option applies
to the tabbed navigation method only — classic navigation will use the
dialog instance associated with the process flow and action.
Tabbed Interaction Greeting - Select the name of the dialog rule instance to be used as the
Secondary secondary greeting during interaction processing. This option applies
to the tabbed navigation method only — classic navigation will use the
dialog instance associated with the process flow and action.
Content Inventory
The CPM Knowledge Content Inventory landing page lets you view and add knowledge
content.
For each knowledge content entry, you can view configuration details, such as
category, topic, description, type, author, and rating. Expand the row to view content
abstract and usage information. To navigate to the knowledge content rule for any
row, click on the topic name.
4-16
To add knowledge content:
1. Click Add to add new knowledge content. Knowledge Content rules are created
in the Knowledge Content class defined by your application settings.
2. Follow the steps listed in Creating a New Knowledge Topic, in the Configuring
Service Processes chapter.
For any work type and process, expand the row to view the content associated with
process actions. Click on the process or content name to be directed to that rule form.
Hot Topics
During a customer interaction, CPM presents the CSR with knowledge content based
on criteria configured in your application. The CPM Hot Topics landing page helps you
identify the most popular topics defined within your application.
4-17
Content by Author
The CPM Content by Author landing page helps you find topics defined within your
application and sorts the results by the author who last modified the topic. You can
view topics modified within a given date range by entering the start and end dates in
the Modified between fields.
Knowledge Updates
CSRs using knowledge content in your application have the option to request changes
to the content, with each suggestion creating a work object. The CPM Knowledge
Updates landing page lets you view the list of content suggestions for the current
month, by status (Open, Resolved, etc). Use the chart drill down capabilities to review
the details of knowledge update requests.
4-18
Coaching Tip Inventory
CPM enables authorized supervisors or managers to create coaching tips for their
employees that remind them of best practices or areas to improve. These coaching
tips are associated with specific process actions and can be assigned to individual CSRs
or to work groups.
The Coaching Tip Inventory landing page lets you view the coaching tips defined within
your application. Coaching tips are listed by the work type and process step with
which they are associated. Expand any row within the list to view the specific
coaching tip text as defined by the manager or supervisor.
For more information on configuring CPM coaching tips, refer to the topic Using
Supervisory Functions within the CPM User Guide.
Customer Process Manager Implementation Guide
4-19
Quality Review Analysis
The Quality Review Analysis landing page presents a summary report of completed
quality reviews by work type and overall score. Use the chart drill down capabilities to
view the details of any quality review case.
For more information on quality review processes, refer to the topic Using Supervisory
Functions within the CPM User Guide.
CPM Themes
The CPM Themes landing page lets you view and configure user interface themes for
your CPM portals. CSRs and other users can select from available themes to change
the look of their desktop.
4-20
To add or modify a theme:
1. Click Add to add a new theme. To update an existing theme, click Update.
2. Enter the following:
Field Description
4-21
Chapter 5: Configuring Interactions
This chapter focuses on the set up and configuration of rules, controls, and data
elements that control the processing of CPM interactions.
Topics are:
Modify the CPM portal menu control that starts customer interaction processes to reflect your site-
specific interaction classes
Optionally, configure demo screen pop functions to enable testing and development.
5-1
3. Double click on the interaction type to display the menu entry form.
Column Description
5-2
Parameters For phone interactions, add the parameter sInteraction. Enter the name of
your site-specific phone interaction class in the Value field.
5. Click Save.
Access these activities by navigating to the Interaction Types landing page ( > CPM
> Interactions > Interaction Types) and update the starting activity referenced by
interaction types in your applications.
Activity Description
CAInteractionStart Starts an interaction
CAInteractionStartFromChat Starts a chat interaction after receiving an inbound chat event
CAInteractionStartFromCTI Starts a phone interaction after receiving an inbound call event
3. Double click the Demo Screen Pop entry in the navigation form
5-3
Column Description
Add parameter paramN. In the Value field, enter the name of the
model rule that contains test data to start the interaction. The default
model rule used by CPM for demo screen pop is CPMDemoScreenPop.
5. Click Save.
5-4
Adding Workflows as Interaction Tasks
The Interaction Driver controls which tasks an operator can access during a customer
interaction.
In Classic navigation mode, these tasks appear in the Other Processes section of the
Interaction Driver.
In Tabbed navigation mode, these tasks appear in categories directly beneath the To-
Do area of the Interaction Driver portion of the screen.
Creating multiple interaction driver categories for tasks within the same class
5-5
Adding Task Categories to the Interaction Driver
Edit the Rule-PegaCA-InteractionDriver rules to modify the available task categories.
The default instances are:
Note: You can add a row to create a new category or modify an existing one.
5-6
Column Description
Category Name The name to appear in the Other Processes category list
Data Source Select the data source rule associated with this category.
When Optional. Select a condition to display this category of tasks.
Behavior Show Tasks Only – This category will be included as a task category in
the Interaction Driver. Tasks in this category will not be evaluated for
suggestions and will not appear in the Suggested processes area of the
Interaction Driver.
Show Tasks & Suggestions - displays the category and evaluates the
contents for suggestions.
Use Dynamic Check this box if you want CPM to dynamically set the default category of the
Default Other processes area in the CPM Interaction Driver based on a value you can
Category? configure. If checked, CPM will use the declare expression,
CADynamicDefaultCategory, to determine the default category. You can
configure this expression to meet your site’s needs. If CPM cannot determine
a valid category based on this expression, it will use the default category
specified in the Default Category field (see below).
Default Category The selection list to use as the default within the Interaction Driver display
Show End Check this box to indicate an end interaction task to be added to the process
Interaction queue
Custom Used to reference a custom HTML fragment rule that controls event handling
Fragment
Check Offers Check this box to evaluate campaigns. If unchecked, CPM will not evaluate
any campaign rules nor suggest any offers.
Allow Queuing Check this box to enable operators to select and queue processes. This
option is only used for the Tabbed navigation method.
Show Interaction Check this box to display the interaction log. This option is only used for the
Log Tabbed Navigation method.
4. Click Save.
5-7
Adding Workflow Processes to Interaction Task Categories
If you create a new workflow, you can add it to an Interaction Task Category that
appears in the CPM Interaction Driver.
2. Enter a class value. This Applies To value determines in which category list the
task appears. For example, if you use PegaCA-Interface-Account, the task
appears in the Account list.
Field Description
Short Description Required. Enter a short description, which appears in the appropriate task
selection lists within the application.
Task Tab
Task Type Standard – Used for tasks within CPM
External – used for tasks that live on other Process Commander systems
Advanced – reserved for future use; no fields on the advanced task type
should be utilized
5-8
Associated Class Choose a PegaCA-Work-Interaction class to which the task applies.
(standard task) Choices include:
PegaCA-Work-Interaction
PegaCA-Work-Interaction-Call
PegaCA-Work-Interaction-InCorr
PegaCA-Work-Interaction-Outbound
PegaCA-Work-Interaction-Research
SnapStartURL (external The string, including parameters, that is used to call the task on the
task) external Process Commander Server
Show in List of Uncheck this box to prevent the task from showing in the list of tasks
Available tasks? available in the Interaction driver.
Tabbed Navigation Runs on interaction – Select if this task runs on the interaction object only;
Options (standard and it does not instantiate a separate work object
external types)
Requires tab in focus – reserved for future use
Field Description
Criteria Tab
Intent Conditions The intent conditions list shows Rule-PegaCA-Intent-When rules defined in
the Interaction class. When an instance of the Intent-When class is
specified, the IntentLed flag is set. CPM then scans all tasks with the
IntentLed flag set and checks the Intent-Whens to find any that evaluate
to True. If any evaluate to True, the task appears as a suggested process
or automatically queue the task. See “Configuring Intent Rules” in
Chapter3 for more information on configuring intents.
Action Select Suggest to suggest the task to a CSR; select Queue to automatically
queue the task.
Visual Cue Click the Lookup icon and select the visual cue that will associated with the
task
5-9
Security Tab
Privilege class & If used, the user must have this privilege in order for the task to appear in
Privilege Name the appropriate interaction driver category; entry is the same process used
to enter this for flow actions
Contact Roles This tab is a placeholder for security information.
5. Click Save.
Note: This class is not the work object class. Its only purpose is to generate the list of
tasks for your new interaction driver category.
a. In the Page field, specify the clipboard page on which the task
executes
5-10
Displaying Top-Rated Knowledge Links
The interaction driver in Tabbed Navigation mode can display links to top-rated
knowledge content below the task menus. This allows CSRs to access via a single click
the most popular knowledge articles referenced by CPM users.
2. In the Tabbed Navigation Options section of the Interaction Driver tab, check
the Show Embedded KC box.
3. Click Save.
5-11
Adding Custom Content to an Interaction Driver
You can use a predefined section called CPMInteractionDriverExtension to add custom
content to an interaction driver in Tabbed Navigation mode. When configured, the
section appears at the end of bottom of the driver when it is displayed.
3. Click Save.
These processes appear in the Suggested Processes are of the Interaction Driver. You
can modify the available business process suggestions and the processes that display
them.
5-12
Business Process Suggestions Using the Classic Navigation Method
To see a full list of Intent When suggestions, as well as a list of references to those
suggestions, use the Suggestions landing page.
5-13
Evaluating Suggestions for Different Interaction Types
CPM Interaction driver rules control the task categories that are evaluated to
determine suggestions during an interaction.
CPM supports a number of interaction driver classes, each of which drives a particular
type of interaction. See Adding Workflow Processes as Interaction Tasks for additional
information about the interaction driver.
3. On the Interaction Driver tab, complete the fields described in the procedure
Adding Task Categories to the Interaction Driver. To specify whether
suggestions are evaluated for a given category, choose the appropriate
Behavior for that category.
4. Click Save.
5-14
Modifying Business Process Suggestions
You can add criteria to intent tasks to evaluate whether a process should be suggested
to the CSR or automatically queued to the interaction screen.
2. Select the task you wish to suggest and save it to your RuleSet. In this
example, the task for DisputeTransaction is used.
a. Select an Intent Conditions value from the selection list. See Configuring
Intent When Rules.
b. Indicate if you want to suggest the process to the CSR or queue the process
for the CSR when the condition evaluates to True.
c. Select the Visual Cue you want to associate with the condition from the
image catalog that displays when you click the Lookup icon
d. You can specify multiple intent conditions on this form. They will be
evaluated as OR conditions.
4. Click Save.
5-15
Configuring Intent When Rules
Intent When rules contain the criteria that is used to suggest task or campaigns to a
user. CPM Intent When rules can be re-used between multiple Intent Task and
Campaign rules.
For information on associating Intent When rules with business processes, see
Suggesting or Queuing Business Processes. For information about associating Intent
When rules with offers and campaigns, see Setting Up Campaigns and Opportunities in
the Configuring Other CPM Components chapter.
3. Complete the fields on the Criteria tab described in the table below. Clicking
the arrow next to a label expands it to display additional entry fields.
Field Description
Short Description Required. Short description of the task, which appears in task selection lists
throughout the application.
Label Assign a label to the criterion that can be referenced in the logic field.
5-16
Field Description
Data source Select a valid data source. Default sources include:
Event – used to evaluate whether a particular task occurred (for example, for
a recent address change, suggest this process)
IVRData – used to evaluate data received from the interactive voice response
(IVR) system
Field Select the property to be evaluated; the list includes properties available for the
selected data source.
Operation Select the comparison operation
Value Enter the comparison value
Task Class Select a class; this field appears only if a data source of type “event” is selected
Task Name Select a task within the specified category; this field appears only if a data source
of type “event” is selected
4. Click Save.
5-17
Task suggestions are limited to suggestions based on Intent-When conditions that,
when true, display the associated intent tasks on the harness.
3. List the Intent-When conditions that, when true, enable the display of the
associated intent tasks.
4. Click Save.
A sample RuleSet is available in the CPM Resource kit located on the installation media
that demonstrates integration with Process Commander’s Decision Strategy
Manager (DSM), a separately licensed component.
For information about DSM see the PDN article About the Decision Strategy Manager.
For licensing information, contact your account executive.
5-18
Interaction Driver tasks and suggestions
Field Description
Details Tab
Short Description Short description of the data source
Type Select whether the data source is a page, list, or special
Page Enter the name of the clipboard page to use for this data source
Class Enter the class of the clipboard page entered in the Page field
Property Optionally, if you selected a List type of data source, enter .pxResults
as the property name
Property Class Optionally, if you selected a List type of data source, enter the class of
the .pxResults list
Composite Data Source? Check this box to indicate that this data source may be used as a
composite data source. This field will be evaluated in order to
populate data sources within the Interaction Driver and CPM
Composite landing pages.
Dialog Data Source? Check this box to indicate that this data source may be used for data
references within dialog scripts. This field will be evaluated in order to
populate the data source selection field when configuring dialog
scripts via the CPM Configuration Tools wizard.
5-19
Field Description
Show News Feeds? Determines whether the ‘News’ tab will be available on data source
composites for data sources of this type. Users must also have an
associated privilege to view.
Use as Favorite? Determines whether this data source type can be used as a ‘Favorite’
in the My Favorites gadget. Users will see an ‘Add to Favorites’ button
in the UI fpr this data source in case portals.
Portal Smart Info Sets the activity to use to populate SmartInfo data shown when a
Activity user expands one of his ‘favorites’ from the My Favorites gadget.
Properties Tab
Property Properties included on this tab will be used to populate the list of
available fields that users can insert into dialog scripts using the CPM
Configuration Tools wizard.
Search Tab
Use in portal search? Check this box to indicate that CPM should use this data source when
performing a portal search function
Search activity Select the integration activity that should be used to perform the
search operation
Retrieval Tab
Default Interaction Specify the name of the class that should be used as a temporary
Container container for retrieving and displaying results when a user selects a
result from the portal search results list
Display Harness Specify the name of the harness that should be used to display data
when the user selects a result from the portal search results list
Retrieval Activity Specify the name of the activity that should be used to retrieve data
needed to display data when the user selects a result from the portal
search results list
4. Click Save.
5-20
Configuring Adaptive Suggestions
CPM tracks usage of tasks and campaigns and dynamically suggests tasks or offers for
“like” customers.
3. Click Save.
5-21
Configuring Adaptive Suggestions for Tasks or Offers
CPM will evaluate intent usage data for “like” customers as well the percentage
likelihood value you configure in order to suggest a task or offer during a customer
interaction. As users select tasks and accept offers, CPM will calculate frequency and
dynamically alter the suggestions presented to the user.
To configure an adaptive suggestion, first create an Intent-When rule that specifies the
likelihood percentage that should trigger a suggestion.
4. Enter the likelihood percentage that you want to use. It is not necessary to
enter other customer criteria (e.g., CustomerValue = Gold), as CPM will
automatically match according to the system-wide customer data criteria you
configure. See the procedure, To Change the Data Used to Capture Customer
Intent Usage, on the next page.
5. Click Save.
5-22
Changing Data Used to Capture Customer Intent Usage
CPM will automatically capture and match certain customer data when evaluating
likelihoods. By default, CPM matches on CustomerValue and Interaction Goal.
To change the context data that is captured and used by the system when
evaluating adaptive suggestions:
1. Create a class that inherits from the PegaCA-Data-ContextSnapshot class.
2. Determine what data elements you want to track. This data will be used to
categorize customer interaction (context) data and intent usage data. The data
you select should represent categories of customers or interaction types for
which you think likelihood may vary. This data must be available on the
clipboard for your customer interaction objects.
5-23
a. add the property to the class you created in Step 1
4. Update the database tables used to store interaction context data and intent
usage summary data. Update these tables to expose the properties you created
in Step 3.
pca_intent_context
pca_intent_usage_summary
5. Update the Data-Admin-DB-Table instances for the class you created in step 1
and the PegaCA-Data-IntentUsageSummary class to reference the database
tables you modified in Step 4.
5-24
7. Copy the PegaCA-Data-ContextSnapshot.CAMapContextData activity to the
class you created in step 1. Save it to your RuleSet.
Update the activity to map the data properties you created in Step 3.
5-25
b. Copy the CACreateSummaryInsInteraction activity to the class you created
in step 1. Save in your RuleSet. Update Step 7of the activity to include the
properties you created in Step 3.
5-26
9. Copy the PegaCA-Data-ContextSnapshot.CAAggregateData list view to the
class you created in Step 1.
On the Display Fields tab, enter the properties created in Step 3 of this
procedure.
5-27
12. Update the activity CAGetIntentFrequencies activity to reference the properties
you created in Step 3.
5-28
Changing the Frequency of Intent Usage Data Tallying
1. From the Class Explorer, select Rule- > Agent-> Queue to display a list of
queues. Select the CPM Agents instance.
3. Click Save.
5-29
Configuring Interaction Preferences
This topic describes:
3. Modify the Default Value. You can select Contact, Account, or None if you want
no verification.
4. Click Save.
5-30
Defining Call Reasons
CPM automatically determines the reason for an interaction and presents that value
during the interaction wrap-up.
A map value rule lets you specify how the reason is determined.
3. Add, modify, or delete the Default values. The possible values are 1, 2, or 3:
2 = First work object created; if no work object is created, the first interaction event is used
4. Click Save.
5-31
Configuring the CPM Interaction Timer
CPM displays an interaction timer control to give users a visual cue as to interaction
handle time. Interaction duration is shown in hours:minutes:seconds in relation to the
goal and deadline defined within the SLA object for the interaction work type. The
color of the icon will change from green to yellow to red as the duration exceeds the
goal and deadline time.
1. Use the CPM Interaction Types landing page to select the overall SLA instance
used for that interaction type. Select > CPM > Interactions > Interaction
Types.
2. Expand an interaction type within the list and click the rule name in the
Overall SLA Definition field.
4. Set the goal value to the goal for the interaction time.
5. Set the deadline value as the maximum for your interaction time.
5-32
6. Repeat this procedure for each of the interaction work types that will be used
by your application.
7. Click Save.
2. Select the HTML Property instance applied to PegaCA-Work and save it to your
RuleSet.
4. Click Save.
5-33
Changing Net Promoter Settings
During interaction wrap-up, CPM will calculate Net Promoter scores based on the
response to the question “Would you recommend us to a friend?”.
4. Click Save.
5-34
3. On the Table tab, modify the logic as necessary.
4. Click Save.
5-35
3. On the Evaluation tab, enter a cutoff score and select the method you want to
use to match cases.
4. Enter the match conditions you want to use to evaluate the work criteria.
Note: For a case to be selected, the combined score for that work item based on all the
conditions you configure must be greater than or equal to the value in the cutoff score field.
5. Click Save.
5-36
2. Save it to your RuleSet.
3. On the Table tab, enter the parameters in the Conditions table based your
desired configuration.
4. Click Save.
See the Customer Process Manager User Guide for information about how to use the
Customer Experience Blueprint control.
5-37
To configure the customer experience blueprint for your interaction goals:
For each goal you have defined in the PegaCA-Work-
Interaction.DetermineInteractionGoal decision table, create an InteractionGoal field
value.
1. From the App Explorer, select PegaCA-Work >Data Model > Field Value. > New.
Field Description
Applies To The name of your site-specific work class that inherits from
Field Name InteractionGoal
Field Value The name of your interaction goal
Description The name of your interaction goal
Localized Label The name of your interaction goal
3. Click Save.
5-38
To configure the rule types that are displayed in each blueprint quadrant:
Optionally, you can change the mapping of rule categories that included in the display
of blueprint quadrants:
1. In the Find gadget, enter CACustExperienceXML to display the XML rule for the
blueprint quadrants.
3. In the XML tab, update the values list for the quadrant category. In this
example, the quadrant name is Process.
4. Click Save.
Flow action-based dialog ― the system presents dialog for a process/flow action combination. Dialog
can be associated with any flow action, and the UI will dynamically adjust the dialog based on the
currently selected flow action. This is the default CPM setting.. No configuration to flows is required to
use this method.
Assignment-based dialog ― the system presents dialog for a process/assignment combination. If the
user selects multiple flow actions within the assignment, the dialog does not change. To use this
Customer Process Manager Implementation Guide
5-39
method, developers must create a dialog HTML instance and associate it to an assignment within the
workflow. This was the default CPM setting prior to the V6.1 release of CPM
Configuration of the dialog scripts for both methods is implemented using the Business
Analyst ConfigurationTools control as described in the Customer Process Manager User
Guide.
You can configure the dialog method the system uses in two ways:
To change the dialog method using the Dialog Options landing page:
1. Open the landing page via > CPM > Dialog Management > General Options.
2. Click Update.
To change the dialog method using the CAApplicationSettings map value rule:
1. Open the CAApplicationSettings map value rule in PegaCA-Admin-
ApplicationSetting via the Rules Explorer.
5-40
3. Click Save.
When condition rules define the name of an operator skill level. In CPM, the default
skill names are CACSR1, CACSR2, and CACSR3.
To change the operator skill definition, you can replace the default skill definition
(CACSR) with a skill that you create.
Note: if you have specified a different dialog class for your application, you select that class
instead of PegaCA-Dialog.
2. Enter a rule name that is a concatenation of ‘CACSR’, your skill name and a skill
level (i.e. CACSRBilling3). Save it to your RuleSet in your application’s dialog
class. The ‘When’ rule must begin with ‘CACSR’ in order to be used to
conditionally display dialog text.
5-41
3. On the Advanced tab, update the skill level in the field name.
4. Click Save.
5. Repeat this process for each of the skill levels you want to define.
Note: The rule must have the Dialog Data Source box checked for use with the CPM
Configuration Tools wizard.
5-42
2. On the Detail tab, select the page and class of the Property Source.
4. On the Properties tab, select the properties that can be used to include in
dialog scripts. Users will be able to select from these properties when using the
CPM Configuration Tools wizard to create or modify dialog scripts.
5. Click Save.
5-43
Configuring Tabbed Navigation Interaction Greetings
For the tabbed navigation method only, the HTML instances used for initial and
secondary interaction greetings must be specified in the Interaction Driver rule.
Alternatively, you can specify the greetings using the Dialog Options landing page.
See the Using CPM Landing Pages chapter for more information.
This procedure is not necessary in Classic Navigation mode, as the system can
determine the appropriate dialog from the CAInteractionDriver flow itself.
2. On the Dialog tab, enter the name of the HTML instance rule (PegaCA-Dialog
class) you want used in the initial and secondary interaction greetings.
3. Click Save.
5-44
Chapter 6: Configuring Service Processes
This chapter describes the ways in which you can extend CPM service process
functions by:
Using the CPM Service Process Accelerator to create new service processes
Note: As an alternative to this manual procedure, you can use the CPM Service Process Accelerator to
create new service processes. See Using the CPM Service Process Accelerator.
Prior to adding a class, you may need to copy the PegaCA-Work class group into your
RuleSet.
1. From the Class Explorer, select PegaCA-Work. Click next to the class that is
most like the one you want to create to display the Class form.
6-1
3. In the Settings section of the General tab, verify that the class is Concrete
and that it belongs to a class group. Enter PegaCA-Work in the Class Group
and Class Inheritance sections. If your service process will be a PRPC case,
set the parent class to PegaCA-Work-Cover- or to a site specific class that
inherits from PegaCA-Work-Cover-.
4. Click Save.
3. Enter the AppliesTo class from Step 1, the Property Name and Property
Type.
6-2
5. On the General Tab, complete the property definition.
6. Click Save.
Include service object references within the interaction log during a customer interaction -
Log activity
Manage the housekeeping necessary to switch between a service object and an interaction
object during the course of a customer interaction - CAReturnToCaller activity
Manage the dialog scripts associated with your service flow if you are using the
assignment-based dialog method - CADialog assignment rules and HTML dialog instances
These activities have been incorporated into a sample service workflow to help you
develop your own service workflows.
6-3
2. Click Save As, enter the Class Name from Step 1 and save it to your RuleSet.
3. On the Pages & Classes tab, reference the new class you created.
4. Use the following standard Assignment activity rules within your flows.
CADialogWorklist
CADialogWorkBasket
CADialogWorkListOrBasket
Note: If you are using flow-action based dialog methods, you can use standard Process
Commander assignments. If you are using assignment-based dialog methods, you must use
the CPM assignments listed above. For more information about dialog methods, see
Configuring the Dialog Method.
5. Create new HTML instances for the dialog associated with each assignment.
Create the new instances in the PegaCA-Dialog class and include the name of
the HTML instance in the parameter property panel of the assignment.
Skip this step if you are using flow –action based dialog methods.
6-4
6. Click Save.
7. Create additional workflow elements (such as flow actions, local actions, and
utilities) based on your process needs. See Application Developer Help and PDN
for more information about creating these rules.
1. From the App Explorer, select PegaCA-Work-Interaction > Technical > Activity.
6-5
3. Click Save As. Enter PegaCA-Work-Interaction in the Applies To field, the
Activity Name, and save it to your RuleSet.
4. On line 5 of the Steps tab, click to expand the method and then enter a
value for the WorkType parameter for your new workflow. This WorkType value
is referenced by a Map Value rule that you create in Step 8.
Note: To test your new workflow, you must complete the remaining six steps in the
Creating New Service Workflows process.
5. On the Pages & Classes tab, enter CAInteraction as the Page Name and
PegaCA-Work-Interaction as the Class.
7. Click Save.
2. Click SaveAs. Enter the class name in the Applies To field and enter a Service
Level name. You will use this name as the value of the .pySLAName property in
Step 6. Save it to your RuleSet.
6-6
3. On the Events tab, enter your service level detail.
4. Click Save.
1. From the App Explorer, select the PegaCA-Work >Statement Copy>Model >
pyDefault.
2. Enter the class name from Step 1 in the AppliesTo field, the Model Name and
Short Description.
6-7
3. Save it to your RuleSet.
Field Description
.pyFlowName The name of the workflow you created in Step 3
.pyLabel field Description of the workflow you created (in quotes)
.pyDescription Description of the workflow you created (in quotes)
.pySLAName The name of the service level rule you created in Step .
6. Click Save.
NOTE: This step only applies if your service item will be a PRPC case (cover). For standard work
items (non-covers), you can skip this step.
1. Create a new case type rule, or copy an existing one from another service
process. The name of the rule will be set to pyDefault automatically.
b. Select any coverable work types that can be added to the case in the
Coverable Work Types section.
6-8
3. Select the Standard task type from the dropdown.
5. In the Starting Activity field, enter the name of the activity you created in
Step 4.
6. Check the Show in List of Available Tasks check box to add the workflow to
the Interaction Driver Selection list.
7. Click Save. To have your new process suggested to CSRs based on specified
criteria, see Configuring Business Process Suggestions.
1. From the App Explorer, select PegaCA-Work > Decision > Map Value >
CAWorkClasses.
6-9
2. Add a row and enter your new Work Type and its associated Class Name. Use
the work type that you entered as the WorkType parameter value in Step 4.
3. Click Save.
ConfirmationTitle
HeaderTitle
SpecificInfoTitle
TaskUsage
2. Click SaveAs. Enter the class name from Step 1 in the Applies To field and
save it to your RuleSet.
6-10
3. In the Localized Label field, enter the text you want to appear in the
confirmation title.
4. Click Save.
1. From the App Explorer, enter PegaCA-Work > User Interface > Section >
CAWorkSpecific.
2. Click SaveAs. Enter the class name from Step 1 in the Applies To field and
save it to your RuleSet.
3. Update the layout to incorporate properties and captions for your service
process.
4. Click Save.
6-11
Step 12: Updating your application rule
In this step, you add your new work type and class to the application rule for your
application.
1. From the Rules Explorer select Application Definition > Application to display a
list of application rules. Open the rule for your application.
2. On the Details tab, enter your new work type and class in the Name and
Implementation Class fields in the Work Type section.
3. Click Save.
1. From the Rules Explorer select Application Definition > Application UseCase.
2. Right-click and select New. Select your Application Name and Work Type
that you entered in Step 11.
6-12
4. On the Definition tab, select the Trigger, Actor, Complexity, Status, Shape
and On Behalf Of.
6. Click Save.
Troubleshooting
6-13
Setting up the CPM Service Process Accelerator
Before you run the accelerator, you must configure the following site-specific values.
Class structure
Prefix
3. Click Save
6-14
Note: Click Next >> to be guided through the accelerator entry screens. Click << Back to
return to the previous entry screen and click Cancel to exit the accelerator
4. Click Next>>.
5. Indicate whether you want to create a new work type or use an existing work
type, such as a work type created by the Process Commander Application
Accelerator.
6-15
If you select the option, Create a new work type, enter a work type and
description of the work performed by the work type. Enter use case details for
the work type.
The new work type you enter generates a new class instance and other rules
needed to support your process. The Accelerator removes any spaces between
words. Do not enter non-text characters. Examples of work types are:
Product Survey
Technical Support
Order Fulfillment
The work description you enter is the text displayed in confirmation harnesses
and search options available to the user. Examples of work descriptions are:
Fulfillment Request
If you select the option, Use an existing work type, select that work type
and enter use case details for the work type.
6. If you want your work new work type to be a case (and have the ability to
cover other work, as well as access PRPC Case Management features), check
the box next to ‘Create service process as a case’.
8. Select the Interaction Driver process list category value. Enter the
corresponding interaction driver text. If you want your new CPM service process
to appear in more than one category, you can manually add an instance of a
Rule-PegaCA-Intent-Task rule after you have finished using the Accelerator.
6-16
Optionally, select one or more intent rules, or add a new one. Then, specify
whether to suggest or queue the intent via the dropdown list. Finally, select the
image you want to associate using the search icon.
These rules suggest your new service process to users under conditions that
you specify. If you do not specify an intent for your process now, you can add it
later by updating the Rule-PegaCA-Intent-Task instance that is generated by
the Accelerator.
9. Click Next>>.
10. Define SLAs by entering the overall goal and deadline completion time for your
new service process. The default time unit is hours.
If you want to specify levels using different time units (days, for example) or
add escalation activities, you can manually modify the Rule-Obj-ServiceLevel
instance created by the Accelerator.
12. Optionally, add any properties you need for your new service process. For each
property, enter the property name, description and type. The Accelerator allows
you to specify simple property types. However, if your new process requires
complex properties, you can add them manually.
6-17
14. Select the display options for the properties you defined on the previous form.
Depending on the display selected, enter the list of values or the format. You
can change these rules or add property attributes by manually modifying the
Rule-Obj-Property instance created by the Accelerator.
16. Review the confirmation information. Click Finish to create the rules for your
new process. Click <<Back to modify your choices before creating the rules.
6-18
Testing and Fine Tuning the New Process
After the accelerator creates your new process, it displays a screen from which you
can test and tune the process you just created.
The accelerator launches a new session for you to start an interaction and test your
new process. Your process will be available in the Interaction Driver category you
selected. It will also appear in default search options, service item lists, and reports.
2. Click the link to open your HTML section rule to display and customize the
section rule that the accelerator created. This section rule is used in
confirmation and pop-up review harnesses.
Troubleshooting
This section describes issues that can occur when you use the CPM Service Process
Accelerator and how to resolve them.
Resolution: The CAWorkClasses map value rule instance in your CPM work class (for
example, PegaCA-Work) maps the Work Type and Work Class Value for your process.
If a work type is not found for this rule instance, the system uses the default class
Customer Process Manager Implementation Guide
6-19
specified. Check your RuleSet hierarchy to make sure that the CAWorkClasses map
value updated by the Accelerator is the highest in the hierarchy.
Resolution: Verify that the class names entered in the Accelerator map values you
defined in your initial configuration do not have RuleSet restrictions defined in the
Restrictions tab of the Class instance.
Resolution: The default CPM configuration creates the list of service processes
dynamically using the Work-class. Check any custom configuration at your site to
determine if these functions were overridden.
Knowledge categories enable you to organize knowledge topics into like groups.
Knowledge topics pertain to a particular knowledge category and reference the file,
activity, or URL that supplies the knowledge content. Multiple knowledge topics can be
created for a knowledge category.
Note: Authorized business users can associate knowledge topics with any process
screen using the CPM Configuration Tools control – See Using CPM Configuration Tools in
the Customer Process Manager User Guide.
Knowledge processes are special CPM service processes that support and utilize your site’s
knowledge content. CPM supports the following knowledge processes:
6-20
Frequently Asked Questions (FAQ) — enables users to browse and search for knowledge
content; the system maintains a count of topics that satisfy inquiries to present the most
relevant content to the CSR
2. Click New.
6-21
5. Click Save.
2. Click Add.
3. Use the SmartPrompt to select the Category containing the topic and enter a
Topic name.
6-22
5. Enter the following:
Field Description
If File is selected, enter the File Type field (file suffix), and the
name of the Rule-File-Binary definition for the file.
If Activity is selected, enter the name of the activity that will obtain
and display content.
Criteria Tab - See topic Recommending Knowledge Content for more details
Security Tab
Privilege class & Privilege Name If used, the user must have this privilege in order for the content
to appear in Lists of knowledge content throughout the system
(Help, Service Processes, Search Results, etc).
6. Click Save.
Field Description
External Allowed Select this option to enable the content to be available to requests from
external users or systems. Leave it unchecked to limit viewing the content to
internal (CPM) users only.
Content Use the content area to define and format a section of text to be used for
knowledge content. You may add additional sections of text by selecting the
icon below the section.
6-23
Field Description
Internal Check this box to limit an individual section to internal users. When used in
combination with the ‘External Allowed’ checkbox, you can create a single
article that can be re-used for internal and external users, but maintain control
over which sections are displayed for each.
Select the trash can icon to delete an entire authored content section.
Configure the following options on the criteria tab to recommend the knowledge
content article during a process:
Field Description
Suggestion Classes Select associated classes for the Knowledge Content suggestions. The
content rule will be evaluated for suggestion only when the user’s active
work object class matches one of the specified suggestion classes. Classes
are evaluated with an Or condition if multiple classes are specified (Class A
or Class B or Class C, etc).
Intent Conditions Select Intent When conditions to be evaluated. If the Intent-when
conditions are met, and the user’s current work object class is on the
suggested classes list, the content will be recommended to the user.
Intent When conditions are evaluated with an Or condition if multiple
conditions are specified (When A or When B or When C, etc). The
combination of class and Intent When conditions are evaluated using an
And condition (Class A or Class B AND When A or When B).
Visual Cue Click the Lookup icon and select a visual cue that will be displayed when
the content is displayed as a result of a recommendation.
In order for this feature to work properly, PRPC rule indexing must be enabled.
Indexing can be access via the landing page System > Settings > Search and
enabled by clicking the Enable Indexing checkbox, checking‘Rules, Data, Work and
then clicking Re-Index button for each. You should wait for indexing to finish for one
6-24
before starting the other indexing. Reindexing can take a very long time (3 hours) and
varies with the number of rules indexed. System can be used while indexing occurs
but any search results cannot be guaranteed complete until indexing does finish.
When a user rates a piece of content, CPM stores their rating data in the
pca_rating_knowcont table in the PegaRULES database.
3. Click Save.
6-25
Adding a FAQ Process
Follow steps 1 through 12 of the Manually Creating New Service Processes with
the following exceptions:
Step1:Creating New Service Object Classes — add your FAQ process to your site-specific class
group that inherits from the PegaCA-Work-KM- class group
Step 2: Creating New Service Object Properties — if you need additional properties for your custom
process, add them - Otherwise, skip this step; the properties to select and view knowledge topics
are already defined
Step 3: Creating New Service Workflows — Copy the CASampleFAQ flow to your FAQ class, instead
of the SampleCPMServiceFlow
Step 1: Creating New Service Object Classes — add your Diagnostic process to your site-specific
class group that inherits from the PegaCA-Work-KM- class group
Step 2: Creating New Service Workflows — copy the CASampleDiagnostic flow to your class
instead of using the SampleCPMServiceFlow
Step 3: Creating Default Workflow Models —copy the model, pyDefault, from the PegaCA-Work-
KM-SampleDiagnostic class and update the .DiagnosisGoalProperty value to the name of the
property that the process is attempting to diagnose
Step 6. Creating Default Workflow Models —copy the model, pyDefault, from the PegaCA-Work-
KM-SampleDiagnostic class and update the .DiagnosisGoalProperty value to the name of the
property that the process is attempting to diagnose
6-26
For the property specified as the diagnosis goal, create a Rule-Declare-Expression and
a corresponding DecisionTree or DecisionTable. These declarative rules drive the goal-
seek Diagnostic process.
Note: For additional information about configuring Declarative rules, use the online Application
Developer Help and the PDN.
3. Enter the message script on the HTML tab. You can also insert clipboard
references into the HTML to personalize the message for the customer.
4. Click Save.
6-27
Step 2: Create a starting activity
1. From the App Explorer, select PegaCA-Work-Interaction > Technical > Activity
> CAWelcomeMessage.
3. Expand step 1 and enter the name of the HTML record in the Properties Value
field.
4. Click Save.
6-28
3. Open the flow for editing and select the DisplayMessage assignment shape.
On the Edit tab of the properties panel, enter the name of the HTML script in
the Message field.
6-29
3. On the Task tab, enter PegaCA-Work-Interaction in the Associated Class field
and the name of your activity from Step 3 in the Starting Activity field. Leave
the Shown in List of Available Tasks check box blank unless you want the
message to be accessible for all interactions.
4. On the Criteria tab, enter the name of the Rule-Pega-CA-Intent-When rule that
defines the criteria for suggesting this message. The short description of that
rule appears as the reason in the suggested processes area of the Interaction
Driver screen. See Configuring Intent Rules.
5. Click Save.
6-30
Changing CPM Default Values
As a CSR follows a workflow, CPM displays selection boxes with lists of available
options. You can change the values in a list as well as the default value.
Address Types
Location Information
6-31
3. On the HTML tab, add modify, or delete the OPTION VALUE statements.
4. Click Save.
6-32
3. On the HTML tab, find the lines that include “if (Category = =″xxx″) where xxx
is a value listed in the CAComplaintCategory HTML property. Change xxx to
another value listed in the property.
4. Click Save.
6-33
3. On the HTML tab, add modify, or delete the option value = statements.
4. Click Save.
6-34
3. On the HTML tab, add modify, or delete the option value statements.
4. Click Save.
When you change the HTML Property, you must also update the HTML Fragment that
displays the list of values on the confirmation screen.
6-35
3. On the HTML tab, add, modify, or delete option value statements by changing
values and display text.
4. Click Save.
6-36
On the HTML tab, find the section containing this table text:
<td class="ActionLabel">Reason</td>
"other"}Other{/when} </td>
Customer Process Manager Implementation Guide
6-37
3. Update the HTML with the value changes that you made to the
AppDisputeReason HTML property.
4. Click Save.
Address Types
You can replace the default address types, such as home address and billing address,
used by CPM by editing the PA_ADDRESS_TYPE table.
6-38
Communication Option Types
You can replace the default communication option types, such as phone, e-mail, and
fax, by editing the PA_COMMUNICATION_TYPES table.
Location Information
The Location Finder utility in CPM uses location data to identify locations such as
nearby branch offices and display address information.
You can add to, modify, or replace the location data by editing two database tables.
PCA_LOCATION_CATEGORIES defines address and location detail for the category codes
entered in the first table.
6-39
2. Replace the sample entries with your category codes and descriptions.
3. The codes you enter here must be in the CategoryCode column of the
PCA_LOCATION_CATEGORIES table.
3. The category codes you enter here are the codes in the CategoryCode column
of the PCA_LOCATION_CATEGORY_TYPE table.
6-40
Association and Link Roles
You can edit the role descriptions used by CPM for accounts, contacts, and business
units by editing the PA_ROLES table.
You can also add other role affiliations for account, contact, and business unit
associations as well as filter the list of items that appear in selection boxes.
Note: In the PartyType column, C = Contact and B = Business Unit. In CPM many rules,
display screens and queries reference role types 60 and 100. If you remove these types
from the table, you must update all referencing rules.
6-41
Record Name Description
AppRoleDescriptionSelect links an account owner to a new account
AppRelationshipToBUList links an account owner to a new business unit
If the account owner is a business unit:
AppRoleDescriptionSelect links an account owner to a new account
AppRelationshipToB2BList links an account owner to a new business unit
AppRelationshipToBUList links an account owner to a new contact
2. In the Find gadget, type the name of the HTML Property in the table you want
to modify.
3. Select the property instance and save it to your RuleSet. This example uses the
record AppRoleDescriptionSelect.
4. Add, modify, or delete the filter information between the When statements.
5. Click Save.
For more information on configuring external PRPC processes to work with CPM, see to
the technical note Incorporating External PRPC Processes Into Your CPM Application in
the Resource Kit directory of your CPM installation media.
6-42
Chapter 7: Configuring Other CPM
Components
This chapter describes the configuration of additional CPM components.
Topics are:
Configuring Fees
Using a decision tree rule, you can configure multiple messages and the conditions
under which each is presented to the CSR. System-generated notes are identified by
the appearance of a red flag in the priority note area.
To configure these notes, you create messages and then edit the decision tree that
selects which note to display.
CPM contains two declare expression rules defined for contact and business unit
messages. These rules call corresponding decision tree rules with the same name.
CABusinessUnitSystemNote
CAContactSystemNote
7-1
The decision trees call HTML instances containing the priority note. The CPM decision
trees are configured to call the following sample notes:
4. Click Save.
5. From the App Explorer, select PegaCA-Work-Interaction > Decision > Decision
Tree > Declare Expressions > CAContactSystemNote.
7-2
7. Edit the associated decision tree rule, adding notes and conditions to the
decision parameters.
Create a row for each note; enter the condition required to display it.
If you want to display a note in the case that none of the conditions is met, enter its name in the
Otherwise section.
8. Click Save.
Adding a Campaign
7-3
Configuring Offer Types
A map value rule stores a list of available offers for a CRS to present to the customer
based upon an interaction type.
3. On the Matrix tab, update the offer types (Column Name) and the associated
interaction types (Row Name).
4. Click Save.
Adding a Campaign
CPM defines the campaigns as Rule-PegaCA-Intent-Campaign instances.
Note: Authorized CSRs can also create campaigns using the Directed Wizard interface,
described in the Customer Process Manager User Guide.
To add a campaign:
1. From the App Explorer, select Rule-PegaCA-Intent-Campaign to display a list of
instances.
7-4
2. Select an instance, enter a Name for the campaign, and save it to your
RuleSet.
Field Description
Short Description Required. Short description of the campaign.
Campaign Tab
Type Select the type of campaign you are creating from the selection box: Cross-
Sell, Restitution, Reward, or Retention.
Product Select a product from the Product list.
Frequency Enter the number of days that must pass before the campaign may be offered
again to the same contact.
Priority Enter a number from 1 – 100 to identify the priority of this campaign. This
number is used when sorting the list.
Start Date The starting date of this campaign.
End Date The ending date of this campaign.
Objective The reason this campaign is being created.
Mail Corr The name of the mail correspondence to be sent.
Email Corr The name of the e-mail correspondence to be sent.
Class The class to which this opportunity belongs.
Campaign Script The script that is used with this opportunity. This value is a Rule-Obj-HTML
instance in the Opportunity class.
Flow The workflow that is used with this campaign.
Fulfillment Package A reference ID to a package of materials.
7-5
Field Description
Campaign Objections Objections that are defined in scripts and appear in a selection box from which
CSRs make a selection.
Criteria Tab
Intent Whens The intent conditions list consists of Rule-PegaCA-Intent-When instances
defined in the Interaction class. When an instance of the Intent-When class is
specified, the IntentLed flag is set. CPM then scans all the tasks that have
intents with the IntentLed flag set, and checks the specified Intent-Whens to
find any that evaluate to True. When an Intent-When evaluates to true, the
task appears as a suggested process.
Security Tab
Contact Roles This tab is a placeholder for security information.
History Tab Description of the campaign and its usage.
4. Click Save.
Note: Authorized CSRs can also create campaign scripts using a directed wizard interface.
To modify a script
1. From the App Explorer, select PegaCA-Work > Opportunity > Technical > HTML
to display a list of instances.
2. Select the HTML rule you want to modify and save it to your RuleSet.
7-6
3. Update the HTML source to meet your campaign needs.
4. Click Save.
Next Actions
Interest Levels
Next Actions
An HTML property defines the options available in a Next Action selection box during
an opportunity workflow.
7-7
To modify the options:
1. In the Find gadget, enter CANextAction and select the control instance.
4. Click Save.
Interest Levels
A Control defines the options used by a CSR to indicate a customer interest level in
opportunities.
1. In the Find gadget, enter CAInterestLevel and select the control instance.
7-8
3. Add, modify, or delete the option value statements.
4. Click Save.
1. In the Find gadget, enter AppSalesCycleStages and select the control instance.
7-9
3. Add, modify, or delete the option value statements.
4. Click Save.
2. Select RejectReason competitor, enter a field value name, and save it to your
RuleSet.
7-10
3. Update the localized label value.
4. Click Save.
1. In the Find gadget, type CAHandleOpportunity and select the flow rule.
2. Save it to your RuleSet.
3. Double-click the flow diagram to open the flow for editing.
7-11
6. Update the list of local actions in the left properties panel.
Urgency is a rating scale that determines the priority of an assignment or work object
and the resulting order in which assignments appear on worklists. Service levels define
an urgency value that is added to assignments or work objects when one of the
following conditions occurs:
To access SLAs select > Process & Rules > Process > SLAs.
You can use these or copy them to your RuleSet and modify them.
7-12
Note: For information about how to configure a service level rule, see the online help topic About
Service Level Rules.
Example: An account balance of $50,000 may have a platinum SLA profile. The
account balance can be used as a circumstance in the definition of an SLA. Based on
the above example, the platinum account may require expedited service.
4. Update the fields on the Expressions and Pages & Classes tabs as described
in the table below.
Field Description
Short Description Enter a short task description, which appears in the
appropriate task selection lists within the application.
Expressions Tab
Check Condition and Set One or more conditions to check, and the property to set
Property for each condition.
Otherwise Set Property The property value to set if none of the conditions are
met.
7-13
Field Description
Pages & Classes Tab
Identifies the pages referenced in the Expressions tab. You will typically use the
following fields on this tab and the change tracking tab; see the online help for
additional information.
Page Class Enter the class for the category:
Account — PegaApp-Interface-Account
Contact — PegaApp-Interface-Contact
Business Unit — PegaApp-Interface-BusinessUnit
Change Tracking Tab
Calculate Value Select the frequency at which Process Commander
recomputes the value of the target property (the property
immediately following a When statement on the
Expressions tab).
5. Click Save.
SLA overrides allow a CSR to assign a different service level to individual work objects
at the Account Owner, Contact, or Account level through the General task Override
SLA.
Use the following procedure to create overrides that users can select from the
SmartPrompt shown in the example. For more information on Override Profiles, see
the Customer Process Manager User Guide.
7-14
3. Add, modify, or delete the values to define your service level override
requirements.
For more information about configuring a service level rule, see the help topic
About Service Level Rules.
4. Click Save.
Configuring Fees
CPM includes a property called .FeeAmount that you can use as a model for
establishing a fee structure. A declare expressions rules uses the .FeeAmount
property.
7-15
3. On the Expressions tab, edit the if condition and fee amount values.
4. Click Save.
The following table lists CPM reports by report type and their associated conditions for
including data in a report, gadget categories, and gadget models.
7-16
Report Conditions for CPM Report CPM Report Gadget Models
Type Report Inclusion Gadget Categories
Interaction Your company’s objects are CAInteractions, CAInteractionsReports,
included in standard CPM CAInteractionCSR CAInteractionCSRReports
Interaction reports if your
interaction class name
includes the text
“Interaction.”
Throughput Your company’s objects are CAThroughput, CAThroughputReports.
included in standard CPM CAThroughputCSR CAThroughputCSRReports
reports if your class name
includes the text “Work.”
Quality Your company’s objects are CAQuality, CAQualityReports,
included in standard CPM CAQualityCSR CAQualityCSRReports
reports if your class name
includes the text “Work.”
Ageing Your company’s objects are CAAgeing CAAgeingReports
included in standard CPM
reports if your class name
includes the text “Work.”
Opportunity Your company’s objects are CAOpportunity, CAOpportunityReports,
included in standard CPM CAOpportunitySalesRep CAOpportunitySalesRepReports
opportunity reports if your
class name includes the text
“Opportunity.”
Customer Your company’s objects are N/A N/A
Satisfaction included in standard CPM
customer satisfaction survey
reports if your class names
include the text “SatSurvey.”
Knowledge Your company’s objects are CAKnowledgeMgt CAKnowledgeMgtReports
Management included in standard CPM
knowledge management
reports if your class names
include the text “KM.”
Quality Review All site-specific quality review N/A N/A
Management objects are included in CPM
Quality Review Management
reports.
Campaign Your company’s objects are N/A N/A
included in standard CPM
opportunity reports if your
class name includes the text
“Opportunity.”
7-17
Note: Campaign, quality review management, and satisfaction survey report gadgets are NOT
controlled by using a category. To incorporate any custom reports in these gadgets, use the Rules
Inspector to identify the HTML for this gadget, then modify accordingly.
3. On the Expressions tab, update the cost value as cost per second.
4. Click Save.
7-18
6. Save it to your RuleSet.
8. Click Save.
9. Repeat these steps for each class you want to include in the calculation.
Samples are provided for the following classes under PegaCA-Work:
AddressChange
Complaint
Correspondence
General
MaterialFulfillment
Interaction
Interaction-Corr
11. From the App Explorer, select PegaCA-Work > Reports > Summary View.
Select CAApplicationSavings.
7-19
12. Edit the report to meet your requirements.
7-20
2. Add your custom report to the Rule-Obj-Model for that category.
7-21
Configuring the Data Sources used by the Reporting Wizard
To customize the data sources that can be selected via the reporting wizard, use the
following procedure.
1. From the Find gadget, type getClassesForReportWizard and select the Activity
rule instance.
3. Modify the 2nd step of the activity to incorporate the classes needed by your
application.
4. Click Save.
7-22
Using Interactive Charts
Interactive charts allow chart users to grow or shrink the level of detail presented in a
chart using a slider control. The Dashboard tab of the CPM user portals display
interactive charts that are examples of this capability.
CPM-Portal.CPMPortalGraph_Single
CPM-Portal.CPMPortalGraph_Double
CPM-Portal.CPMPortalGraph_Triple
2. Select the parameters icon and complete the form according to the table below.
7-23
Field Description
ChartNameX Enter the name of the summary view
WorkPoolX Enter the class of the summary view
TimeoutX Enter the time in seconds that the chart should remain in the user’s browser cache.
3. Click OK to save the parameters, then Click Apply to apply the changes to the
section rule. Save your section or harness rule.
Note: For detailed information about the configuration and display of interactive charts in
reporting gadgets, see Application Developer Help and the PDN article, How to Use
Interactive Charts with Your Reports.
7-24
Configuring Quality Review and Customer Satisfaction
Surveys
This topic describes how to configure the content and scoring rules used to build
quality management reviews and customer satisfaction surveys.
Survey rules determine the scoring criteria and the questions asked in the survey.
2. Click Save As, select the Applies To class, and enter the name of the survey
as the Purpose. Save it to your RuleSet.
3. Enter a short description for the survey. This value becomes the name of the
survey.
7-25
4. On the Scoring Levels tab, enter a title name for each scoring level. The titles
display to the user when responding to the survey.
5. On the Questions tab, enter information into the fields described in the table
below. All fields are required.
Field Description
Category Enter the name of the category to be evaluated
Question Enter the text question that is displayed to the person responding to the
survey
Weight Enter the integer or decimal value that is used as a weighting factor when
calculating the survey score for this category
Level 1-5 Scores Enter the numeric score for each level that can be selected for the category
6. Click Save.
1. From the App Explorer, select PegaCA-Work > Decision > Map Value >
CAGetOverallRating.
7-26
3. On the Matrix tab update the table to include:
Total Score — enter this evaluation criteria as (<, <=, etc) and the total score
Overall Rating — enter the text you want to associated with the score
4. Click Save.
Example: You want your high-value customers to receive different satisfaction surveys
from those received by standard customers. Entry-level CSRs and experienced CSRs
could be evaluated using two different surveys.
1. From the App Explorer, select PegaCA-Work > Decision > Decision Tree.
7-27
4. On the Decision tab, enter the decision criteria and the name of the survey
you want to display.
5. Click Save.
1. In the Find gadget, type SatisfactionSurvey. Select the Intent Task instance.
Indicate whether you want to suggest the process or queue the process when the condition evaluates
to true
7-28
Enter the visual cue you want to associate with the condition from the image catalog that is displayed
when you click the Lookup icon
4. Click Save.
1. From the App Explorer, select PegaCA-Work >Property > Field Value > New.
2. Enter your work class in the AppliesTo field, InteractionGoal as the Field
Name and the interaction goal you added to the decision table as the Field
Value. Save it to your RuleSet.
4. Click Save.
7-29
6. On the Matrix tab, enter the target customer survey values for each
combination of reason for interaction and interaction goal. To add a new
interaction goal value, add a column. To add a new reason for interaction, add
a new row to the matrix.
7. Click Save.
8. For each new Reason for Interaction you wish to include in the customer
experience map control, update the CACustSurveyXML instance to include the
new reason.
9. In the Find gadget type CACustSurveyXML to display the XML for the customer
experience map quadrants.
11. In the XML tab, add the reason for interaction to the values list for the
quadrant category named “free”.
The HasAccountRole and HasBusinessUnitRole functions, both call the generic function
PartyHasRole, use the following input parameters:
String RoleListProp — the property page that contains a list of roles defined with the property
RoleType, such as .AccountRoles
String RoleType — the string being tested, such as 60 (Owner) or 220 (Counsel)
7-30
ClipboardPage PrimaryPage — the page of the work object, such as Primary
PublicAPI tools — the standard tools available in the Process Commander toolkit
The following examples show how you can use the HasAccountRole and
HasBusinessUnitRole functions to perform party verification.
In a Rule-Obj-When Rule
You can use the contact security functions as a Rule-Obj-When parameter, such as:
{when
{%pegaappca_contactsecurity.HasAccountRole("60",tools.
getPrimaryPage(),tools)%} }
<p>Contact is the owner.</p>
{/when}
7-31
2. Enter a Product Type and click Create.
4. Click Save.
To define a product:
1. From the Class Explorer, select PegaApp- > Product. Click New.
3. Enter a Short Description and optionally complete the Product Details and
History tabs described in the table below.
Field Description
Short Description Required. Short description of the product
Product Details Tab
Product Type Optional. Select the product type
Product Name Optional. The product name
Product Description Optional. The product description
Product Cost Optional. The product cost
Product List Price Optional. The product list price
History Tab Optional. Description of the product and its usage
4. Click Save.
7-32
Chapter 8: Setting Up Communications
This chapter describes the configuration requirements for CPM communication
functions.
Correspondence Templates
Correspondence Templates
CPM comes with both correspondence templates and fragments. CPM includes the
following templates that provide starting points from which you can build your own
correspondence rules.
8-1
Class Name / Type Label/Description
Correspondence Rule
PegaCA-Work-QualityReview
CAReviewSummary Email Quality review summary
PegaCA-Work-SatSurvey
SatisfactionSurvey Email Survey for customer
2. Enter the server name. It may be useful to create the server name as a
concatenation of the user account and mail server that you want to monitor.
8-2
4. Enter the Host (mail server) Name and the Port Number used to connect to
the server.
5. Select the Protocol and check the box to indicate if you want to Use SSL.
6. Enter the user ID and password for the account you are monitoring.
7. Click Save.
8. Create additional EmailServer instances for each account you want to monitor.
1. From the Class Explorer, select Data- > Admin- > Connect- > EmailListener.
2. Click New to create a new instance. Enter the name of the EmailServer
instance you created as the Server Name.
3. Enter a name that references the account being monitored as the Listener
Name.
8-3
5. Complete the fields on the Properties tab. See Online Developer Help for
information about field content and options.
6. You may use the standard EmailDefault service package shipped with CPM,
which specifies an Access Group that includes the appropriate rulesets to
function properly. If you choose to use a different service package, make sure
its access groups include CPM rulesets.
7. You should specify the default Service Method that ships with CPM called
AddWorkItemForEmail. This method will automatically create Inbound
Correspondence cases for inbound email.
8. Click Save.
8-4
Creating an Email Account
Create an email account to use for sending and receiving email.
To create email accounts access the Email landing page ( > Integration > Email)
The Email Landing Page has gadgets to create, edit, and view outbound and inbound
email settings. See the Application Developer Help.
Voice and Data Transfer can also appear as an option on the case Tools menu when a
CSR is on an active call.
For more information about these capabilities, see the PegaCALL™ for PegaRULES
Configuration and Operations Guide.
Customer Process Manager Implementation Guide
8-5
Configuring Call and Data Transfer
CPM provides a CSR with the ability to transfer a phone call and the related interaction
or service case. A sample set of data elements and parameters are available for you to
copy and update to meet your call transfer requirements.
Before you configure and test these features in CPM, PegaCALL must be installed,
configured, and on a switch/ACD that supports adding call data elements to a call upon
transfer.
8-6
Configuration tasks for call and data transfer are:
1. From the App Explorer, select PegaCA-CTI-Call > User Interface > Section >
AppTransferPopData.
4. Click Save.
8-7
Setting Call Transfer Timing Parameters
This parameter monitors the length of time a call can remain in the Transfer
workbasket between the time the call is transferred by an agent and the time it is
picked up by a receiving agent. The CPM default time is set to 15 minutes in an
activity rule.
1. From the App Explorer, select PegaCA-Work > Technical > Activity >
CACTIReassignToTransferor.
4. Click Save.
1. From the App Explorer, select PegaCA-CTI-Call > Data Model > Property>
TransferCallReason.
8-8
3. On the General tab, add or remove a value from the list of Table Values. Enter
the values as a text string.
4. Click Save.
For information about setting up this functionality, see the Technical Note Configuring
Chat with Expert included in the resource kit folder of your CPM distribution media.
8-9
Chapter 9: Integrating CPM
CPM interaction and service processes are designed to integrate with your information
systems to obtain, display, and update customer information Additionally, CPM can
launch PRPC-based application processes in other systems from the CPM Interaction
Driver as part of a customer interaction.
For detailed information about integrating your CPM system with other systems, see
Integration Knowledge category on the PDN and in Application Developer Help.
CPM comes with sample integration activities and flows that you can modify or use as
models for creating new integration activities. The following table lists the activities
you can copy to your RuleSets. After you save the activity to your RuleSet, you can
make changes to retrieve or update data. Appendix B references the integration
activities related to composite screen data.
9-1
Class Integration Activity
PegaApp-Interface-BusinessUnit AppGetIndustryType
PegaApp-Interface-BusinessUnit AppReadAccConList
PegaApp-Interface-BusinessUnit AppListBUsForContact
PegaApp-Interface-BusinessUnit AppListBUsForOwner
PegaApp-Interface-Contact AppGetAccountAndContact
PegaApp-Interface-Contact AppGetAddressDetailsByType
PegaApp-Interface-Contact AppGetAddressOptionsByType
PegaApp-Interface-Contact AppGetAddresstype
PegaApp-Interface-Contact AppGetCommOptionsByType
PegaApp-Interface-Contact AppGetCommunicationType
PegaApp-Interface-Contact AppGetContatcProfile
PegaApp-Interface-Contact AppGetMaterialInfo
PegaApp-Interface-Contact AppGetNonPrimAddress
PegaApp-Interface-Contact AppGetNonPrimCommOptionsForContact
PegaApp-Interface-Contact AppGetNotesForContact
PegaApp-Interface-Contact AppReadContactInfo
PegaApp-Interface-Contact AppReadContactList
PegaApp-Interface-Contact AppReadContatcListByAcc
PegaApp-Interface-Contact AppReadContactListSC
PegaApp-Interface-Contact AppListAddressForContact
PegaApp-Interface-Contact AppListContactsForAccount
PegaApp-Interface-Contact AppListContactsForBU
Fulfillment Classes
PegaCA-Work AppLoadAccountsList
PegaCA-Work AppReadContactInfo
PegaCA-Work CAInsertPCA_Representative
PegaCA-Work CALoadItemHistory
PegaCA-Work-AddressChange CALoadAccountsList
PegaCA-Work-Interaction CALoadItemHistory
PegaCA-Work-NewAccount CAGetProductAndAccountType
PegaCA-Work-Opportunity CAGetProductList
9-2
2. Save it to your RuleSet.
3. Modify the activity steps to set your parameters and mapping requirements.
5. Click Save.
The data structure for each table begins on the following pages. Using the interface
activities listed, map your data to the properties in the following tables.
Note: In Oracle, all table data and column headings appear in uppercase characters, but correct SQL is
in lowercase. CPM follows a universal approach and uses lowercase characters.
PA_ Tables
PA_ACCOUNT PA_COMMUNICATION_TYPES
PA_ACCOUNT_LINK PA_CONTACT
PA_ACCOUNT_TRANSACTION_TYPES PA_CONTACT_BUSINESSUNIT_LINK
PA_ADDRESS PA_CUSTOMER_TYPE
PA_ADDRESS_TYPE PA_INDUSTRY
PA_BUSINESSUNIT PA_NOTES
9-3
PA_BUSINESSUNIT_LINK PA_ROLES
PA_COMMUNICATION_OPTIONS
PCA_ Tables
PCA_LOCATION_CATEGORIES PCA_TERRITORY_LINK
PCA_LOCATION_CATEGORY_TYPE PCA_ZIP_DISTANCES
PCA_TERRITORY
PSVC_ Tables
PSVC_ACCOUNT PSVC_ACCOUNT_TRANSACTIONS
PSVC_ACCOUNT_STATEMENTS
PA_ACCOUNT
This table stores account-specific information. Replace calls to this table with calls to
your data tables.
ACCOUNTOPENDATE DATE 7 No
9-4
Name Datatype Size Scale Nulls?
COUNTRYCODE VARCHAR2 20 Yes
PA_ACCOUNT_LINK
This table maintains the relationship between a contact or business unit, an account
number, and the role that the contact or business unit has with the account. For
example, Rebecca Biggs is the owner of account 123450000 or Smith Publishing is the
co-owner of account 111110000.
PARTYID VARCHAR2 12 No
ACCOUNTNUMBER VARCHAR2 20 No
DATEADDED DATE 7 No
9-5
Name Datatype Size Scale Nulls?
ACTIVE VARCHAR2 5 Yes
PA_ACCOUNT_TRANSACTION_TYPES
This table provides the descriptions to the Transaction Type codes used in the
PA_ACCOUNT_TRANSACTION table. For example, code 200 is in the Transaction Type
table. To determine what code 200 means, CPM does a look up and finds that code
200 is Deposit.
PA_ADDRESS
This table stores address information about contacts and business units. Replace calls
to this table with calls to your data tables.
9-6
PA_ADDRESS_TYPE
This table stores the valid address types (for example, HOME or BILLING) used within
the system. Replace the sample entries in this table with address types valid for your
configuration.
PA_BUSINESSUNIT
This table stores information about business units. Replace calls to this table with calls
to your data tables.
9-7
Name Datatype Size Scale Nulls?
PRIORITYNOTE VARCHAR2 255 Yes
STATUS VARCHAR2 30 Yes
DATEFROM DATE 7 Yes
DATETO DATE 7 Yes
PRIMARYCONTACTID VARCHAR2 12 Yes
PA_BUSINESSUNIT_LINK
This table stores business-to-business relationships. For example, it shows that Acme
Technology is a subsidiary of Acme Software.
PA_COMMUNICATION_OPTIONS
This table stores communication information for contacts and business units. Replace
calls to this table with calls to your data tables.
9-8
Name Datatype Size Scale Nulls?
UPDATEDBY VARCHAR2 50 Yes
DATEDELETED DATE 7 Yes
DELETEDBY VARCHAR2 50 Yes
DATEFROM DATE 7 Yes
DATETO DATE 7 Yes
EMERGENCY VARCHAR2 1 Yes
PA_COMMUNICATION_TYPES
This table stores the valid communication types (for example, HOME-EMAIL or HOME-
PHONE) used within the system. Replace the sample entries in this table with
communication types valid for your configuration.
PA_CONTACT
This table is a sample table that stores information about contacts. Replace calls to
this table with calls to your data tables.
9-9
Name Datatype Size Scale Nulls?
ACTIVE VARCHAR2 5 Yes
WEBPRIVILEGES VARCHAR2 1 Yes
LOGINS NUMBER 10 0 No
BADLOGINS NUMBER 10 0 No
DATEOFLASTLOGIN DATE 7 Yes
NICKNAME VARCHAR2 26 Yes
BUSINESSAFFILIATION VARCHAR2 12 Yes
DATEADDED DATE 7 Yes
ADDEDBY VARCHAR2 50 Yes
DATEUPDATED DATE 7 Yes
UPDATEDBY VARCHAR2 50 Yes
DATEDELETED DATE 7 Yes
DELETEDBY VARCHAR2 50 Yes
GENDER VARCHAR2 1 Yes
SECURITYQUESTION VARCHAR2 100 Yes
SECURITYANSWER VARCHAR2 50 Yes
COMMUNICATIONPREFERENCE VARCHAR2 10 Yes
PRIORITYNOTE VARCHAR2 255 Yes
CUSTOMERVALUE VARCHAR2 30 Yes
BESTTIMETOCALL VARCHAR2 20 Yes
NOMARKETINGBYMAIL VARCHAR2 5 Yes
NOMARKETINGBYPHONE VARCHAR2 5 Yes
NOMARKETINGBYEMAIL VARCHAR2 5 Yes
COMPANY VARCHAR2 50 Yes
OCCUPATION VARCHAR2 50 Yes
DATEFROM DATE 7 Yes
DATETO DATE 7 Yes
9-10
PA_CONTACT_BUSINESSUNIT_LINK
This table stores contact-to-business relationships. For example, John Brown is
associated with Acme Software as an authorized party.
PA_CUSTOMER_TYPE
This table stores the information used to describe the business unit as a particular type
of customer. For example, the Customer Type selection box on the Add or Update
Business Unit details screen provides choices such as Fortune 500, Small Business,
and Partnership.
9-11
PA_INDUSTRY
This table stores information that describes the industry in which a business operates.
For example, the Industry selection box located on the Add or Update Business Unit
details screen includes choices such as Healthcare, Insurance, and Technology.
PA_NOTES
This table stores ad-hoc notes that added to contact or account records. The last
expandable section in the Account tab and the Contact tab on the Composite screen is
for notes. Users can view previously entered notes or add a new note in this section.
9-12
PA_ROLES
This table stores roles for account, contact, and business unit links. Some workflows
use the role type to determine processing steps. Add your own affiliations for account,
contact, and business unit associations.
PCA_LOCATION_CATEGORIES
This table stores location information. Replace the sample data with your location
information.
9-13
PCA_LOCATION_CATEGORY_TYPE
This table defines location categories. Modify this table to include your category
information.
PCA_TERRITORY
This table stores the association information about a territory and its representative,
product, and broker.
PCA_TERRITORY_LINK
This table associates each representative with a contact, account, or business unit. The
association is stored in the LINKTYPE.
9-14
PCA_ZIP_DISTANCES
This table stores the latitude and longitude for each Zip Code in the United States. This
table is to determine the distance from one location to another. For example, you
could use this table to find all branch offices within 50 miles of Zip Code 02142.
PSVC_ACCOUNT
This is an add-on table in the service layer to the PA_ACCOUNT table in Pega App
layer. PA_ACCOUNT and PSVC_ACCOUNT supplement each other to address service
layer accounts. Replace the sample data with your account information.
9-15
PSVC_ACCOUNT_STATEMENTS
This table stores account-specific information. Replace calls in this table with calls to
your data tables.
PSVC_ACCOUNT_TRANSACTIONS
This table stores account-specific information. Replace calls to this table with calls to
your data tables.
9-16
Sample SQL Calls for Database Integration
CPM comes with sample SQL calls for UDB, Oracle, and MSSQL packages. Replace
these SQL calls with your own interface methods to access your proprietary data.
To access the sample call instances that are instances of Rule-Connect-SQL, go to the
Rules by Type Explorer and select Rule- > Integration-Connectors > Connect-SQL.
Appendix A provides data-mapping information for the composite screens, which you
can use to change the labels or modify the displayed fields. The appendix includes lists
of labels, tag names, Rule-Connect-SQL instances, and Rule-Obj-Activity instances.
The Rule-Connect-SQLinformation identifies where CPM obtains the information that
appears on the composite screens.
For more information about connect rules see Application Developer Help and the PDN.
For more information on configuring external PRPC processes to work with CPM, see
the technical note Incorporating External PRPC Processes Into Your CPM Application in
the Resource Kit directory of your CPM installation media.
9-17
Appendix A: Composite Screen Data Mapping
This appendix provides the label, tag names, Rule-Connect-SQL, and Rule-Obj-Activity
instances for each of the sections on each of the composite screens. You can use this
information to change the labels on a composite screen or to display different information.
The Rule-Connect-SQL information identifies where Customer Process Manager obtains the
information that appears on the composite screens.
A-1
Account Composite Gadget
The Account Composite gadget displays information regarding the account you selected during search processing. This
information enables you to respond to customer inquiries on account balance, status, and transactions; research prior
interactions and service items; and document notes and comments.
A-2
Label Property Name Rule-Connect-SQL Rule-Obj-Activity
A-3
Phone HomePhone PegaCA-Interface-Account.AppGetAccountInfo PegaCA-Interface-Account.AppReadAccountInfo
SLA Override SLAName N/A: List of object instances within the system PegaCA-Interface-.CAGetSLAOverride
Starts StartDate N/A: List of object instances within the system PegaCA-Interface-.CAGetSLAOverride
Ends EndDate N/A: List of object instances within the system PegaCA-Interface-.CAGetSLAOverride
A-4
Recent Transactions and Statements Rule-HTML-Section: PegaCA-Interface-Account.CATxnsAndStatements
(colored arrow) ContactDisposition N/A: List of object instances within the system PegaCA-Work-
Interaction.CAInteractionsByAccountNumber
A-5
Date CreateDateTime N/A: List of object instances within the system PegaCA-Work-
Interaction.CAInteractionsByAccountNumber
Channel InteractionType N/A: List of object instances within the system PegaCA-Work-
Interaction.CAInteractionsByAccountNumber
(colored ball) OverallTimeLimit N/A: List of object instances within the system PegaCA-Work.CAServiceItemsByAccountNumber
Open Date pxCreateDateTime N/A: List of object instances within the system PegaCA-Work.CAServiceItemsByAccountNumber
Type pyLabel N/A: List of object instances within the system PegaCA-Work.CAServiceItemsByAccountNumber
Status pyStatusWork N/A: List of object instances within the system PegaCA-Work.CAServiceItemsByAccountNumber
Operator pxUpdateOpName N/A: List of object instances within the system PegaCA-Work.CAServiceItemsByAccountNumber
A-6
Date Opened pyCreateDateTime N/A: List of object instances within the system PegaCA-Work-
Interaction.CAGetOpportunityHistoryAccount
Next Action NextActionRequired N/A: List of object instances within the system PegaCA-Work-
Interaction.CAGetOpportunityHistoryAccount
Date NextActionDate N/A: List of object instances within the system PegaCA-Work-
Interaction.CAGetOpportunityHistoryAccount
Status pyStatusWork N/A: List of object instances within the system PegaCA-Work-
Interaction.CAGetOpportunityHistoryAccount
Product ProductID N/A: List of object instances within the system PegaCA-Work-
Interaction.CAGetOpportunityHistoryAccount
Description pyLabel N/A: List of object instances within the system PegaCA-Work-Interaction.CAGetOfferHistoryAccount
Type CampaignType N/A: List of object instances within the system PegaCA-Work-Interaction.CAGetOfferHistoryAccount
OfferDate DateOfOffer N/A: List of object instances within the system PegaCA-Work-Interaction.CAGetOfferHistoryAccount
Status OfferStatus N/A: List of object instances within the system PegaCA-Work-Interaction.CAGetOfferHistoryAccount
A-7
Role RoleDescription PegaApp-Interface-Contact.AppListContactsForAcct PegaApp-Interface-Contact.AppListContactsForAcct
A-8
Contact Composite Gadget
A-9
Label Property Name Rule-Connect-SQL Rule-Obj-Activity
A-10
Label Property Name Rule-Connect-SQL Rule-Obj-Activity
A-11
Label Property Name Rule-Connect-SQL Rule-Obj-Activity
(colored arrow) ContactDisposition N/A: List of object instances within the system PegaCA-Work-Interaction.CAInteractionsByContactID
Date CreateDateTime N/A: List of object instances within the system PegaCA-Work-Interaction.CAInteractionsByContactID
Channel InteractionType N/A: List of object instances within the system PegaCA-Work-Interaction.CAInteractionsByContactID
(colored ball) OverallTimeLimit N/A: List of object instances within the system PegaCA-Work.CAServiceItemsByContactID
Open Date pxCreateDateTime N/A: List of object instances within the system PegaCA-Work.CAServiceItemsByContactID
Type pyLabel N/A: List of object instances within the system PegaCA-Work.CAServiceItemsByContactID
Status pyStatusWork N/A: List of object instances within the system PegaCA-Work.CAServiceItemsByContactID
Operator pxUpdateOpName N/A: List of object instances within the system PegaCA-Work.CAServiceItemsByContactID
A-12
Label Property Name Rule-Connect-SQL Rule-Obj-Activity
Clipboard Page: pyWorkPage.pyWorkParty(Contact).CARepresentative – (Note: this section appears only when REPRESENTATIVEID is not blank)
Date Opened pxCreateDateTime N/A: List of object instances within the system PegaCA-Work-Interaction.CAGetOpportunityHistoryContact
Product ProductID N/A: List of object instances within the system PegaCA-Work-Interaction.CAGetOpportunityHistoryContact
Status pyStatusWork N/A: List of object instances within the system PegaCA-Work-Interaction.CAGetOpportunityHistoryContact
Next Action NextActionRequired N/A: List of object instances within the system PegaCA-Work-Interaction.CAGetOpportunityHistoryContact
Date NextActionDate N/A: List of object instances within the system PegaCA-Work-Interaction.CAGetOpportunityHistoryContact
Offer Date DateOfOffer N/A: List of object instances within the system PegaCA-Work-Interaction.CAGetOfferHistoryContact
A-13
Label Property Name Rule-Connect-SQL Rule-Obj-Activity
Description pyLabel N/A: List of object instances within the system PegaCA-Work-Interaction.CAGetOfferHistoryContact
Type CampaignType N/A: List of object instances within the system PegaCA-Work-Interaction.CAGetOfferHistoryContact
Status OfferStatus N/A: List of object instances within the system PegaCA-Work-Interaction.CAGetOfferHistoryContact
A-14
Label Property Name Rule-Connect-SQL Rule-Obj-Activity
A-15
Account Owner Composite Gadget
The Account Owner Composite gadget displays information pertaining to the owner of the account. The sections within this
gadget vary depending on whether the caller is the owner of the account that is selected during search processing or whether
another individual is the owner.
A-16
Label Property Name Rule-Connect-SQL Rule-Obj-Activity
A-17
Label Property Name Rule-Connect-SQL Rule-Obj-Activity
.AppListCommOptionsForOwner
Service Level Profile Rule-HTML- (when Contact = Owner, this is the only section displayed)
Section: PegaCA-Party-
AccountOwner.CASvcLevelProfile
Clipboard Page: pyWorkPage.pyWorkParty(AccountOwner) – (Note: When Contact=Owner, this is the only section that appears)
A-18
Label Property Name Rule-Connect-SQL Rule-Obj-Activity
Clipboard Page: pyWorkPage.pyWorkParty(Contact).CARepresentative – (Note: this section appears only when WHEN REPRESENTATIVEID is not blank)
A-19
Label Property Name Rule-Connect-SQL Rule-Obj-Activity
Date Opened pxCreateDateTime N/A: List of object instances within the system PegaCA-Work-
Interaction.CAGetOpportunityHistoryAccountO
wner
Product ProductID N/A: List of object instances within the system PegaCA-Work-
Interaction.CAGetOpportunityHistoryAccountO
wner
Status pyStatusWork N/A: List of object instances within the system PegaCA-Work-
Interaction.CAGetOpportunityHistoryAccountO
wner
Next Action NextActionRequired N/A: List of object instances within the system PegaCA-Work-
Interaction.CAGetOpportunityHistoryAccountO
wner
Date NextActionDate N/A: List of object instances within the system PegaCA-Work-
Interaction.CAGetOpportunityHistoryAccountO
wner
A-20
Label Property Name Rule-Connect-SQL Rule-Obj-Activity
Offer Date DateOfOffer N/A: List of object instances within the system PegaCA-Work-
Interaction.CAGetOfferHistoryAccountOwner
Description pyLabel N/A: List of object instances within the system PegaCA-Work-
Interaction.CAGetOfferHistoryAccountOwner
Type CampaignType N/A: List of object instances within the system PegaCA-Work-
Interaction.CAGetOfferHistoryAccountOwner
Status OfferStatus N/A: List of object instances within the system PegaCA-Work-
Interaction.CAGetOfferHistoryAccountOwner
A-21
Label Property Name Rule-Connect-SQL Rule-Obj-Activity
ner
A-22
Business Unit Composite Gadget
The Business Unit Composite gadget appears only if a business unit is selected during search processing, or if a business unit is
the owner of the account selected during search processing.
A-23
Label Property Name Rule-Connect-SQL Rule-Obj-Activity
A-24
Label Property Name Rule-Connect-SQL Rule-Obj-Activity
SLA Override SLAName N/A: List of object instances within the system PegaCA-Interface-.CAGetSLAOverride
Starts StartDate N/A: List of object instances within the system PegaCA-Interface-.CAGetSLAOverride
Ends EndDate N/A: List of object instances within the system PegaCA-Interface-.CAGetSLAOverride
(colored arrow) ContactDisposition N/A: List of object instances within the system PegaCA-Work-Interaction.CAInteractionsByBusinessUnit
A-25
Label Property Name Rule-Connect-SQL Rule-Obj-Activity
Date CreateDateTime N/A: List of object instances within the system PegaCA-Work-Interaction.CAInteractionsByBusinessUnit
Channel InteractionType N/A: List of object instances within the system PegaCA-Work-Interaction.CAInteractionsByBusinessUnit
(colored ball) OverallTimeLimit N/A: List of object instances within the system PegaCA-Work.CAServiceItemsByBusinessUnit
Open Date pxCreateDateTime N/A: List of object instances within the system PegaCA-Work.CAServiceItemsByBusinessUnit
Type pyLabel N/A: List of object instances within the system PegaCA-Work.CAServiceItemsByBusinessUnit
Status pyStatusWork N/A: List of object instances within the system PegaCA-Work.CAServiceItemsByBusinessUnit
Operator pxUpdateOpName N/A: List of object instances within the system PegaCA-Work.CAServiceItemsByBusinessUnit
Date Opened pxCreateDateTime N/A: List of object instances within the system PegaCA-Work-
Interaction.CAGetOpportunityHistoryAccountOwner
Product ProductId N/A: List of object instances within the system PegaCA-Work-
Interaction.CAGetOpportunityHistoryAccountOwner
Description ProductDescription N/A: List of object instances within the system PegaCA-Work-
Interaction.CAGetOpportunityHistoryAccountOwner
A-26
Label Property Name Rule-Connect-SQL Rule-Obj-Activity
Status pyStatusWork N/A: List of object instances within the system PegaCA-Work-
Interaction.CAGetOpportunityHistoryAccountOwner
Next Action NextActionRequired N/A: List of object instances within the system PegaCA-Work-
Interaction.CAGetOpportunityHistoryAccountOwner
Date NextActionDate N/A: List of object instances within the system PegaCA-Work-
Interaction.CAGetOpportunityHistoryAccountOwner
Offer Date DateOfOffer N/A: List of object instances within the system PegaCA-Work-Interaction.CAGetOfferHistoryBusinessUnit
Description pyLabel N/A: List of object instances within the system PegaCA-Work-Interaction.CAGetOfferHistoryBusinessUnit
Type CampaignType N/A: List of object instances within the system PegaCA-Work-Interaction.CAGetOfferHistoryBusinessUnit
Status OfferStatus N/A: List of object instances within the system PegaCA-Work-Interaction.CAGetOfferHistoryBusinessUnit
A-27
Label Property Name Rule-Connect-SQL Rule-Obj-Activity
A-28
Label Property Name Rule-Connect-SQL Rule-Obj-Activity
A-29
Appendix B: UI Component Styles
This appendix provides descriptions of various UI elements and how they are styled.
This Appendix is useful for developers whose functionality rests on top of the basic
CPM and possibly on top of additional framework layers.
Note: There is one customer override extension, that isn’t layered like CSS if more than one
overrides it.
When Rules
Drop-down Lists
Sections
Templates
Activities
Version Numbers
When Rules
In order for Framework extensions to display in the Branding Wizard, the When rule
CPMCustomerBranding must be overridden and set to “true”.
Drop-down Lists
Currently the CPM extensions to the Branding Wizard support two levels of categorization:
Category — predetermined (CPM, Frameworks, Customer)
Elements — used to add additional branding questions for custom styles not found in lower layers.
B-1
Category
The category is set to CPM Frameworks and should change to your corresponding
framework (i.e. Healthcare, Card, etc.) The category is found in the first step of the activity
CPMCustomerBrandingCategoryStyleExtension.
Elements
The Elements are created in the CPMCustomerBrandingElementStyleExtension activity.
Each entry is created by calling the CPMBrandingAppendResultsToTree activity.
Parameters are:
TreePage — should remain param.ElementPage.
sName — the text visible in the drop down for this entry.
B-2
Sections
Sections are created for the Branding Wizard to display the necessary questions to brand
your custom style. The sections should be created in the class Rule-PortalSkin. There needs
to be a section for each element you add to the Elements dropdown.
It is recommend that you reuse existing sections that live in Embed-Skin-* classes first
before creating your own. These sections should be placed inside your section.
Your section must be named with the sValue of the Category and Element combined. In
this example, your section would be named CPMCustomerHeaderArea.
Includes
Include your sections in the CPMCustomerBrandingCustomSections section.
You can do a straight include
Templates
Once you have added your sections, the properties contained on these sections will
appear on the clipboard (see activities, css conversion), which can be stream
processed by the Branding Wizard to create the final style sheet. The CPM extensions
allow you to add your custom styles to the main style sheets (as opposed to additional
style sheets per harness.) These styles will be seen by all harnesses in your
application.
Additional extensions
Branding
Styles where the Branding Wizard is querying the end user should be placed in the
extension HTML file CPMCustomerBrandingExtension.
For example:
#cpminteractiontabs li td.cpmInteractionTabMainLabelStyle {
<pega:reference name=".CSSInteractionTabs.pyCollapsed.pyFont.pyFamily"
mode="literal" />
font-size: <pega:reference name=".CSSInteractionTabs.pyCollapsed.pyFont.pySize"
mode="literal" />;
font-weight: <pega:reference
name=".CSSInteractionTabs.pyCollapsed.pyFont.pyWeight" mode="literal" />;
text-align: left;
color: <pega:reference name=".CSSInteractionTabs.pyCollapsed.pyFont.pyColor"
mode="literal" />;
B-3
padding-left: 5px;
}
Additional
Additional styles that you want in the main style sheet, but no (or limited) branding
questions are asked, should be placed in the extension HTML file
CPMCustomerAdditionalExtension. This file is also stream processed and styles that are
mostly hardcoded but might want to utilize a generic overall branding style (like font
family, which is asked in the general area, or styles generated by “quick create”.) should
go here.
Activities
Apply Models
CPMCustomerApplyExtensionModels is used for activities that are called to extend the
functionality of the Branding Wizard (set properties, apply models, etc.).
CPMCustomerApplyExtensionModels is where you:
Create a clipboard page for your properties that will be used by your sections.
Apply a model for your properties (there are generic models for commonly used properties).
CSS Conversion
CSS Conversion activities take your data entered into the Branding Wizard via your new
sections and convert it to properties on the clipboard for stream processing. The extension
activity CPMCustomerBrandingConvertCSSExtension is used for CSS conversion.
Note: Data can be copied or converted (translating colors, fonts, etc, to match CSS).
Version Numbers
When you add new extensions to the Branding Wizard you need increase the Branding
Wizard version. The Branding Wizard checks for the version of the data model to
ensure that older skins work, even though the data model might have changed.
B-4