Contents

Title and Copyright Information

Preface

• Audience
• Documentation Accessibility
• Related Documentation
• Conventions

1 Overview of Oracle Business Rules

• 1.1 Introduction to Oracle Business Rules
  • 1.1.1 What Are Business Rules?
  • 1.1.2 What Is a Data Model?
  • 1.1.3 What Is a Rule-Based System?
    • 1.1.3.1 Rule-Based Systems Using the Rete Algorithm
    • 1.1.3.2 Oracle Business Rules Rule-Based Systems
• 1.2 Oracle Business Rules Components
  • 1.2.1 Introducing Oracle Business Rules Rule Author
  • 1.2.2 Introducing Oracle Business Rules Rules SDK
  • 1.2.3 Introducing Oracle Business Rules RL Language
  • 1.2.4 Introducing Oracle Business Rules Rules Engine
• 1.3 Oracle Business Rules Rule Author Terms and Concepts
  • 1.3.1 Working with Rules
    • 1.3.1.1 Rule Conditions
    • 1.3.1.2 Rule Actions
  • 1.3.2 Working with Rule Sets
  • 1.3.3 Working with Repositories and Dictionaries
  • 1.3.4 Working with Facts
    • 1.3.4.1 Java Fact Type Definitions
    • 1.3.4.2 XML Fact Type Definitions
    • 1.3.4.3 Oracle Business Rules RL Language Fact Type Definitions
  • 1.3.5 Working with Functions Variables and Constraints
    • 1.3.5.1 Function Definitions
    • 1.3.5.2 Variable Definitions
    • 1.3.5.3 Constraint Definitions
• 1.4 Steps for Rule-Enabling a Java Application
  • 1.4.1 Identify Application Areas to Rule-Enable
  • 1.4.2 Provide Rule Author Definitions for the Data Model
  • 1.4.3 Develop a Business Vocabulary for the Data Model
  • 1.4.4 Write and Customize Rules
  • 1.4.5 Modify or Create Application Logic That Uses Oracle Rules Engine
  • 1.4.6 Test the Rule-Enabled Application

2 Getting Started with Rule Author

• 2.1 Creating a Rule Author User
• 2.2 Starting Rule Author
• 2.3 Rule Author Home Page
• 2.4 Creating and Saving a Dictionary for the Car Rental Sample
  • 2.4.1 Connecting to a Rule Author Repository
  • 2.4.2 Creating a Rule Author Dictionary
  • 2.4.3 Saving a Rule Author Dictionary with a Version
  • 2.4.4 Saving a Rule Author Dictionary
• 2.5 Defining a Data Model for the Car Rental Sample
  • 2.5.1 Using Java Objects as Facts in the Car Rental Sample
  • 2.5.2 Adding Java Classes and Packages to Rule Author
  • 2.5.3 Importing Java Classes to a Data Model
  • 2.5.4 Saving the Current State of Definitions
• 2.6 Defining the Business Vocabulary for the Car Rental Sample
  • 2.6.1 Specifying the Business Vocabulary for Java Fact Definitions
  • 2.6.2 Specifying the Business Vocabulary for Functions
  • 2.6.3 Specifying the Visibility for Properties and Methods
• 2.7 Defining a Rule for the Car Rental Sample
  • 2.7.1 Creating a Rule Set for the Car Rental Sample
  • 2.7.2 Creating a Rule for the Car Rental Sample
    • 2.7.2.1 Adding the UnderAge Rule for the Car Rental Sample
    • 2.7.2.2 Adding a Pattern to the UnderAge Rule
    • 2.7.2.3 Defining Tests for Patterns with the UnderAge Rule
    • 2.7.2.4 Adding Actions for the UnderAge Rule
• 2.8 Customizing Rules for the Car Rental Sample
• 2.9 Creating a Java Application Using Oracle Business Rules
  • 2.9.1 Importing the Rules SDK and Rules RL Language Classes
  • 2.9.2 Initializing the Repository with Rules SDK
  • 2.9.3 Loading a Dictionary with Rules SDK
  • 2.9.4 Specifying a Rule Set and Generating RL Language with Rules SDK
  • 2.9.5 Initializing and Executing a Rule Session
  • 2.9.6 Asserting Business Objects Within a Rule Session
  • 2.9.7 Using the Run Function with a Rule Session
• 2.10 Running the Car Rental Sample Using the Test Program

3 Working with Rule Author Features

• 3.1 Working with Variables
• 3.2 Working with Constraints
• 3.3 Working with RLFacts
• 3.4 Working with Functions
• 3.5 Working with Rules
• 3.6 Viewing Java Objects in a Data Model
  • 3.6.1 Specifying Visibility and Object Chaining for Rule Author Lists
