Workflow: Configuration and Customization

This section covers various configuration aspects for Reltio Workflow, from enabling the feature in Reltio UI to configuring specific settings. Information for Workflow administrators and developers includes:

Workflow configuration
Workflow customization
Workflow deployment

Note:

Starting with Reltio Cloud 2017.2, there is an important change to the changeRequestTypes in the tenant-level configuration (sometimes called the L3). The lifecycleActions section of this configuration must be removed.

For example:

"changeRequestTypes": [
    {
      "uri": "configuration/changeRequestTypes/default",
      "lifecycleActions": {
        "afterDCRSave": [
          "Reltio/WorkflowDCRService"
        ]
      }
    }
  ],

should be changed to just:

"changeRequestTypes": [
    {
      "uri": "configuration/changeRequestTypes/default",
    }
  ],

Prerequisites

In order to create custom workflow processes, there are some software requirements. Reltio uses the Activiti Designer workflow engine. In order to create workflow processes, one needs to use the Activiti Designer plugin in the Java IDE Eclipse. If you do not have Eclipse, you can download from eclipse.org website. Once Eclipse has been installed, you need to add the Activiti Designer Plugin for Eclipse. This will allow you to use the drag-and-drop design tools to create a new process.

Note: See also: Alfresco Documentation reference

Configuration environment

Before you start configuring workflows, you need to set up Acitviti-based workflow configuration environment. Make sure you have completed the following steps:

Download and install Activiti Designer plugin for your Eclipse IDE.
Create an Activiti diagram file (*.bpmn) using Eclipse.

Note: You will need to export (see Exporting Workflow diagram) this diagram to a file and apply specific naming before deploying your workflow configuration to Reltio environment. For information about deployment, refer to the Workflow Configuration Guide.

Enable Workflow

To enable Workflow functionality in a tenant:

Register the tenant to Workflow.
Note: For details refer to the Register tenants operation of the Workflow API.
Enable Workflow for the tenant in UI configuration.
Configure users and permissions. The tenant ID must be assigned to every user account that should be able to see Workflow. This can be done in the settings screen of the tenant. Once these steps are completed, the user should login to the tenant again.

For Data Change Request Review, users must be given certain roles to either be able to initiate data change requests or review data change requests. In order to make suggestions a user needs the following permissions/roles:

ROLE_INITIATE_CHANGE_REQUEST
ROLE_WORKFLOW
ROLE_API

To review (possible assignee list, approve or reject the workflow task and see the workflow in the UI) a Data Change Request Review task, a user needs the following permissions and roles:

ROLE_WORKFLOW
ROLE_API
ROLE_REVIEWER (for OOTB DCR review process) or the role from candidateGroups in BPMN role with CRUD+MERGE+ACCEPT_CHANGE_REQUEST permissions

Note: Reltio recommends that you do not use any permissions in ROLE_REVIEWER and be more flexible if you need to split your Data Stewards by some rules. For example, Data Stewards from Italy should get to review only DCR review tasks with country code Italy and use data permissions for another role with CRUD+MERGE+ACCEPT_CHANGE_REQUEST permissions.

The following specific roles and permissions need to be applied:

[{
    "role":"ROLE_INITIATE_CHANGE_REQUEST",
    "access":[
        "READ",
        "INITIATE_CHANGE_REQUEST"
    ]
},
{
    "role":"ROLE_READ",
    "access":[
        "READ"
    ]
},
{
    "role":"ROLE_REVIEWER",
    "access":[
        "CREATE",
        "READ",
        "UPDATE",
        "DELETE",
        "MERGE",
        "ACCEPT_CHANGE_REQUEST"
    ]
},
{
    "role":"ROLE_UI_ALL",
    "access":[
        "CREATE",
        "READ",
        "UPDATE",
        "DELETE",
        "MERGE"
    ]
}]