Condition Participant Plugin

Introduction

The Condition Participant Plugin enables you to assign process participants dynamically using JavaScript conditions. It supports complex use cases by including hash variables and other custom conditions.

Plugin information

• Plugin Name: Condition Participant Plugin
• Category: Process Participant Mapping
• Download Plugin: Joget Marketplace
• Source Code: condition-participant.zip

Get started

Where to get the plugin

You can download the plugin from the Joget Marketplace.

How to install

1. Go to the Joget Marketplace and download the plugin (.jar file).
2. Log in to your Joget Workflow server as an admin.
3. Navigate to Admin Bar > System Settings > Manage Plugins.
4. Click on Upload Plugins, select the downloaded .jar file, and click Upload.
5. The plugin will be visible under the Installed Plugins tab once uploaded.
6. Uninstall any older versions before uploading a new one.

The Joget Workflow Knowledge Base has more information on managing and developing plugins.

How to use it

1. Start the Joget server and navigate to the App Center.
2. Log in as admin and click Design New App or select an existing application.
   
3. For a new app, fill in the App Details and save the form.
   
4. Create a new form, fill in the Form Details, and save it.
   
5. Generate an approval process app using the form builder's Generate App button.
6. In App Composer, click the newly created approval process to open it in Process Builder.
7. Click a participant to open Configure Mapping.
8. For Type, select Plugin in the drop-down list and for Plugin, select the Condition Participant plugin from the drop-down list.
   
9. Click Add for Participant under Condition Participant and fill in the javascript parameter with 1==1 because we want the script to always return true and the username element with cat because you want Cat Grant to approve every form submitted.
   Hash variables can also be used in the script element in order to satisfy more complex use cases. For example, we can use #currentUser.id#" == "admin" in the script element and Clark so that when the admin submits a form, Clark Kent will be assigned as the approver.
   
10. Click Apply Change.
11. Run a new process by clicking the Run Process button on the Processes page.
12. In this case, the approval process will be assigned to Cat Grant, and you can confirm this by checking the monitor. 

Configure condition participant properties

• Participant: 

  • JavaScript Condition: This is a mandatory field. The script element uses the Javascript condition to determine who will participate in the process. Hash variables are usable here. For example, you may key in values such as "#currentUser.id#" == "admin" so that when you run this process as the Admin, it will return as true, and the Username Field will determine the participant.

  • Username: The username of the participant. This is a mandatory field.

• Add: Adds additional participants.

• Debug Mode: Turn on debug mode to show the plugin details in the system log and find bugs in the script.

Download Plugin

• Download Condition Participant Plugin