• 3.7 Generating Oracle Business Rules RL Language Text
  • 3.7.1 Generating Viewing and Checking RL Language Text
• 3.8 Configuring Rule Author Dictionary Properties
  • 3.8.1 Using the Advanced Test Expression Option
  • 3.8.2 Using the Logging Option
• 3.9 Deleting a Rule Author Dictionary
• 3.10 Importing and Exporting a Dictionary
• 3.11 Working with Test Rulesets
• 3.12 Invoking Rules and Obtaining Rules Engine Results
  • 3.12.1 Overview of Results Examples
  • 3.12.2 Using a Global Variable to Obtain Results
  • 3.12.3 Using Container Objects to Obtain Results
  • 3.12.4 Using Reasoned On Objects to Obtain Results

4 Using XML Facts with Rule Author

• 4.1 Overview of Using XML Documents and Schemas with Rule Author
• 4.2 Creating a Rule Author User and Starting Rule Author
• 4.3 Creating and Saving a Dictionary for the XML Car Rental Sample
  • 4.3.1 Connecting to a Rule Author Repository
  • 4.3.2 Creating a Rule Author Dictionary
  • 4.3.3 Saving a Rule Author Dictionary with a Version
  • 4.3.4 Saving a Rule Author Dictionary
• 4.4 Defining a Data Model for the XML Car Rental Sample
  • 4.4.1 Using XML Schema as Facts in the XML Car Rental Sample
  • 4.4.2 Adding XML Facts for the Car Rental Sample (XML Schema Processing)
  • 4.4.3 Importing XML Schema Elements to a Data Model
  • 4.4.4 Viewing XML Facts in a Data Model
  • 4.4.5 Saving the Current State of XML Fact Definitions
• 4.5 Defining the Business Vocabulary for the XML Car Rental Sample
  • 4.5.1 Specifying the Business Vocabulary for XML Fact Definitions
  • 4.5.2 Specifying the Business Vocabulary for Functions
  • 4.5.3 Specifying the Visibility for Properties and Methods for XML Facts
• 4.6 Defining a Rule for the XML Car Rental Sample
  • 4.6.1 Creating a Rule Set for the XML Car Rental Sample
  • 4.6.2 Creating a Rule for the XML Car Rental Sample
    • 4.6.2.1 Adding the UnderAge Rule for the XML Car Rental Sample
    • 4.6.2.2 Adding a Pattern to the UnderAge Rule (XML)
    • 4.6.2.3 Defining Tests for Patterns with the Under Age Rule (XML)
    • 4.6.2.4 Adding Actions for the UnderAge Rule (XML)
• 4.7 Customizing Rules for the XML Car Rental Sample
• 4.8 Creating a Java Application with a Rule Session Using XML Facts
  • 4.8.1 Importing the Rules SDK and Rules RL Classes
  • 4.8.2 Creating a JAXB Context and Unmarshalling the XML Document
  • 4.8.3 Initialize the Repository with Rules SDK
  • 4.8.4 Loading A Dictionary with Rules SDK
  • 4.8.5 Loading a RuleSet and Generating RL Language for a Data Model and Rule Set
  • 4.8.6 Initializing and Executing a Rule Session
  • 4.8.7 Asserting XML Data from Within a Rule Session
  • 4.8.8 Using the Run Function with a Rule Session
• 4.9 Running the XML Car Rental Sample Using the Test Program

5 Using JSR-94

• 5.1 Oracle Business Rules with JSR-94 Rule Execution Sets
  • 5.1.1 Creating a JSR-94 Rule Execution Set from Rule Sets in a File Repository
  • 5.1.2 Creating a JSR-94 Rule Execution Set from a WebDAV Repository
  • 5.1.3 Creating a Rule Execution Set from Oracle Business Rules RL Language Text
  • 5.1.4 Creating a Rule Execution Set from RL Language Text Specified in a URL
  • 5.1.5 Creating Rule Execution Sets with Rule Sets from Multiple Sources
• 5.2 Using the JSR-94 Interface with Oracle Business Rules
  • 5.2.1 Creating a Rule Execution Set with CreateRuleExecutionSet
  • 5.2.2 Creating a Rule Session with createRuleSession
  • 5.2.3 Working with JSR-94 Metadata
  • 5.2.4 Using Oracle Business Rules JSR-94 Extensions
    • 5.2.4.1 Using the Extended createRuleExecutionSet to Create a Rule Execution Set
    • 5.2.4.2 Invoking an RL Language Function in JSR-94

6 Using Oracle Business Rules SDK

