Preparing the PeopleSoft Real-Time Advisor Environment

This chapter provides an overview of the PeopleSoft Real-Time Advisor environment preparation and discusses how to:

Build the PeopleSoft Real-Time Advisor environment.
Enable a daemon group in PeopleSoft Process Scheduler.

Note. The purpose of this final step, which occurs outside of the PeopleSoft Customer Relationship Management (PeopleSoft CRM) Set Up navigation component, is to accelerate the performance of the recommendation engine. This step must be done to enable the daemon process to ensure accurate and up-to-date recommendations for deployed dialogs.

Understanding PeopleSoft Real-Time Advisor Environment Preparation

PeopleSoft delivers statuses, steps, actions, and several predefined types to enable PeopleSoft Real-Time Advisor automatically. To take full advantage of the PeopleSoft Real-Time Advisor, you should review all business processes and determine if there are any additional advisor types or characteristics that are appropriate for the recommendation scenarios and dataset.

There are two parts to preparing PeopleSoft Real-Time Advisor for later use by a dialog creator who will create the actual recommendation experience from the Advisor Workbench tool:

Define the PeopleSoft Real-Time Advisor environment parameters to make dialog building blocks available for the dialog creator.

Environment preparation also ensures that the dialog creator operates under the proper constraints. This preparation includes defining actions, steps, statuses, types, and mapping characteristics.
Create and start the PeopleSoft Process Scheduler on the application server.

Create a daemon and add it to the application server that is running PeopleSoft Real-Time Advisor. This ensures that data is managed effectively and is up-to-date for deployed dialog versions.

See Also

Enterprise PeopleTools 8.45 PeopleBook: PeopleSoft Process Scheduler

Building the PeopleSoft Real-Time Advisor Environment

This section discusses how to:

Define actions.
Define statuses.
Define steps.
Define type.
Define characteristic mapping.
Test characteristic mapping.

Pages Used to Build the PeopleSoft Real-Time Advisor Environment

Page Name	Object Name	Navigation	Usage
Define Actions	RAD_ACTIONS	Set Up CRM, Product Related, Advisor, Define Actions	Define all available actions. Action buttons control what an end user can do within dialogs.
Define Statuses	RAD_STATUS	Set Up CRM, Product Related, Advisor, Define Statuses	Define all available statuses. Statuses indicate allowable stages for dialog creation.
Define Steps	RAD_STEPS	Set Up CRM, Product Related, Advisor, Define Steps	Define the steps necessary for a dialog to be created.
Define Type	RAD_ADVISOR_TYP	Set Up CRM, Product Related, Advisor, Define Type	Define the type of dialog to be created. It controls the use and functionality of a dialog.
Define Characteristic Mapping	RAD_CHARACTER_MAP	Set Up CRM, Product Related, Advisor, Define Characteristic Mapping	Define Mappings in order to retrieve data used by the PeopleSoft Real-Time Advisor recommendation.
Test Characteristic Mapping	RAD_REC_ENT_TEST	Set Up CRM, Product Related, Advisor, Define Characteristic Mapping. Click the Test Characteristic Mapping link, select either Stored Location or Value Location from the available options, and click the Test button.	Test the characteristic mapping of the currently opened definition.

Defining Actions

Access the Define Actions page.

Actions control the flow of a dialog. They are associated with a given page and are available to the user to make a decision.

Action Definitions

