Apache Unomi high level overview

March 16, 2022


Apache Unomi documentation is available from Apache Unomi’s website where you can find the full documentation reference, the Javadoc and REST API documentation.



When receiving events, Unomi is able, via its rule engine, to trigger a various set of actions when matching a predefined condition. 

At its simplest, a condition is a JSON object composed of a type and a set of parameters:

"condition": {
    "type": "eventPropertyCondition",
    "parameterValues" : {
        "propertyName" : "target.itemType",
        "comparisonOperator" : "equals",
        "propertyValue" : "interest"

Apache Unomi ships with a set of predefined types and can be extended with more if needed. Conditions can also be composed using “AND”, “OR” or “NOT” operators to meet a wide variety of use cases. 

You can learn more about Unomi conditions here.

Declare actions in Groovy 

Provided as an alternative to developing OSGI module defining actions, simple actions can be developed in Groovy and be added via a dedicated REST endpoint.

Import and export profiles

The profile import and export feature in Apache Unomi is based on configurations and consumes or produces CSV files that contain profiles to be imported and exported.

More details can be found here.

For information on importing and exporting profiles in jExperience, see Profiles imports and exports.