Map Participants to Users

Mapping participants to users or groups in Joget Workflow ensures efficient assignment of tasks and responsibilities within process flows. This section provides an overview of the options available for configuring participant mappings.

Participants declared in the Joget Process Designer can be mapped to specific users, groups, and departments or dynamically determined based on workflow variables or plugins. These mappings control who performs specific activities within the workflow, optimizing task allocation and process efficiency.

Key feature

The primary functionality for mapping participants to users within Joget is:

• Process Start White List: Defines who can initiate the process. Anyone can start the process by default, but this feature restricts it to designated users or groups configured in the mapping.

Mapping options

The Mapping Options details the various methods available for assigning participants to users:

• Map to User or Group: Assigns participants directly to selected users or groups. When activities are created within the participant's swimlane, Joget automatically assigns these users as assignees.
  
  Inactive User
  If the user mapped is inactive at the time of assignment is made, remember to delegate, re-assign, or change mapping and re-evaluate the assignment.
  No valid user found?
  If no valid user is found to be assigned when the assignment is made, the activity will be assigned to the currently logged-in user (previous performer).
• Map to Department or Head of Department: Assigns participants based on departmental hierarchy. Activities mapped to departments or heads of departments automatically assign tasks to users within those departments.
  
  
  
• Map to Performer: Dynamically assigns participants based on the performers in the process flow. For example, we are trying to determine the participant that will be approving a claim. The person to approve a claim will be the HOD of the person who submitted the claim. Therefore, the setting would be the Performer's HOD, where the performer executed the Submit Claim.
  
• Map to Workflow Variable: The workflow variable can also be used to determine a participant. This is particularly useful when the participant is decided on the fly in the preceding activity with the value set into the Workflow Variable. If the variable value contains a username, then the option to be set here would be Username with the correct Variable ID picked.
  
  
• Map to Plugin: Uses participant plugins such as Bean Shell to programmatically determine participants based on custom logic or conditions defined in the plugin.
  

Bean Shell for process participant

This plugin allows you to write your script to gather the assignee(s) needed. A participant-type plugin should return a collection of usernames. See examples at Bean Shell Programming Guide | Use as Process Participant.

Related documentation

Additional resources to deepen understanding and expand capabilities in mapping participants to users within Joget:

• Advanced Participant Mapping
• Participant Mapping - Assign to User in Group with the least assignments