This article relates to BPMN 2.0 process. Looking for the BPMN 1.0 article? Click here!

The role mapper is a feature on Barium Live designed to use form data to assign task permissions to a specific user. By using a Value list you can assign which value shall correspond with which user/group.

For example, you have a process that looks like this:

In the step called Review work order the performer can choose to send the request to a specific department. By using a Role Mapper you filter the possible performers according to a drop down list in your form and only the performers in this role connected to the chosen value in the drop down gets the upcoming tasks.

How to create and set a Role Mapper as participant

To set up your Role mapper you first need to create a Value list. This list contains the values of the drop down to wish you will map users and groups.

1. Go to Space administration and select Role mapper in the left hand menu.

2. Click Add new.

3. Fill in the name and description of the Role Mapper. In the field Value list you choose which of your lists you want to use to map users and groups to its values. In the last field Default account set a default user wish will receive the task in case the role mapper cannot find a user mapped to a value.

4. In the next step you select which group or user shall correspond to which values. Click the empty field to the right of the value. Start typing the name of the user or group to add it to the role mapper. In the picture below, three groups of users have been mapped to three different values and the fourth value is mapped to a user.

5. Now you need to add your value list to a form connected to the application. Open the form editor and drag and drop the field from the folder called Metadata Fields in the Toolbox.
Don't forget to save the form.

6. Deploy your application and map your created Role Mapper to the role which the mapped group or user should be assigned.

When to use Role Mappers

Use Role Mappers when you want to set performers depending on a chosen value in a form field. For an example when you want to send the upcoming tasks to all the electricians if in the incoming support question form the question area is chosen to be in the electrician area.

You can also use Role Mappers together with Assign Roles, then the performers possible to choose can be filtered depending on a chosen value in a form field.