Oracle Fusion Middleware Online Documentation Library
Oracle® Fusion Middleware
Platform Developer's Guide for Oracle Real-Time Decisions
11g Release 1 (11.1.1)
E16630-03
April 2011
Oracle Fusion Middleware Platform Developer's Guide for Oracle Real-Time Decisions 11g Release 1 (11.1.1)
E16630-03
Copyright © 2010, 2011, Oracle and/or its affiliates. All rights reserved.
Primary Author: Oracle Corporation
Contributors: Oracle Real-Time Decisions development, product management, and quality assurance teams.
This software and related documentation are provided under a license agreement containing restrictions on
use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your
license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license,
transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse
engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is
prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If
you find any errors, please report them to us in writing.
If this software or related documentation is delivered to the U.S. Government or anyone licensing it on
behalf of the U.S. Government, the following notice is applicable:
U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data
delivered to U.S. Government customers are "commercial computer software" or "commercial technical data"
pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As
such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and
license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of
the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software
License (December 2007). Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065.
This software is developed for general use in a variety of information management applications. It is not
developed or intended for use in any inherently dangerous applications, including applications which may
create a risk of personal injury. If you use this software in dangerous applications, then you shall be
responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure the safe use
of this software. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of
this software in dangerous applications.
Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks
of their respective owners.
This software and documentation may provide access to or information on content, products, and services
from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all
warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and
its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of
third-party content, products, or services.
Contents
Preface ............................................................................................................................................................... xiii
Audience.....................................................................................................................................................
Documentation Accessibility ...................................................................................................................
Related Documents ...................................................................................................................................
Conventions ...............................................................................................................................................
Part I
1
Getting Started
About Oracle Real-Time Decisions
1.1
1.2
1.2.1
1.2.2
1.2.3
1.2.4
1.2.5
1.2.6
1.3
1.4
2
xiii
xiii
xiv
xiv
Terminology.................................................................................................................................
About Decision Studio ...............................................................................................................
Inline Service Explorer View..............................................................................................
Problems View .....................................................................................................................
Test View...............................................................................................................................
Cheat Sheets View ...............................................................................................................
Editor Area............................................................................................................................
Arranging Views and Resizing Editors ............................................................................
About Decision Center ...............................................................................................................
About the Inline Service Lifecycle ............................................................................................
1-1
1-2
1-3
1-4
1-4
1-4
1-4
1-4
1-4
1-5
Creating an Inline Service
2.1
2.2
2.3
2.4
2.4.1
2.4.1.1
2.4.1.2
2.4.2
2.4.2.1
2.4.2.2
2.4.2.3
2.5
2.5.1
2.5.2
About the Inline Service Tutorial .............................................................................................
About Deployment and Decision Center Security.................................................................
About Naming and Descriptions..............................................................................................
Accessing Data ............................................................................................................................
Adding a Data Source .........................................................................................................
Creating the New Data Source ...................................................................................
Importing the Outputs for a Data Source .................................................................
Adding an Entity .................................................................................................................
Creating the New Entity..............................................................................................
About Additional Entity Properties...........................................................................
Adding an Entity Key ..................................................................................................
About the Session Entity............................................................................................................
Adding an Attribute to the Session Entity .......................................................................
Creating a Session Key........................................................................................................
2-1
2-3
2-4
2-4
2-5
2-5
2-5
2-6
2-6
2-7
2-8
2-8
2-8
2-8
iii
2.5.3
2.6
2.6.1
2.6.2
2.7
2.8
2.8.1
2.8.2
2.8.3
2.8.4
2.8.5
2.9
2.9.1
2.9.2
2.9.3
2.9.4
2.9.5
Mapping the Entity to the Data Source ............................................................................ 2-9
Adding an Informant ................................................................................................................. 2-9
Creating an Informant...................................................................................................... 2-10
Adding Testing Logic to the Informant......................................................................... 2-10
Testing the Inline Service........................................................................................................ 2-11
Adding Functionality .............................................................................................................. 2-12
Creating a Call Entity ....................................................................................................... 2-13
Creating the Call Begin Informant ................................................................................. 2-13
Creating the Service Complete Informant .................................................................... 2-14
Creating the Call End Informant .................................................................................... 2-15
Testing the Informants ..................................................................................................... 2-16
Analyze Call Reasons .............................................................................................................. 2-17
About Using Choices for Analysis ................................................................................. 2-18
Adding a Choice Group................................................................................................... 2-18
Adding an Analytical Model .......................................................................................... 2-19
Adding Logic for Selecting Choices............................................................................... 2-19
Testing It All Together ..................................................................................................... 2-21
3 Simulating Load for Inline Services
3.1
3.1.1
3.1.2
3.1.3
3.2
3.2.1
Performance Under Load ..........................................................................................................
Creating the Load Generator Script ..................................................................................
Viewing Analysis Results in Decision Center .................................................................
Excluding the Attribute ......................................................................................................
Resetting the Model Learnings .................................................................................................
Summary of the Inline Service...........................................................................................
3-1
3-2
3-6
3-7
3-7
3-8
4 Enhancing the Call Center Inline Service
4.1
4.2
4.3
4.4
4.5
4.6
4.7
4.8
4.9
About Using Choice Groups and Scoring to Cross Sell ........................................................
Creating an Offer Inventory Using Choice Groups ...............................................................
Configuring Performance Goals ...............................................................................................
Scoring the Choices.....................................................................................................................
About Advisors ...........................................................................................................................
Creating the Decisions................................................................................................................
Creating the Advisor ..................................................................................................................
Viewing the Integration Map ....................................................................................................
Testing the Advisor ....................................................................................................................
4-1
4-2
4-3
4-3
4-5
4-5
4-6
4-7
4-8
5 Closing the Feedback Loop
5.1
Using Events to Track Success ..................................................................................................
5.1.1
Defining Events in Choice Groups....................................................................................
5.1.2
Defining a Choice Event Model.........................................................................................
5.1.3
Additional Model Settings .................................................................................................
5.1.3.1
Partitioning Attributes .................................................................................................
5.1.3.2
Excluded Attributes .....................................................................................................
5.1.3.3
Learn Location ..............................................................................................................
5.1.4
Remembering the Extended Offer.....................................................................................
iv
5-1
5-2
5-2
5-3
5-3
5-3
5-4
5-4
5.1.5
5.1.6
5.1.7
5.2
5.2.1
5.2.2
5.2.3
5.2.4
5.2.5
5.2.6
5.2.7
5.2.8
5.2.9
Part II
Creating the Feedback Informant...................................................................................... 5-5
Testing the Feedback Informant ........................................................................................ 5-6
Updating the Load Generator Script ................................................................................ 5-7
Using the Predictive Power of Models ................................................................................. 5-11
Adding a Base Revenue Choice Attribute..................................................................... 5-11
Adding a Second Performance Goal (Maximize Revenue) ........................................ 5-12
Calculating Score Value for the Maximize Revenue Performance Goal .................. 5-12
Updating the Select Offer Decision to Include the Second Performance Goal........ 5-13
Adding a Choice Attribute to View Likelihood of Acceptance ................................. 5-14
Checking the Likelihood Value ...................................................................................... 5-14
Introducing Offer Acceptance Bias for Selected Customers ...................................... 5-16
Running the Load Generator Script ............................................................................... 5-17
Studying the Results......................................................................................................... 5-18
Integration with Oracle RTD
6 About Integrating with Oracle RTD
6.1
6.1.1
6.1.2
6.1.3
6.1.4
6.1.5
6.2
6.2.1
6.2.2
6.2.3
6.2.4
6.3
6.4
Choosing the Best Means of Integration..................................................................................
About the Java Smart Client...............................................................................................
About the .NET Smart Client .............................................................................................
About the JSP Smart Client ................................................................................................
About the PHP Client..........................................................................................................
About Web Services.............................................................................................................
About the CrossSell Inline Service ...........................................................................................
Using Decision Studio to Identify Object IDs..................................................................
Identifying Session Keys and Arguments........................................................................
Determining the Response of an Advisor ........................................................................
Identifying Event Responses to Oracle RTD ...................................................................
Oracle RTD Web Services and Web Service Security ............................................................
System Requirements and Certification ..................................................................................
6-1
6-2
6-3
6-3
6-3
6-3
6-3
6-4
6-5
6-5
6-6
6-6
6-6
7 Using the Java Smart Client
7.1
7.2
7.2.1
7.2.2
7.2.3
7.2.4
7.2.5
7.2.6
7.2.7
Before You Begin.........................................................................................................................
Integrating with an Inline Service Using the Java Smart Client ..........................................
Preparing the Java Smart Client Example........................................................................
Creating the Java Smart Client Properties File ................................................................
Creating the Java Smart Client...........................................................................................
Creating the Request ...........................................................................................................
Examining the Response.....................................................................................................
Closing the Loop ..................................................................................................................
Closing the Client ................................................................................................................
7-1
7-1
7-2
7-3
7-4
7-6
7-6
7-7
7-8
8 Using Java Smart Client JSP Tags
8.1
8.2
8.3
Before You Begin......................................................................................................................... 8-1
Integrating with an Inline Service Using Java Smart Client JSP Tags................................. 8-2
Deploying the JSP Smart Client Example................................................................................ 8-2
v
8.3.1
Deploying the JSP Smart Client Example to WebLogic ................................................. 8-2
9 PHP Client
9.1
9.2
9.2.1
9.2.2
9.2.3
9.2.4
9.2.5
9.2.6
9.2.7
Before You Begin.........................................................................................................................
Integrating with an Inline Service Using the Oracle RTD PHP Client................................
Deploying the PHP Client Example..................................................................................
Setting up the Oracle RTD PHP Client .ini File...............................................................
Editing the Nusoap Path Library Location ......................................................................
Creating the Oracle RTD PHP Client................................................................................
Creating the Request ...........................................................................................................
Examining the Response.....................................................................................................
Closing the Loop ..................................................................................................................
9-1
9-2
9-2
9-3
9-5
9-5
9-6
9-6
9-7
10 Using the .NET Smart Client
10.1
10.2
10.3
Before You Begin...................................................................................................................... 10-1
Integrating with an Inline Service Using the .NET Smart Client...................................... 10-2
.NET Integration Example ...................................................................................................... 10-2
11 Web Service Client Example
11.1
11.2
11.3
Part III
Before You Begin...................................................................................................................... 11-1
Creating a New NetBeans Java Application Project ........................................................... 11-2
Adding the Provided Java Code and Testing the Client.................................................... 11-2
Decision Studio Reference
12 About Decision Studio
12.1
About Inline Services...............................................................................................................
12.1.1
Configuring Inline Services.............................................................................................
12.1.2
General Types of Inline Service ......................................................................................
12.1.2.1
Observer Inline Services ...........................................................................................
12.1.2.2
Advisor Inline Services .............................................................................................
12.2
Decision Studio and Eclipse ...................................................................................................
12.2.1
Selecting the Decision Studio Workspace .....................................................................
12.2.2
Setting the Java Compiler Compliance Level ...............................................................
12.2.3
About the Inline Service Explorer ..................................................................................
12.2.4
Code Generation ...............................................................................................................
12.2.5
About Decision Studio Perspectives and Views ..........................................................
12.2.6
Arranging Views and Resizing Editors .........................................................................
12.2.7
Adding Custom Logic to Elements ................................................................................
12.2.8
Overriding Generated Code............................................................................................
12.2.9
Performing Inline Service Searches................................................................................
12.3
About Decision Studio Projects..............................................................................................
12.3.1
Starting a New Project......................................................................................................
12.3.2
Importing a Project ...........................................................................................................
12.3.3
Creating a User-Defined Template ................................................................................
12.3.4
Downloading a Deployed Inline Service.....................................................................
vi
12-2
12-2
12-2
12-2
12-2
12-3
12-3
12-3
12-3
12-5
12-6
12-8
12-8
12-8
12-9
12-9
12-9
12-9
12-9
12-10
12.3.5
About Deployment States..............................................................................................
12.3.6
Example Projects .............................................................................................................
12.4
Inline Service Directory Structure .......................................................................................
12.5
Inline Service Security ...........................................................................................................
12-10
12-10
12-13
12-13
13 About Decision Studio Elements and APIs
13.1
Overview of the Oracle RTD Decisioning Process..............................................................
13.2
The Oracle RTD Decisioning Process ...................................................................................
13.3
About Element Display Labels and Object IDs ...................................................................
13.4
About the Application Element .............................................................................................
13.4.1
Application Parameters ...................................................................................................
13.4.1.1
Using Debugging Options........................................................................................
13.4.1.2
Adding Application Parameters .............................................................................
13.4.2
Application APIs...............................................................................................................
13.4.3
Configuring the Control Group......................................................................................
13.4.4
Setting Model Defaults.....................................................................................................
13.4.5
Writing Application Logic.............................................................................................
13.4.5.1
Adding Imported Java Classes ..............................................................................
13.5
Accessing Data .......................................................................................................................
13.5.1
About Data Sources ........................................................................................................
13.5.2
Creating SQL Data Sources ...........................................................................................
13.5.2.1
SQL Data Source Characteristics ...........................................................................
13.5.2.2
Adding Columns to the Data Source....................................................................
13.5.2.3
Importing Database Column Names....................................................................
13.5.2.4
Setting the Input Column .......................................................................................
13.5.3
Creating Stored Procedure Data Sources ....................................................................
13.5.3.1
Stored Procedure Data Source Characteristics....................................................
13.5.3.2
Importing Stored Procedure Parameters .............................................................
13.5.3.3
Adding Attributes to the Data Source ..................................................................
13.5.3.4
Adding Result Sets to the Data Source.................................................................
13.5.3.5
Examples of Setting Up Data Sources from Stored Procedures .......................
13.5.4
Accessing Oracle Business Intelligence Enterprise Edition Data ............................
13.6
Forming Entities .....................................................................................................................
13.6.1
About the Session Entity................................................................................................
13.6.1.1
About Session Keys .................................................................................................
13.6.2
Creating Entities..............................................................................................................
13.6.3
Adding Attributes and Keys to the Entity ..................................................................
13.6.4
Importing Attributes From a Data Source ..................................................................
13.6.5
Using Attributes for Analysis .......................................................................................
13.6.6
Decision Center Display ................................................................................................
13.6.7
Adding a Session Key ....................................................................................................
13.6.8
Adding Attributes to the Session .................................................................................
13.6.9
Mapping Attributes to Data Sources ...........................................................................
13.6.10
One-to-Many Relationships ..........................................................................................
13.6.11
Adding Imported Java Classes .....................................................................................
13.6.12
Session Logic ...................................................................................................................
13.6.13
Session APIs.....................................................................................................................
13-1
13-2
13-7
13-7
13-7
13-7
13-8
13-8
13-8
13-9
13-10
13-10
13-10
13-11
13-11
13-11
13-12
13-12
13-12
13-13
13-13
13-13
13-13
13-14
13-14
13-14
13-14
13-15
13-16
13-16
13-16
13-17
13-17
13-18
13-18
13-18
13-18
13-19
13-19
13-19
13-19
vii
13.6.14
Entity APIs .......................................................................................................................
13.6.15
About Entity Classes ......................................................................................................
13.6.16
Referencing Entities in Oracle RTD Logic...................................................................
13.6.17
Adding Entity Keys ........................................................................................................
13.6.18
Accessing Entity Attributes...........................................................................................
13.6.19
Resetting and Filling an Entity .....................................................................................
13.6.20
About Cached Entities ...................................................................................................
13.6.21
Enhanced Entity Attribute Logging.............................................................................
13.7
Performance Goals.................................................................................................................
13.7.1
Adding a Performance Metric ......................................................................................
13.7.2
Calculating a Normalization Factor .............................................................................
13.8
Choice Groups and Choices .................................................................................................
13.8.1
About Choice Groups and Choices..............................................................................
13.8.2
About Choice Group and Choice Attributes ..............................................................
13.8.3
Choice Attribute Characteristics...................................................................................
13.8.4
About Choice Scoring ....................................................................................................
13.8.5
About Eligibility Rules...................................................................................................
13.8.6
Evaluating Choice Group Rules and Choice Eligibility Rules .................................
13.8.7
Determining Eligibility ..................................................................................................
13.8.8
Choice Group APIs.........................................................................................................
13.8.9
Choice APIs .....................................................................................................................
13.9
Filtering Rules.........................................................................................................................
13.10 Scoring Rules ..........................................................................................................................
13.11 Using Rule Editors .................................................................................................................
13.11.1
Oracle RTD Rule Terms and Statements .....................................................................
13.11.2
Adding Statements to Rules..........................................................................................
13.11.3
Selecting an Operator .....................................................................................................
13.11.4
Editing Boolean Statements...........................................................................................
13.11.4.1
Using Type-Restricted Objects in Rules ...............................................................
13.11.5
Editing Rule Properties..................................................................................................
13.11.6
Inverting Rule Elements ................................................................................................
13.12 About Decisions .....................................................................................................................
13.12.1
Segmenting Population and Weighting Goals ...........................................................
13.12.2
Using a Custom Selection Function .............................................................................
13.12.3
Pre/Post-Selection Logic ...............................................................................................
13.12.4
Selection Function APIs for Custom Goal Weights ...................................................
13.12.5
Adding Imported Java Classes and Changing the Decision Center Display.........
13.13 About Selection Functions ....................................................................................................
13.13.1
Selection Function Scriptlets .........................................................................................
13.13.2
Adding Imported Java Classes and Changing the Decision Center Display.........
13.14 About Models .........................................................................................................................
13.14.1
Model Types ....................................................................................................................
13.14.2
Common Model Parameters .........................................................................................
13.14.3
Model Attributes.............................................................................................................
13.14.4
Model APIs ......................................................................................................................
13.14.4.1
Querying the Model ................................................................................................
13.14.4.2
Recording the Choice with the Model..................................................................
viii
13-20
13-20
13-21
13-21
13-21
13-21
13-22
13-22
13-24
13-24
13-24
13-26
13-27
13-28
13-29
13-30
13-30
13-31
13-31
13-31
13-32
13-32
13-33
13-33
13-34
13-38
13-39
13-40
13-41
13-41
13-41
13-42
13-43
13-45
13-46
13-46
13-46
13-46
13-47
13-47
13-47
13-49
13-50
13-52
13-55
13-55
13-55
13.14.4.3
Obtaining Model Object by String Name.............................................................
13.14.4.4
Recording Choice Events for Choice Event Models ...........................................
13.14.4.5
Recording Choices for Choice Models .................................................................
13.14.4.6
Obtaining Model Choice Likelihood ....................................................................
13.15 About Integration Points ......................................................................................................
13.15.1
About Informants ...........................................................................................................
13.15.1.1
Adding a Session Key .............................................................................................
13.15.1.2
Identifying the External System and Order.........................................................
13.15.1.3
Adding Request Data..............................................................................................
13.15.2
Adding Imported Java Classes and Changing the Decision Center Display.........
13.15.3
Informant APIs................................................................................................................
13.15.4
Informant Logic...............................................................................................................
13.15.4.1
Logic ..........................................................................................................................
13.15.4.2
Asynchronous Logic ...............................................................................................
13.15.4.3
Accessing Request Data From the Informant......................................................
13.15.5
About Advisors ...............................................................................................................
13.15.6
About the Advisor Decisioning Process......................................................................
13.15.7
Adding Imported Java Classes and Changing the Decision Center Display.........
13.15.8
Adding a Session Key ....................................................................................................
13.15.9
Identifying the External System and Order ................................................................
13.15.10
Adding Request Data .....................................................................................................
13.15.11
Adding Response Data ..................................................................................................
13.15.12
Logic in Advisors............................................................................................................
13.15.12.1
Logic ..........................................................................................................................
13.15.12.2
Asynchronous Logic ...............................................................................................
13.15.13
Accessing Request Data from the Advisor .................................................................
13.15.14
Temporary Sessions for Integration Points Without Session Keys .........................
13.16 About External Systems ........................................................................................................
13.17 About the Categories Object.................................................................................................
13.18 About Functions.....................................................................................................................
13.18.1
Functions to Use with Choice Event History Table...................................................
13.18.2
About Maintenance Operations ...................................................................................
13.18.3
Adding Imported Java Classes and Changing the Decision Center Display.........
13.19 About Type Restrictions .......................................................................................................
13.19.1
Managing Type Restrictions .........................................................................................
13.19.1.1
Creating and Editing "List of Values" Type Restrictions ...................................
13.19.1.2
Creating and Editing "List of Entities" Type Restrictions..................................
13.19.1.3
Creating and Editing Other Restrictions..............................................................
13.19.1.4
Associating Type Restrictions with Inline Service Objects................................
13.19.1.5
Using Type Restrictions in Rules ..........................................................................
13.19.1.6
Examples of Type Restrictions...............................................................................
13.20 About Statistic Collectors......................................................................................................
13.20.1
Creating a Custom Statistics Collector ........................................................................
13-56
13-56
13-57
13-58
13-58
13-59
13-60
13-60
13-60
13-60
13-60
13-61
13-61
13-61
13-61
13-61
13-62
13-62
13-62
13-62
13-63
13-63
13-64
13-64
13-64
13-64
13-64
13-65
13-65
13-65
13-66
13-66
13-67
13-67
13-68
13-68
13-68
13-69
13-70
13-70
13-71
13-73
13-73
14 Deploying, Testing, and Debugging Inline Services
14.1
14.2
Deploying Inline Services ....................................................................................................... 14-1
Connecting to Real-Time Decision Server............................................................................ 14-3
ix
14.3
Redeploying Inline Services ...................................................................................................
14.4
Testing and Debugging Inline Services ................................................................................
14.4.1
About the Problems View ...............................................................................................
14.4.2
Using the Test View..........................................................................................................
14.4.2.1
Using logInfo() ...........................................................................................................
14.4.2.2
Testing for Incoming Request Data ........................................................................
14.4.3
Using System Logs for Testing and Debugging Inline Services ................................
14-4
14-4
14-5
14-5
14-5
14-6
14-6
15 About the Load Generator
15.1
15.2
15.3
15.3.1
15.4
15.5
15.5.1
15.5.2
15.5.3
15.5.4
15.5.5
15.6
15.6.1
15.6.2
15.7
15.7.1
15.8
15.9
Part IV
16
Using Load Generator for Testing.........................................................................................
Using Load Generator for Performance Characterization.................................................
Running a Load Generator Session .......................................................................................
Measuring the Server Load .............................................................................................
Viewing Performance Graphs................................................................................................
About the General Tab ............................................................................................................
Load Generator Section....................................................................................................
Details Section ...................................................................................................................
Think Time Section ...........................................................................................................
Scripts Section ...................................................................................................................
Logging Section.................................................................................................................
About Variables........................................................................................................................
Using Variables .................................................................................................................
Variable Types...................................................................................................................
About Actions...........................................................................................................................
Types of Actions ...............................................................................................................
Load Generator CSV Log File Contents................................................................................
XLS File Contents .....................................................................................................................
Miscellaneous Application Development
Oracle RTD Batch Framework
16.1
Batch Framework Architecture..............................................................................................
16.1.1
Batch Framework Components ......................................................................................
16.1.2
Use of Batch Framework in a Clustered Environment ...............................................
16.2
Implementing Batch Jobs ........................................................................................................
16.2.1
Implementing the BatchJob Interface ............................................................................
16.2.2
Registering Batch Jobs with the Batch Framework......................................................
16.2.2.1
BatchAgent .................................................................................................................
16.2.2.2
Registering the Imported Java Classes in the Inline Service ...............................
16.2.2.3
Registering the Batch Jobs in the Inline Service ....................................................
16.3
Administering Batch Jobs .......................................................................................................
16.3.1
Using the BatchClientAdmin Interface..........................................................................
16.3.2
Using the Batch Console ..................................................................................................
16.3.2.1
Notes on Batch Console Commands ....................................................................
16.3.2.2
Running Jobs Sequentially .....................................................................................
16.3.2.3
Running Jobs Concurrently....................................................................................
x
15-1
15-2
15-2
15-2
15-2
15-3
15-3
15-3
15-4
15-4
15-4
15-4
15-5
15-5
15-5
15-6
15-6
15-7
16-2
16-2
16-3
16-4
16-4
16-5
16-5
16-5
16-6
16-6
16-7
16-8
16-10
16-11
16-12
17 Externalized Objects Management
17.1
Dynamic Choices .....................................................................................................................
17.1.1
Simple Example of Dynamic Choices ............................................................................
17.1.2
Basic Dynamic Choice Design Implications .................................................................
17.1.3
Multiple Category Dynamic Choices from a Single Data Source..............................
17.1.3.1
Different Dynamic Choice Categories in the Same Data Source ........................
17.1.4
Prerequisite External Data Source for Dynamic Choices............................................
17.1.5
Overview of Setting up Dynamic Choices in Decision Studio...................................
17.1.6
Creating the Dynamic Choice Data Source...................................................................
17.1.7
Creating the Single Dynamic Choice Entity .................................................................
17.1.8
Creating the Dynamic Choice Set Entity .....................................................................
17.1.9
Creating the Dynamic Choice Data Retrieval Function ............................................
17.1.10
Considerations for Choice Group Design ...................................................................
17.1.11
Creating a Single Category Choice Group ..................................................................
17.1.11.1
Group Attributes Tab..............................................................................................
17.1.11.2
Choice Attributes Tab .............................................................................................
17.1.11.3
Dynamic Choices Tab .............................................................................................
17.1.12
Creating a Multi-Category Choice Group...................................................................
17.1.12.1
Choice Attributes Tab in the Parent Choice Group............................................
17.1.12.2
Group Attributes Tab in the Child Choice Groups ............................................
17.1.12.3
Dynamic Choices Tab in the Child Choice Groups............................................
17.1.13
Dynamic Choice Reporting Overview.........................................................................
17.1.13.1
Applications with Static Choices Only.................................................................
17.1.13.2
Dynamic Choice Visibility......................................................................................
17.1.13.3
System-Created Range Folders..............................................................................
17.1.13.4
Distribution of Choices Across Decision Center Folders...................................
17.1.13.5
Example of a Decision Center Report with Dynamic Choices..........................
17.2
External Rules.........................................................................................................................
17.2.1
Introduction to External Rules .....................................................................................
17.2.2
External Rule Editor Components ...............................................................................
17.2.2.1
External Rule Editor and External Rule Editor Client .......................................
17.2.2.2
Oracle Web Service Manager (OWSM) ................................................................
17.2.2.3
Security......................................................................................................................
17.2.2.4
Workbench Web Services .......................................................................................
17.2.3
External Rule Editor Deployment Topologies............................................................
17.2.4
Steps to Create and Deploy the External Rule Editor ...............................................
17.2.4.1
Construct...................................................................................................................
17.2.4.2
Integrate ....................................................................................................................
17.2.4.3
Package...........................................
Platform Developer's Guide for Oracle Real-Time Decisions
11g Release 1 (11.1.1)
E16630-03
April 2011
Oracle Fusion Middleware Platform Developer's Guide for Oracle Real-Time Decisions 11g Release 1 (11.1.1)
E16630-03
Copyright © 2010, 2011, Oracle and/or its affiliates. All rights reserved.
Primary Author: Oracle Corporation
Contributors: Oracle Real-Time Decisions development, product management, and quality assurance teams.
This software and related documentation are provided under a license agreement containing restrictions on
use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your
license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license,
transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse
engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is
prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If
you find any errors, please report them to us in writing.
If this software or related documentation is delivered to the U.S. Government or anyone licensing it on
behalf of the U.S. Government, the following notice is applicable:
U.S. GOVERNMENT RIGHTS Programs, software, databases, and related documentation and technical data
delivered to U.S. Government customers are "commercial computer software" or "commercial technical data"
pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As
such, the use, duplication, disclosure, modification, and adaptation shall be subject to the restrictions and
license terms set forth in the applicable Government contract, and, to the extent applicable by the terms of
the Government contract, the additional rights set forth in FAR 52.227-19, Commercial Computer Software
License (December 2007). Oracle USA, Inc., 500 Oracle Parkway, Redwood City, CA 94065.
This software is developed for general use in a variety of information management applications. It is not
developed or intended for use in any inherently dangerous applications, including applications which may
create a risk of personal injury. If you use this software in dangerous applications, then you shall be
responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure the safe use
of this software. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of
this software in dangerous applications.
Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks
of their respective owners.
This software and documentation may provide access to or information on content, products, and services
from third parties. Oracle Corporation and its affiliates are not responsible for and expressly disclaim all
warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and
its affiliates will not be responsible for any loss, costs, or damages incurred due to your access to or use of
third-party content, products, or services.
Contents
Preface ............................................................................................................................................................... xiii
Audience.....................................................................................................................................................
Documentation Accessibility ...................................................................................................................
Related Documents ...................................................................................................................................
Conventions ...............................................................................................................................................
Part I
1
Getting Started
About Oracle Real-Time Decisions
1.1
1.2
1.2.1
1.2.2
1.2.3
1.2.4
1.2.5
1.2.6
1.3
1.4
2
xiii
xiii
xiv
xiv
Terminology.................................................................................................................................
About Decision Studio ...............................................................................................................
Inline Service Explorer View..............................................................................................
Problems View .....................................................................................................................
Test View...............................................................................................................................
Cheat Sheets View ...............................................................................................................
Editor Area............................................................................................................................
Arranging Views and Resizing Editors ............................................................................
About Decision Center ...............................................................................................................
About the Inline Service Lifecycle ............................................................................................
1-1
1-2
1-3
1-4
1-4
1-4
1-4
1-4
1-4
1-5
Creating an Inline Service
2.1
2.2
2.3
2.4
2.4.1
2.4.1.1
2.4.1.2
2.4.2
2.4.2.1
2.4.2.2
2.4.2.3
2.5
2.5.1
2.5.2
About the Inline Service Tutorial .............................................................................................
About Deployment and Decision Center Security.................................................................
About Naming and Descriptions..............................................................................................
Accessing Data ............................................................................................................................
Adding a Data Source .........................................................................................................
Creating the New Data Source ...................................................................................
Importing the Outputs for a Data Source .................................................................
Adding an Entity .................................................................................................................
Creating the New Entity..............................................................................................
About Additional Entity Properties...........................................................................
Adding an Entity Key ..................................................................................................
About the Session Entity............................................................................................................
Adding an Attribute to the Session Entity .......................................................................
Creating a Session Key........................................................................................................
2-1
2-3
2-4
2-4
2-5
2-5
2-5
2-6
2-6
2-7
2-8
2-8
2-8
2-8
iii
2.5.3
2.6
2.6.1
2.6.2
2.7
2.8
2.8.1
2.8.2
2.8.3
2.8.4
2.8.5
2.9
2.9.1
2.9.2
2.9.3
2.9.4
2.9.5
Mapping the Entity to the Data Source ............................................................................ 2-9
Adding an Informant ................................................................................................................. 2-9
Creating an Informant...................................................................................................... 2-10
Adding Testing Logic to the Informant......................................................................... 2-10
Testing the Inline Service........................................................................................................ 2-11
Adding Functionality .............................................................................................................. 2-12
Creating a Call Entity ....................................................................................................... 2-13
Creating the Call Begin Informant ................................................................................. 2-13
Creating the Service Complete Informant .................................................................... 2-14
Creating the Call End Informant .................................................................................... 2-15
Testing the Informants ..................................................................................................... 2-16
Analyze Call Reasons .............................................................................................................. 2-17
About Using Choices for Analysis ................................................................................. 2-18
Adding a Choice Group................................................................................................... 2-18
Adding an Analytical Model .......................................................................................... 2-19
Adding Logic for Selecting Choices............................................................................... 2-19
Testing It All Together ..................................................................................................... 2-21
3 Simulating Load for Inline Services
3.1
3.1.1
3.1.2
3.1.3
3.2
3.2.1
Performance Under Load ..........................................................................................................
Creating the Load Generator Script ..................................................................................
Viewing Analysis Results in Decision Center .................................................................
Excluding the Attribute ......................................................................................................
Resetting the Model Learnings .................................................................................................
Summary of the Inline Service...........................................................................................
3-1
3-2
3-6
3-7
3-7
3-8
4 Enhancing the Call Center Inline Service
4.1
4.2
4.3
4.4
4.5
4.6
4.7
4.8
4.9
About Using Choice Groups and Scoring to Cross Sell ........................................................
Creating an Offer Inventory Using Choice Groups ...............................................................
Configuring Performance Goals ...............................................................................................
Scoring the Choices.....................................................................................................................
About Advisors ...........................................................................................................................
Creating the Decisions................................................................................................................
Creating the Advisor ..................................................................................................................
Viewing the Integration Map ....................................................................................................
Testing the Advisor ....................................................................................................................
4-1
4-2
4-3
4-3
4-5
4-5
4-6
4-7
4-8
5 Closing the Feedback Loop
5.1
Using Events to Track Success ..................................................................................................
5.1.1
Defining Events in Choice Groups....................................................................................
5.1.2
Defining a Choice Event Model.........................................................................................
5.1.3
Additional Model Settings .................................................................................................
5.1.3.1
Partitioning Attributes .................................................................................................
5.1.3.2
Excluded Attributes .....................................................................................................
5.1.3.3
Learn Location ..............................................................................................................
5.1.4
Remembering the Extended Offer.....................................................................................
iv
5-1
5-2
5-2
5-3
5-3
5-3
5-4
5-4
5.1.5
5.1.6
5.1.7
5.2
5.2.1
5.2.2
5.2.3
5.2.4
5.2.5
5.2.6
5.2.7
5.2.8
5.2.9
Part II
Creating the Feedback Informant...................................................................................... 5-5
Testing the Feedback Informant ........................................................................................ 5-6
Updating the Load Generator Script ................................................................................ 5-7
Using the Predictive Power of Models ................................................................................. 5-11
Adding a Base Revenue Choice Attribute..................................................................... 5-11
Adding a Second Performance Goal (Maximize Revenue) ........................................ 5-12
Calculating Score Value for the Maximize Revenue Performance Goal .................. 5-12
Updating the Select Offer Decision to Include the Second Performance Goal........ 5-13
Adding a Choice Attribute to View Likelihood of Acceptance ................................. 5-14
Checking the Likelihood Value ...................................................................................... 5-14
Introducing Offer Acceptance Bias for Selected Customers ...................................... 5-16
Running the Load Generator Script ............................................................................... 5-17
Studying the Results......................................................................................................... 5-18
Integration with Oracle RTD
6 About Integrating with Oracle RTD
6.1
6.1.1
6.1.2
6.1.3
6.1.4
6.1.5
6.2
6.2.1
6.2.2
6.2.3
6.2.4
6.3
6.4
Choosing the Best Means of Integration..................................................................................
About the Java Smart Client...............................................................................................
About the .NET Smart Client .............................................................................................
About the JSP Smart Client ................................................................................................
About the PHP Client..........................................................................................................
About Web Services.............................................................................................................
About the CrossSell Inline Service ...........................................................................................
Using Decision Studio to Identify Object IDs..................................................................
Identifying Session Keys and Arguments........................................................................
Determining the Response of an Advisor ........................................................................
Identifying Event Responses to Oracle RTD ...................................................................
Oracle RTD Web Services and Web Service Security ............................................................
System Requirements and Certification ..................................................................................
6-1
6-2
6-3
6-3
6-3
6-3
6-3
6-4
6-5
6-5
6-6
6-6
6-6
7 Using the Java Smart Client
7.1
7.2
7.2.1
7.2.2
7.2.3
7.2.4
7.2.5
7.2.6
7.2.7
Before You Begin.........................................................................................................................
Integrating with an Inline Service Using the Java Smart Client ..........................................
Preparing the Java Smart Client Example........................................................................
Creating the Java Smart Client Properties File ................................................................
Creating the Java Smart Client...........................................................................................
Creating the Request ...........................................................................................................
Examining the Response.....................................................................................................
Closing the Loop ..................................................................................................................
Closing the Client ................................................................................................................
7-1
7-1
7-2
7-3
7-4
7-6
7-6
7-7
7-8
8 Using Java Smart Client JSP Tags
8.1
8.2
8.3
Before You Begin......................................................................................................................... 8-1
Integrating with an Inline Service Using Java Smart Client JSP Tags................................. 8-2
Deploying the JSP Smart Client Example................................................................................ 8-2
v
8.3.1
Deploying the JSP Smart Client Example to WebLogic ................................................. 8-2
9 PHP Client
9.1
9.2
9.2.1
9.2.2
9.2.3
9.2.4
9.2.5
9.2.6
9.2.7
Before You Begin.........................................................................................................................
Integrating with an Inline Service Using the Oracle RTD PHP Client................................
Deploying the PHP Client Example..................................................................................
Setting up the Oracle RTD PHP Client .ini File...............................................................
Editing the Nusoap Path Library Location ......................................................................
Creating the Oracle RTD PHP Client................................................................................
Creating the Request ...........................................................................................................
Examining the Response.....................................................................................................
Closing the Loop ..................................................................................................................
9-1
9-2
9-2
9-3
9-5
9-5
9-6
9-6
9-7
10 Using the .NET Smart Client
10.1
10.2
10.3
Before You Begin...................................................................................................................... 10-1
Integrating with an Inline Service Using the .NET Smart Client...................................... 10-2
.NET Integration Example ...................................................................................................... 10-2
11 Web Service Client Example
11.1
11.2
11.3
Part III
Before You Begin...................................................................................................................... 11-1
Creating a New NetBeans Java Application Project ........................................................... 11-2
Adding the Provided Java Code and Testing the Client.................................................... 11-2
Decision Studio Reference
12 About Decision Studio
12.1
About Inline Services...............................................................................................................
12.1.1
Configuring Inline Services.............................................................................................
12.1.2
General Types of Inline Service ......................................................................................
12.1.2.1
Observer Inline Services ...........................................................................................
12.1.2.2
Advisor Inline Services .............................................................................................
12.2
Decision Studio and Eclipse ...................................................................................................
12.2.1
Selecting the Decision Studio Workspace .....................................................................
12.2.2
Setting the Java Compiler Compliance Level ...............................................................
12.2.3
About the Inline Service Explorer ..................................................................................
12.2.4
Code Generation ...............................................................................................................
12.2.5
About Decision Studio Perspectives and Views ..........................................................
12.2.6
Arranging Views and Resizing Editors .........................................................................
12.2.7
Adding Custom Logic to Elements ................................................................................
12.2.8
Overriding Generated Code............................................................................................
12.2.9
Performing Inline Service Searches................................................................................
12.3
About Decision Studio Projects..............................................................................................
12.3.1
Starting a New Project......................................................................................................
12.3.2
Importing a Project ...........................................................................................................
12.3.3
Creating a User-Defined Template ................................................................................
12.3.4
Downloading a Deployed Inline Service.....................................................................
vi
12-2
12-2
12-2
12-2
12-2
12-3
12-3
12-3
12-3
12-5
12-6
12-8
12-8
12-8
12-9
12-9
12-9
12-9
12-9
12-10
12.3.5
About Deployment States..............................................................................................
12.3.6
Example Projects .............................................................................................................
12.4
Inline Service Directory Structure .......................................................................................
12.5
Inline Service Security ...........................................................................................................
12-10
12-10
12-13
12-13
13 About Decision Studio Elements and APIs
13.1
Overview of the Oracle RTD Decisioning Process..............................................................
13.2
The Oracle RTD Decisioning Process ...................................................................................
13.3
About Element Display Labels and Object IDs ...................................................................
13.4
About the Application Element .............................................................................................
13.4.1
Application Parameters ...................................................................................................
13.4.1.1
Using Debugging Options........................................................................................
13.4.1.2
Adding Application Parameters .............................................................................
13.4.2
Application APIs...............................................................................................................
13.4.3
Configuring the Control Group......................................................................................
13.4.4
Setting Model Defaults.....................................................................................................
13.4.5
Writing Application Logic.............................................................................................
13.4.5.1
Adding Imported Java Classes ..............................................................................
13.5
Accessing Data .......................................................................................................................
13.5.1
About Data Sources ........................................................................................................
13.5.2
Creating SQL Data Sources ...........................................................................................
13.5.2.1
SQL Data Source Characteristics ...........................................................................
13.5.2.2
Adding Columns to the Data Source....................................................................
13.5.2.3
Importing Database Column Names....................................................................
13.5.2.4
Setting the Input Column .......................................................................................
13.5.3
Creating Stored Procedure Data Sources ....................................................................
13.5.3.1
Stored Procedure Data Source Characteristics....................................................
13.5.3.2
Importing Stored Procedure Parameters .............................................................
13.5.3.3
Adding Attributes to the Data Source ..................................................................
13.5.3.4
Adding Result Sets to the Data Source.................................................................
13.5.3.5
Examples of Setting Up Data Sources from Stored Procedures .......................
13.5.4
Accessing Oracle Business Intelligence Enterprise Edition Data ............................
13.6
Forming Entities .....................................................................................................................
13.6.1
About the Session Entity................................................................................................
13.6.1.1
About Session Keys .................................................................................................
13.6.2
Creating Entities..............................................................................................................
13.6.3
Adding Attributes and Keys to the Entity ..................................................................
13.6.4
Importing Attributes From a Data Source ..................................................................
13.6.5
Using Attributes for Analysis .......................................................................................
13.6.6
Decision Center Display ................................................................................................
13.6.7
Adding a Session Key ....................................................................................................
13.6.8
Adding Attributes to the Session .................................................................................
13.6.9
Mapping Attributes to Data Sources ...........................................................................
13.6.10
One-to-Many Relationships ..........................................................................................
13.6.11
Adding Imported Java Classes .....................................................................................
13.6.12
Session Logic ...................................................................................................................
13.6.13
Session APIs.....................................................................................................................
13-1
13-2
13-7
13-7
13-7
13-7
13-8
13-8
13-8
13-9
13-10
13-10
13-10
13-11
13-11
13-11
13-12
13-12
13-12
13-13
13-13
13-13
13-13
13-14
13-14
13-14
13-14
13-15
13-16
13-16
13-16
13-17
13-17
13-18
13-18
13-18
13-18
13-19
13-19
13-19
13-19
vii
13.6.14
Entity APIs .......................................................................................................................
13.6.15
About Entity Classes ......................................................................................................
13.6.16
Referencing Entities in Oracle RTD Logic...................................................................
13.6.17
Adding Entity Keys ........................................................................................................
13.6.18
Accessing Entity Attributes...........................................................................................
13.6.19
Resetting and Filling an Entity .....................................................................................
13.6.20
About Cached Entities ...................................................................................................
13.6.21
Enhanced Entity Attribute Logging.............................................................................
13.7
Performance Goals.................................................................................................................
13.7.1
Adding a Performance Metric ......................................................................................
13.7.2
Calculating a Normalization Factor .............................................................................
13.8
Choice Groups and Choices .................................................................................................
13.8.1
About Choice Groups and Choices..............................................................................
13.8.2
About Choice Group and Choice Attributes ..............................................................
13.8.3
Choice Attribute Characteristics...................................................................................
13.8.4
About Choice Scoring ....................................................................................................
13.8.5
About Eligibility Rules...................................................................................................
13.8.6
Evaluating Choice Group Rules and Choice Eligibility Rules .................................
13.8.7
Determining Eligibility ..................................................................................................
13.8.8
Choice Group APIs.........................................................................................................
13.8.9
Choice APIs .....................................................................................................................
13.9
Filtering Rules.........................................................................................................................
13.10 Scoring Rules ..........................................................................................................................
13.11 Using Rule Editors .................................................................................................................
13.11.1
Oracle RTD Rule Terms and Statements .....................................................................
13.11.2
Adding Statements to Rules..........................................................................................
13.11.3
Selecting an Operator .....................................................................................................
13.11.4
Editing Boolean Statements...........................................................................................
13.11.4.1
Using Type-Restricted Objects in Rules ...............................................................
13.11.5
Editing Rule Properties..................................................................................................
13.11.6
Inverting Rule Elements ................................................................................................
13.12 About Decisions .....................................................................................................................
13.12.1
Segmenting Population and Weighting Goals ...........................................................
13.12.2
Using a Custom Selection Function .............................................................................
13.12.3
Pre/Post-Selection Logic ...............................................................................................
13.12.4
Selection Function APIs for Custom Goal Weights ...................................................
13.12.5
Adding Imported Java Classes and Changing the Decision Center Display.........
13.13 About Selection Functions ....................................................................................................
13.13.1
Selection Function Scriptlets .........................................................................................
13.13.2
Adding Imported Java Classes and Changing the Decision Center Display.........
13.14 About Models .........................................................................................................................
13.14.1
Model Types ....................................................................................................................
13.14.2
Common Model Parameters .........................................................................................
13.14.3
Model Attributes.............................................................................................................
13.14.4
Model APIs ......................................................................................................................
13.14.4.1
Querying the Model ................................................................................................
13.14.4.2
Recording the Choice with the Model..................................................................
viii
13-20
13-20
13-21
13-21
13-21
13-21
13-22
13-22
13-24
13-24
13-24
13-26
13-27
13-28
13-29
13-30
13-30
13-31
13-31
13-31
13-32
13-32
13-33
13-33
13-34
13-38
13-39
13-40
13-41
13-41
13-41
13-42
13-43
13-45
13-46
13-46
13-46
13-46
13-47
13-47
13-47
13-49
13-50
13-52
13-55
13-55
13-55
13.14.4.3
Obtaining Model Object by String Name.............................................................
13.14.4.4
Recording Choice Events for Choice Event Models ...........................................
13.14.4.5
Recording Choices for Choice Models .................................................................
13.14.4.6
Obtaining Model Choice Likelihood ....................................................................
13.15 About Integration Points ......................................................................................................
13.15.1
About Informants ...........................................................................................................
13.15.1.1
Adding a Session Key .............................................................................................
13.15.1.2
Identifying the External System and Order.........................................................
13.15.1.3
Adding Request Data..............................................................................................
13.15.2
Adding Imported Java Classes and Changing the Decision Center Display.........
13.15.3
Informant APIs................................................................................................................
13.15.4
Informant Logic...............................................................................................................
13.15.4.1
Logic ..........................................................................................................................
13.15.4.2
Asynchronous Logic ...............................................................................................
13.15.4.3
Accessing Request Data From the Informant......................................................
13.15.5
About Advisors ...............................................................................................................
13.15.6
About the Advisor Decisioning Process......................................................................
13.15.7
Adding Imported Java Classes and Changing the Decision Center Display.........
13.15.8
Adding a Session Key ....................................................................................................
13.15.9
Identifying the External System and Order ................................................................
13.15.10
Adding Request Data .....................................................................................................
13.15.11
Adding Response Data ..................................................................................................
13.15.12
Logic in Advisors............................................................................................................
13.15.12.1
Logic ..........................................................................................................................
13.15.12.2
Asynchronous Logic ...............................................................................................
13.15.13
Accessing Request Data from the Advisor .................................................................
13.15.14
Temporary Sessions for Integration Points Without Session Keys .........................
13.16 About External Systems ........................................................................................................
13.17 About the Categories Object.................................................................................................
13.18 About Functions.....................................................................................................................
13.18.1
Functions to Use with Choice Event History Table...................................................
13.18.2
About Maintenance Operations ...................................................................................
13.18.3
Adding Imported Java Classes and Changing the Decision Center Display.........
13.19 About Type Restrictions .......................................................................................................
13.19.1
Managing Type Restrictions .........................................................................................
13.19.1.1
Creating and Editing "List of Values" Type Restrictions ...................................
13.19.1.2
Creating and Editing "List of Entities" Type Restrictions..................................
13.19.1.3
Creating and Editing Other Restrictions..............................................................
13.19.1.4
Associating Type Restrictions with Inline Service Objects................................
13.19.1.5
Using Type Restrictions in Rules ..........................................................................
13.19.1.6
Examples of Type Restrictions...............................................................................
13.20 About Statistic Collectors......................................................................................................
13.20.1
Creating a Custom Statistics Collector ........................................................................
13-56
13-56
13-57
13-58
13-58
13-59
13-60
13-60
13-60
13-60
13-60
13-61
13-61
13-61
13-61
13-61
13-62
13-62
13-62
13-62
13-63
13-63
13-64
13-64
13-64
13-64
13-64
13-65
13-65
13-65
13-66
13-66
13-67
13-67
13-68
13-68
13-68
13-69
13-70
13-70
13-71
13-73
13-73
14 Deploying, Testing, and Debugging Inline Services
14.1
14.2
Deploying Inline Services ....................................................................................................... 14-1
Connecting to Real-Time Decision Server............................................................................ 14-3
ix
14.3
Redeploying Inline Services ...................................................................................................
14.4
Testing and Debugging Inline Services ................................................................................
14.4.1
About the Problems View ...............................................................................................
14.4.2
Using the Test View..........................................................................................................
14.4.2.1
Using logInfo() ...........................................................................................................
14.4.2.2
Testing for Incoming Request Data ........................................................................
14.4.3
Using System Logs for Testing and Debugging Inline Services ................................
14-4
14-4
14-5
14-5
14-5
14-6
14-6
15 About the Load Generator
15.1
15.2
15.3
15.3.1
15.4
15.5
15.5.1
15.5.2
15.5.3
15.5.4
15.5.5
15.6
15.6.1
15.6.2
15.7
15.7.1
15.8
15.9
Part IV
16
Using Load Generator for Testing.........................................................................................
Using Load Generator for Performance Characterization.................................................
Running a Load Generator Session .......................................................................................
Measuring the Server Load .............................................................................................
Viewing Performance Graphs................................................................................................
About the General Tab ............................................................................................................
Load Generator Section....................................................................................................
Details Section ...................................................................................................................
Think Time Section ...........................................................................................................
Scripts Section ...................................................................................................................
Logging Section.................................................................................................................
About Variables........................................................................................................................
Using Variables .................................................................................................................
Variable Types...................................................................................................................
About Actions...........................................................................................................................
Types of Actions ...............................................................................................................
Load Generator CSV Log File Contents................................................................................
XLS File Contents .....................................................................................................................
Miscellaneous Application Development
Oracle RTD Batch Framework
16.1
Batch Framework Architecture..............................................................................................
16.1.1
Batch Framework Components ......................................................................................
16.1.2
Use of Batch Framework in a Clustered Environment ...............................................
16.2
Implementing Batch Jobs ........................................................................................................
16.2.1
Implementing the BatchJob Interface ............................................................................
16.2.2
Registering Batch Jobs with the Batch Framework......................................................
16.2.2.1
BatchAgent .................................................................................................................
16.2.2.2
Registering the Imported Java Classes in the Inline Service ...............................
16.2.2.3
Registering the Batch Jobs in the Inline Service ....................................................
16.3
Administering Batch Jobs .......................................................................................................
16.3.1
Using the BatchClientAdmin Interface..........................................................................
16.3.2
Using the Batch Console ..................................................................................................
16.3.2.1
Notes on Batch Console Commands ....................................................................
16.3.2.2
Running Jobs Sequentially .....................................................................................
16.3.2.3
Running Jobs Concurrently....................................................................................
x
15-1
15-2
15-2
15-2
15-2
15-3
15-3
15-3
15-4
15-4
15-4
15-4
15-5
15-5
15-5
15-6
15-6
15-7
16-2
16-2
16-3
16-4
16-4
16-5
16-5
16-5
16-6
16-6
16-7
16-8
16-10
16-11
16-12
17 Externalized Objects Management
17.1
Dynamic Choices .....................................................................................................................
17.1.1
Simple Example of Dynamic Choices ............................................................................
17.1.2
Basic Dynamic Choice Design Implications .................................................................
17.1.3
Multiple Category Dynamic Choices from a Single Data Source..............................
17.1.3.1
Different Dynamic Choice Categories in the Same Data Source ........................
17.1.4
Prerequisite External Data Source for Dynamic Choices............................................
17.1.5
Overview of Setting up Dynamic Choices in Decision Studio...................................
17.1.6
Creating the Dynamic Choice Data Source...................................................................
17.1.7
Creating the Single Dynamic Choice Entity .................................................................
17.1.8
Creating the Dynamic Choice Set Entity .....................................................................
17.1.9
Creating the Dynamic Choice Data Retrieval Function ............................................
17.1.10
Considerations for Choice Group Design ...................................................................
17.1.11
Creating a Single Category Choice Group ..................................................................
17.1.11.1
Group Attributes Tab..............................................................................................
17.1.11.2
Choice Attributes Tab .............................................................................................
17.1.11.3
Dynamic Choices Tab .............................................................................................
17.1.12
Creating a Multi-Category Choice Group...................................................................
17.1.12.1
Choice Attributes Tab in the Parent Choice Group............................................
17.1.12.2
Group Attributes Tab in the Child Choice Groups ............................................
17.1.12.3
Dynamic Choices Tab in the Child Choice Groups............................................
17.1.13
Dynamic Choice Reporting Overview.........................................................................
17.1.13.1
Applications with Static Choices Only.................................................................
17.1.13.2
Dynamic Choice Visibility......................................................................................
17.1.13.3
System-Created Range Folders..............................................................................
17.1.13.4
Distribution of Choices Across Decision Center Folders...................................
17.1.13.5
Example of a Decision Center Report with Dynamic Choices..........................
17.2
External Rules.........................................................................................................................
17.2.1
Introduction to External Rules .....................................................................................
17.2.2
External Rule Editor Components ...............................................................................
17.2.2.1
External Rule Editor and External Rule Editor Client .......................................
17.2.2.2
Oracle Web Service Manager (OWSM) ................................................................
17.2.2.3
Security......................................................................................................................
17.2.2.4
Workbench Web Services .......................................................................................
17.2.3
External Rule Editor Deployment Topologies............................................................
17.2.4
Steps to Create and Deploy the External Rule Editor ...............................................
17.2.4.1
Construct...................................................................................................................
17.2.4.2
Integrate ....................................................................................................................
17.2.4.3
Package...........................................