Action	Create the actions to be made available for selection from the Advisor Workbench tool. The dialog creator can select which actions appear on a page based on the defined actions. Actions ultimately appear as buttons on the runtime pages. PeopleSoft delivers these actions: Next, Recommend, Save, Start Over, Exit, Answers, and Back. There is a 30-character limit.
Sequence	Controls the order of the buttons at runtime. Specify the sequence numerically with the lowest number appearing on the left side of the Real-Time Advisor runtime page.
Label	The name that appears on the action button at runtime. In most cases the action name is the same as the label. There is a 75-character limit.
Description	Enter a description of the action. There is a 254-character limit.
Action Type	Describes what the PeopleSoft Real-Time Advisor does when you click the action button. The values are: Answers: Takes the user to the View Answers page. Back: Takes the user to the previous page. Exit: Quits the dialog and returns the user to his or her location prior to calling PeopleSoft Real-Time Advisor. Next: Takes the user to the next page in the dialog, based on the transitions for the page. Recommendation: Provides a list of recommendations based upon answers to previous questions and conditions. Save: Prompts the user for a save name and saves the dialog session in its current state. Start Over: Clears all of the existing answers and restarts the dialog.

Defining Statuses

Access the Define Statuses page.

Status indicates the stage of development for the dialog. User-defined statuses enable flexibility.

Status Definitions

Description

Appears on the Advisor Workbench page describing the state of the dialog. There is a 30-character limit.

Status Type

Determines the state of the dialog version.

Values are:

Archived: Dialog is not currently active.

No version of the dialog is available to be run. This status is for all versions of the dialog.
Deployed: Dialog version can be run by a calling application.
In Progress: Dialog version is being created or modified.

It is not currently available for calling applications, because it has yet to be validated and deployed.
Past Deployed: Dialog version was deployed, but a new version has taken its place.

This version is available only if a saved session requests the version, otherwise the version of the dialog that is deployed will be run.
Validated: Dialog version has been validated and is ready to be tested or deployed.

Note. If a dialog is deployed, then the deployed version is available to calling applications. If the dialog is edited subsequent to deployment, a new version is created and used by the Advisor Workbench tool. The deployed version is still available for use by a calling application and is not changed.

If the edited version or the version in progress is subsequently deployed, then that version automatically becomes the deployed version. Any in progress versions are not available to calling applications until they are validated and deployed.

If the status of the dialog is set to Archived, then all versions of the dialog are inactive and no longer available to run.

Defining Steps

Access the Define Steps page.

Advisor types can have different dialog creation steps.

Step Definitions

Description

Enter the name of the step. There is a 30-character limit.

Step Explanation

Enter the description of the step. This description appears to the dialog creator in the Advisor Workbench tool. There is a 75-character limit.

Step Type

Select what the Advisor Workbench tool does when the step is activated.

Values are:

Define Target Groups: Define the target groups to be used in the weighting model.
Page Management: Layout dialog pages and the transitions between them.
Select Characteristics: Select the object characteristics to include in the weighting model.
Select Conditions: Select external conditions to influence target groups and transitions.
Select Questions: Select the questions to include in the dialog here.

Select them from an existing question library or create them from scratch.
Test Dialog: Preview how the dialog will appear to customers.
Validate Dialog: Check the dialog for errors. This validation must be done before testing or deploying the dialog.

This step automatically saves before validation.
Weighting Model: Create the recommendation model that targets specific customers more precisely with recommendations.

Defining Type

Access the Define Type page.

The Define Type page enables you to determine which dialog can be created. You define the recommended object and the steps to use in the dialog. You can use any record in the database as the base recommendation table.

Note. In the data provided, PeopleSoft delivers the Product Advisor type to recommend products. However, an implementer can choose to recommend any object in the database.

Type Details

Advisor Type Name	Enter the name of the advisor type. This name is available from the drop-down list box in the Advisor Workbench tool. There is a 50-character limit. Advisor type is important because it determines what object a dialog recommends and what kind of dialog you are creating. PeopleSoft delivers an advisor type of Product Advisor as system data. This type would be used to recommend products from the PeopleSoft CRM Product Data Model.
Status	Select Active or Inactive for the dialog type.
Description	Select a description of Type for reference purposes. There is a 254-character limit.
Base Record	Enter the record that contains the information for the recommended object. The system accesses this record to return recommendations.

Cache Options

Cache functionality enhances the performance of the PeopleSoft Real-Time Advisor recommendation engine by performing calculations and recommendations only as necessary. After the dialogs are created, the environment creator must perform additional setup from within PeopleSoft Process Scheduler. The steps are outlined in the final section of this chapter.