• 6.1 Rules SDK Building Blocks
• 6.2 Working with a Repository and a Dictionary
  • 6.2.1 Establishing Contact with a WebDAV Repository
  • 6.2.2 Establishing Contact with a File Repository
  • 6.2.3 Loading a Dictionary
• 6.3 Working with a Data Model
  • 6.3.1 Creating a Data Model
  • 6.3.2 Creating Data Model Components
  • 6.3.3 Creating a Function Argument List
  • 6.3.4 Creating an Initializing Expression
  • 6.3.5 Creating RL Function Bodies
• 6.4 Using Rule Sets and Creating and Modifying Rules
  • 6.4.1 Creating a Rule Set
  • 6.4.2 Adding a Rule to a Rule Set
  • 6.4.3 Adding a Pattern to a Rule
  • 6.4.4 Adding a Test to a Pattern
  • 6.4.5 Adding an Action to a Rule
  • 6.4.6 Notes for Adding RuleSets and Rules

A Oracle Business Rules Files and Limitations

• A.1 Rule Author Naming Conventions
  • A.1.1 Rule Set Naming
  • A.1.2 Dictionary Naming
  • A.1.3 Version Naming
  • A.1.4 Alias Naming
  • A.1.5 XML Schema Target Package Naming
• A.2 Rule Author Session Timeout
• A.3 Rules SDK and Rule Author Temporary Files

B Using Rule Author and Rules SDK with Repositories

• B.1 Working with a WebDAV Repository
  • B.1.1 Setting up a WebDAV Repository
  • B.1.2 Connecting to a WebDAV Repository
  • B.1.3 Connecting to a WebDav Repository Using a Proxy
• B.2 WebDAV Repository Security
  • B.2.1 Communicating with a WebDAV Repository Over SSL from Rule Author
  • B.2.2 Setting the Location of Your Oracle Wallet
  • B.2.3 Configuring Rule Author for WebDAV Repository Authentication
  • B.2.4 Storing Data in an Oracle Wallet for WebDAV Repository Authentication
• B.3 Working with a File Repository
  • B.3.1 Setting up a File Repository
  • B.3.2 File Repository Updates and Temporary Files
• B.4 High Availability for your Repository

C Oracle Business Rules Frequently Asked Questions

• C.1 Frequently Asked Questions About Rules Operations
  • C.1.1 Why is the State of a Fact in a Rule Action Inconsistent with the Rule Condition?
  • C.1.2 A Changed Java Object was Asserted as a Fact, but no Rules Fired. Why?
  • C.1.3 What are the Differences Between Oracle Business Rules RL Language and Java?
  • C.1.4 How Do I Use Rules SDK to Include a null in an Expression
• C.2 What JAR Files are Required for Working with Oracle Business Rules?
• C.3 How do I Deploy Rule Author on Non-Oracle Containers?
  • C.3.1 Deploying Rule Author on WebSphere V6.1 (WAS V6.1)
  • C.3.2 Deploying Rule Author on WebLogic Server
  • C.3.3 Deploying Rule Author on JBoss 4.0
• C.4 How Does a RuleSession Handle Concurrency and Synchronization?
• C.5 How Do I Improve Oracle Business Rules Runtime Performance?
• C.6 How Do I Correctly Use an RL Language Cross Product?
• C.7 How Do I Access a Rule in a Dictionary Using a URL?
• C.8 How Do I Use a Property Change Listener in Oracle Business Rules?
• C.9 How Do I Modify the Single Sign-On Timeout for Oracle Application Server?
• C.10 Does Oracle Business Rules Provide High Availability?

D Oracle Business Rules Troubleshooting

• D.1 Public Fact Variables are not Accessible with Rule Author
• D.2 Global Variables may not be Used in RL Functions
• D.3 Importing JDK 1.4.2 Classes
• D.4 Managing Popup Windows on Firefox
• D.5 Using the String Data Type with Methods
• D.6 Preserving Class Order and Hierarchies in the Data Model
• D.7 Validating and Checking Generated RL from Rule Author
• D.8 Using RL Reserved Words as Part of a Java Package Name
• D.9 Getter and Setter Methods are not Visible
• D.10 XML Facts not Asserted at Runtime
• D.11 Changing Language When Using Rule Author
• D.12 Why Do I Get a File Error When Simultaneously Editing and Executing a Ruleset Under Microsoft Windows?
• D.13 Why are Ancestor Methods not Visible from Sub-Classes
• D.14 Adding an XML Schema Results in Error RUL-01627
• D.15 Choice List with Client and Server Using Different Locale Generates Invalid RL Language
• D.16 Invalid RL Language Generated When Inherited Classes are Used

Index