@o3r/rules-engine

Otter rules-engine

This package is an Otter Framework Module.

Description

This module provides a rules engine that can run on your user's browser to customize the (translations, [//]: # (Should we target placeholder or the component npmjs, and we add a section on the placeholder there?) placeholders and configurations) of your application at runtime.

The rules engine interprets a list of actions to execute based on the evaluation of Rulesets and their conditions. Conditions are logical expressions relying on operators and variables we call facts.

You can store your list of Rulesets on a static JSON file.

This mechanism allows you to bring UI personalization based on runtime events without the need of a backend service. This can be useful if you want to drive dynamic behavior.

For example, you could consider leveraging this feature to display assets based on the current season or for some special events, or to drive A/B testing on your components.

You will find more information on the concepts behind the rules engine in its dedicated documentation. For a demonstration of the rules engine capabilities, you can refer to the live example in the Otter showcase.

How to install

ng add @o3r/rules-engine

[!WARNING] This module requires @o3r/core to be installed.

How to use

The package exposes the RulesEngineRunnerService that can drive all the Otter customization-based services in order to personalize the user experience. On its own, the service will do nothing and will need action handlers to register with the list of supported actions and their implementation.

Not only this allows for a better extensibility of the service, but it also keeps the number of imported module to the bare minimum for a lighter application.

Find more information on the Otter rules engine documentation.

Examples

Several examples of the rules engine usage are available on the following links:

• Basic rule
• Rule with complex fact
• Rule with Nested Conditions
• Rule using runtime facts

Generators

Otter framework provides a set of code generators based on Angular schematics.

Schematics	Description	How to use
add	Include Otter rules-engine module in a library / application.	ng add @o3r/rules-engine
rules-engine-to-component	Add rules-engine to an Otter component	ng g rules-engine-to-component
facts-service	Generate a facts service	ng g facts-service
operators	Generate an operator	ng g operator

Debug

A whole section of the Otter Chrome Devtool extension is dedicated to the debug of the rules engine with a visual representation of your Rulesets and a history of the run, conditions met and actions applied.

Find more information on the tool in the Otter Chrome Devtool extension documentation and its dedicated section in the rules engine documentation.

External links

More details regarding the way the rules engine is working can be found in the documentation.
A live example is available in the Otter Showcase Application with reference to its code source.