Dialog Refresh (Minutes)

Enter how often the cache refreshes for this dialog type.

Number to Cache

Enter the number of objects to be cached for each target group, which by default is 500. This means that if there are 10 target groups for a dialog, 50,000 objects will be cached. This represents the top 500 for each target group.

Cache Record

The PeopleSoft Real-Time Advisor recommendation engine uses this table to store the recommendations. PeopleSoft provides RAD_PRDCACHE as the cache record for the Product Advisor advisor type that is shipped as system data.

Create the advisor type to recommend objects other than products, by using a base record other than PROD_ITEM. You will need to create a new cache record in the database.

It must contain these subrecords:

Use the subrecord RAD_GENKEY_SBR, provided by PeopleSoft, as is.
Use a subrecord that contains the keys for the recommended objects.
Use the existing field RAD_SCORE.

Use the new record in the Cache Record field.

Base Record Key Fields

Field Name

Select the unique keys to extract from the base record. These keys uniquely identify the recommendable object.

Sequence

Enter the order in which the fields are returned.

Note. The field values are SETID and PRODUCT_ID for the advisor type, Product Advisor, which uses the PROD_ITEM as its base record. These are the keys that identify products in the CRM Product Data Model.

Advisor Steps

Enables you to select the steps that you want to appear and the order in which you want them to appear.

Description	Displays an explanation of the different steps in the type.
Sequence	Enter the order of the steps in the type.
Step Usage	Select Hidden when the step does not appear. Select Shown when the step appears but is optional. Select Required when the step both appears and is required.

Note. Advisor types for dialogs that are only used to collect data must contain these steps (required): Select Questions, Page Management, Validate Dialog, and Test Dialog.

Advisor types for dialogs that are going to be used to collect data and also provide recommendations should contain these steps: Select Questions, Page Management, Define Target Groups, Select Characteristics, Weighting Model, Validate Dialog, and Test Dialog. Include the Select Conditions step if you want conditions to influence the recommendations or page flow.

Advisor types for dialogs that are going to just recommend without asking questions should contain these steps: Select Conditions, Define Target Groups, Select Characteristics, Weighting Model, Validate Dialog, and Test Dialog.

Advisor Status

Description	Displays statuses that are defined in the status definition and enables the user to select the statuses to use for the advisor type.
Show	Select this check box to show the dialog creator which statuses to use in the Advisor Workbench tool.

Note. Include a status of every status type when defining the advisor type. The different statuses are required so the Advisor Workbench tool can accurately determine the state of the dialog.

Detail Information

When an end user drills into a recommendation, PeopleSoft Real-Time Advisor must know the type of information to present to the end user and how to present it. The PeopleSoft PeopleCode that the system launches when the user drills is determined here.

Application Class ID	Enter the application class that PeopleSoft Real-Time Advisor launches at runtime when the user requests more information regarding a recommended object. The class ID should be Drill, in the advisor type, Product Advisor. The advisor type, Product Advisor, uses the Product Catalog Details page to display details of the recommended object. If the advisor type is going to recommend objects other than products, use the RAD_PRODUCT drill class as an example to create the integration.
Application Class Path	Enter the application package that stores the application class. The class path should be RAD_PRODUCT in the advisor type of Product Advisor.
Package Tree Viewer	Click this link to find a specific method for a given path and application class.

Defining Characteristic Mapping

Access the Define Characteristic Mapping page.

Characteristics are needed to create dialogs to recommend objects. A characteristic is basically an aspect of the recommended object, like an attribute or a property. Characteristic mapping shields the dialog creator from the technical workings of PeopleSoft Real-Time Advisor and the underlying data model of the recommended objects.

Note. Use characteristic mappings to retrieve information from any PeopleSoft record. This flexibility enables PeopleSoft Real-Time Advisor to expand with the data model.

