Toolkit com.ibm.streams.rules 2.0.0

SPL standard and specialized toolkits > com.ibm.streams.rules 2.0.0

General Information

The Rules Toolkit integrates IBM Operational Decision Manager (ODM) with IBM InfoSphere Streams to run business rules that are created in ODM.

ODM developers and business analysts create business rules, construct rule flows, and create and deploy rules applications in ODM. The ODMRulesetExecutor operator in the Rules Toolkit applies these rules on streaming data to analyze data and automate decisions in real time.

The ODMRulesetExecutor operator maps tuples to input parameters that are used as an input for executing the deployed rules. The operator passes these parameters to the ODM rule engine, which executes the rules and sends a response object that contains the results to the operator. The operator converts the output parameters to tuples.

Developing and running applications that use the Rules Toolkit

To create applications that use the Rules Toolkit operator, you must configure either IBM InfoSphere Streams or the SPL compiler to be aware of the location of the toolkit.

Data type conversions between ODM and InfoSphere Streams

If the ruleset parameters are Java primitive types, the ODMRulesetExecutor operator maps tuples on the input port to ruleset input parameters and after the rules are executed, the operator maps output parameters to output tuples.

Handling user-defined data types for ruleset parameters

For ruleset parameters that use primitive Java data types, the ODMRulesetExecutor operator automatically maps the attributes in an input tuple to ruleset input parameter and maps ruleset output parameters to attributes in an output tuple.

Customizing the output port for the ODMRulesetExecutor operator

By default, the ODMRulesetExecutor operator assumes it has one output port and an optional error output port.

Running rulesets that are deployed to a file system

When an IBM Operational Decision Manager (ODM) developer deploys a rules application to a file system, by default, the rulesets in the application are deployed to the res_data directory.

Running rulesets that are deployed to a database

When an IBM Operational Decision Manager (ODM) developer deploys a rules application to a database, the rulesets in the rules application are deployed as tables in the database.

Running the refreshed rulesets

If a deployed ruleset is updated, the ODMRulesetExecutor operator provides the capability to run the updated rules without restarting or recompiling the SPL application or refreshing the InfoSphere Streams instance.

Version

2.0.0

Required Product Version

4.0.0.0

Indexes

Namespaces

Operators

Namespaces

com.ibm.streams.rules.odm

Operators

• ODMRulesetExecutor