Characteristic Details

Description	Appears to the creator of dialogs in the Advisor Workbench tool. There is a 30-character limit.
Status	Select either Active or Inactive.
Advisor Type	This determines the advisor type that is to use this characteristic.
External Label	Appears in the PeopleSoft Real-Time Advisor runtime when the recommended object appears to the user in a recommendation.
Test Characteristic Mapping	Click this link to test that the mapping is valid. It is a good idea to test mappings to ensure they encompass the desired objects and values. Otherwise, when making a recommendation model, the model will not have access to the desired recommendable objects. Click the Test Characteristic Mapping link to return the objects or values matching the mappings.

Characteristic Types

Describes where the characteristic should be used in the PeopleSoft Real-Time Advisor dialog.

Display	Select this check box to associate the characteristic to a display template. It is used at runtime to show information about a given object.
Recommendation	Select this check box to use the characteristic in a recommendation model. The dialog creator in Advisor Workbench tool can use the characteristic in a weighting model.
Description	Enter a description for the characteristic. There is a 100-character limit.

Characteristic Stored Location

The recommendation engine uses this location to come up with valid objects to recommend based on the Source Record, Field Name, and Where Clause fields.

Source Record

Enter the record from which PeopleSoft Real-Time Advisor retrieves valid objects. If you are using the PeopleSoft CRM product data model, you may want to use PROD_ITEM.

Field Name

Select the field for the characteristic. Fields come from the source record.

Where Clause

Select a formatted logic clause to restrict the objects used to recommend products, services, or solutions.

Where clauses enable the use of Boolean logic to limit what the dialog creator can select. Save logic assures that the where clause is properly formatted and values correspond to the field data types. Violations are then identified and appear on the page.

Note. If a table is set-controlled and this restriction is desired, a characteristic must resolve this restriction in the where clause.

Characteristic Value Location

The Advisor Workbench tool uses this information in the recommendation model. Objects that match the value are included in the recommendation object pool and are available to be recommended.

Value Type	Select the type of the characteristic, a value type of either Numeric or Mapped Value. With a numeric type, the dialog creator can select a range of allowable numbers. With a mapped answer type, a list that contains values appears.
Source Record	Contains valid answers for the Stored Record field.
Description Field	Select the valid field that stores values for the dialog creator to view (as opposed to what you enter in the Value Field, which is used in the actual evaluation of the recommendation). The dialog creator views this information as a list.
Value Field	This information is stored and used for the recommendation. Unlike the Description Field, the dialog creator cannot view values in this field. It is used in the actual evaluation of the recommendation when comparing the characteristic value against the recommendable objects. Note. In most cases, the Value Field is exactly the same as the Description Field.
Value Where Clause	Define a formatted logic clause to limit the answers that appear to the dialog creator. Where clauses enable the use of Boolean logic to limit what the dialog creator can select. Save logic assures that the where clause is properly formatted and that values correspond to the field data types. Violations are then identified and appear on the page. Note. If a table is set-controlled and this restriction is desired, a characteristic must resolve this restriction in the where clause.

Example: Mapping Attributes

This is an example Characteristic Mapping to create a recommendation characteristic that uses product attributes.

Note. Create a SQL view in Enterprise PeopleTools Application Designer before using attributes in characteristics. These views have already been created for products in the CRM Product Data Model. Use the PROD_ATTR_D_VW view to map product attributes that do not have predefined answers, (such as numeric or character) and use the RB_PRDATTMAP_VW view to map product attributes that do have predefined or mapped answers. Either these views or the views that you've created can access the attribute base records and the record that contains the attributes attached to the recommended object.

To create mapping for mapped attributes:

Enter RB_PRDATTMAP_VW as the source record in the Characteristic Stored Location group box.
Select ATTR_ITEM_ID as the field name.
Select ATTRIBUTE_ID as the field name in the Where Clause group box.
Select = as the operator.
Enter the name of the attribute ID in the Character Value field.
Select Mapped Value in the Characteristic Value Location group box.
Enter RB_PRDATTMAP_VW as the source record.
Select ATTR_ITEM_Value as the value in the Description Field.
Select ATTR_ITEM_ID as the value in the Value Field.
Select ATTRIBUTE_ID as the field name in the Where Clause group box.
Select = as the operator.
Enter the name of the attribute ID in the Character Value field.

To create mapping for non-mapped attributes:

Enter PROD_ATTR_D_VW as the source record in the Characteristic Stored Location group box.
Select the appropriate field name for the attribute type that you are mapping.

Values are:
- If the attribute type is Numeric, select ATTR_NUMBER.
- If the attribute type is Numeric, select ATTR_NUMBER.
- If the attribute type is Character, select ATTRIBUTE_VALUE.
- If the attribute type is Date, select ATTR_DATE.
Select ATTRIBUTE_ID as the field name in the Where Clause group box.
Select = as the operator.
Enter the name of the attribute ID in the Character Value field.
Select Mapped Value for date and character attributes in the Characteristic Value Location group box.

Select Numeric for numeric attributes.

Note. If you select Numeric here, then mapping is complete. Otherwise, continue with these final steps.
Enter PROD_ATTR_D_VW as the source record.
Matching the previous selection, select either ATTR_NUMBER, ATTRIBUTE_VALUE, or ATTR_DATE as the Description Field and as the Value Field.
Select ATTRIBUTE_ID as the field name in the Where Clause group box.
Select = as the operator.
Select the name of the attribute ID in the Character Value field.

Testing Characteristic Mapping

Access the Test Characteristic Mapping page.

Select either Stored Location or Value Location, and click the Test button to test the characteristic mappings. The test of the characteristic mapping only tests the most recently saved definition.

Characteristic Test Options

*Test	Select either Stored Location or Value Location. Selecting the Stored Location option will return the objects that match the mapping defined in the characteristic stored location. Selecting the Value Location option will return the values that match the mapping defined in the characteristic value location.
Test	Click this button to test the characteristic mapping.
Number Of Test Results	Limits the number of test results returned.

Note. If the characteristic is marked as having a value type of numeric, no values will be returned if the Value Location option is selected in the Test field.

Enabling a Daemon Group in PeopleSoft Process Scheduler

This section provides an overview of the daemon, and discusses how to:

Define a daemon group in PeopleSoft Process Scheduler.
Activate the daemon group on the application server.
Run PeopleSoft Process Scheduler.

Understanding the Daemon

The PeopleSoft Real-Time Advisor recommendation engine uses a cache to precompute recommendations for deployed dialogs. The cache ensures dialogs are run as efficiently as possible for the end user. Dialogs that have yet to be deployed take longer to run, because the recommendation engine uses a series of searches to find the objects to recommend as opposed to reading directly from a cache. Deployed dialogs only look in the cache for recommendations. Therefore, if the dialog versions are deployed, you must run the daemon to ensure recommendations are available and refreshed.

The daemon enables the recommendation engine to fill and refresh its cache, as determined by the configuration settings and the advisor type. When deciding the configuration settings for the daemon, you must understand the dynamics of the recommended object set. In a deployed environment, the cache needs to be refreshed as the object set changes. For example, suppose that you recommend products from a catalog and you have products that are no longer in the catalog, you don't want the recommendation engine to recommend against those products. If you have a highly dynamic set of recommended objects, you must refresh the cache frequently to ensure efficient operation of the engine. If the set of objects is fairly static, the cache refresh does not need to be as frequent.

Note. The daemon and process scheduler does not need to be activated for Real-Time Advisor until there are deployed dialogs.

Pages Used to Enable a Daemon Group in PeopleSoft Process Scheduler

Page Name	Object Name	Navigation	Usage
Daemon Group	DAEMONGROUP	PeopleTools, Process Scheduler, Daemon Group	Define a daemon group in PeopleSoft Process Scheduler.
Server Daemon Details	SERVERDAEMON	PeopleTools, Process Scheduler, Servers, Daemon Definition	Activate the daemon group on the application server. Note. PeopleSoft Process Scheduler may be running on multiple servers. Select a server from the Servers search page and access the Daemon page for the selected server.

Page Name

Object Name

Navigation

Usage

Daemon Group

DAEMONGROUP

PeopleTools, Process Scheduler, Daemon Group

Define a daemon group in PeopleSoft Process Scheduler.

Server Daemon Details

SERVERDAEMON

PeopleTools, Process Scheduler, Servers, Daemon Definition

Activate the daemon group on the application server.

Note. PeopleSoft Process Scheduler may be running on multiple servers. Select a server from the Servers search page and access the Daemon page for the selected server.

Defining a Daemon Group in PeopleSoft Process Scheduler

Access the Daemon Group page.

Daemon Group

Displays the BOBASICS daemon group, which is the default selection. You will not see the PeopleSoft Real-Time Advisor selection in this list until you add a row and a lookup program name. Select RAD_CACHE_DMN as the program name.

Note. Click Load All Programs to retrieve the RAD_CACHE_DMN group.

Load All Programs

Click to load the remaining daemon programs, which will include the daemon RAD_CACHE_DMN.

Note. Click Lookup Program Name to retrieve the RAD_CACHE_DMN group.

Program Name

Enter the name of the daemon program. In this case, look for the RAD_CACHE_DMN daemon group, which is packaged with PeopleSoft Real-Time Advisor but is not selected. Click the Lookup button to verify that the description is Cache Computing AE Daemon.

Activating the Daemon Group on the Application Server

Access the Server Daemon Details page.

Daemon Enabled

Select this check box. A daemon process is an application engine process that runs continuously when PeopleSoft Process Scheduler is operational. It triggers other application engine processes based on the entered daemon group.

Daemon Group

Ensure that BOBASICS appears as the default value. BOBASICS now includes the daemon group because of the previous step.

Daemon Sleep Time

Enter a sleep time to control the activity of the process. The daemon is a process that runs in the background, but it should not run continuously. A sleep time is the number of minutes for which the daemon process sleeps or waits before it checks for work. When it wakes, it checks for processes that have been and need to be run on this process server.

Note. The sleep time should be less than any dialog refresh (minutes) as defined in the advisor types.

Recycle Count

A cycle is the sequence of sleeping and working. The system automatically counts the number of times that it sleeps and works. When it reaches the recycle count value, the daemon process reboots itself.

Note. For processing errors and cache computation exceptions, check the PeopleSoft Real-Time Advisor log tables.

See Also

Enterprise PeopleTools 8.45 PeopleBook: PeopleSoft Process Scheduler

Running PeopleSoft Process Scheduler

Create and start a process scheduler server.

You must create and start a process schedule to finish enabling the daemon. Running PeopleSoft Process Scheduler activates the daemon, which periodically updates the PeopleSoft Real-Time Advisor cache.

See Also

Enterprise PeopleTools 8.45 PeopleBook: PeopleSoft Process Scheduler

Daemon Enabled	Select this check box. A daemon process is an application engine process that runs continuously when PeopleSoft Process Scheduler is operational. It triggers other application engine processes based on the entered daemon group.
Daemon Group	Ensure that BOBASICS appears as the default value. BOBASICS now includes the daemon group because of the previous step.
Daemon Sleep Time	Enter a sleep time to control the activity of the process. The daemon is a process that runs in the background, but it should not run continuously. A sleep time is the number of minutes for which the daemon process sleeps or waits before it checks for work. When it wakes, it checks for processes that have been and need to be run on this process server. Note. The sleep time should be less than any dialog refresh (minutes) as defined in the advisor types.
Recycle Count	A cycle is the sequence of sleeping and working. The system automatically counts the number of times that it sleeps and works. When it reaches the recycle count value, the daemon process reboots itself.