...
Javascript Conditional Participant is a plugin that lets you control which user is going to participate in a process with more complex use cases because
it allows different type of conditions which include hash variables and so on.
Get started
The easiest way to see how the Javascript Conditional Participant plugin is to create a process first. Here are the steps:
| Steps | Screens (Click To View) |
|---|
Steps To Import This Plugin- Go to the website https://marketplace.joget.org/jw/web/userview/mp/mpp/_/vad?id=imgDatalistFormatter
- Click "Download" on this plugin screen (It will be a .jar file).
- Go to your Joget Workflow localhost or server and login as admin.
- In Joget Console navigate to "Admin Bar>Systems Settings>Manage Plugins" and click "Upload Plugins" button.
- In "Upload Plugin", select the plugin .jar file you just downloaded, then click "Upload".
- You should be able to view the newly installed plugin under the Installed Plugins tab.
- This plugin type will show up when you map participants to users.
- Remember to always uninstall the old plugin before uploading a new version.
- The Joget Workflow Knowledge Base has more information on managing and developing plugins.
Steps to use the Plugin- Start the Joget server and open the App Centre.
- Login as admin and click on Design New App (See Figure 1) or click on existing application.
- For new application, fill up the App Details and click on Save button. (See Figure 2)
- Create New Form, fill up Form Details and click on Save button. (See Figure 3)
- Create a new Datalist Process or select an existing Datalist Process in your application.
- Select the desired Form in the Source Search for the Map Participants to Users tab.Go to the Design tab and insert the desired Columns/Filters.
- Click on the Add/Edit Mapping button.
- Select the Map to Plugin tab and search for the Javascript Conditional Participant plugin.
- For example purposes, fill up the script element with 1==1 and the username as cat so that it will return as true and the user who will be participating will be Cat Grant.
- In this case, whichever activity that is involved with the participant we have configured will be assigned to Cat GrantEdit the column properties in Datalist Builder. (See Figure 4)
Click to the "Formatter" tab and select option "Image Datalist Formatter".
Click on the next button and select the relevant "Form".
Click on Preview button to see the expected outcome. (See Figure 5)
Click on the save button.
| 
Figure 1 
Figure 2 
Figure 3 
Figure 4 
Figure 5 |
...
Javascript Conditional Participant Properties
General
| Name | Description | Screen ( Click to view) | Name | Name of Datalist. | 
Image Removed
|---|
| Script* | The script element to determine who will participate in the process. Hash variables are usable here | Label* | Label Datalist. This is a mandatory field. | |
| SortableUsername* | Allow Datalist to be arrangedThe username of the participant. This is a mandatory mandatory field. |
| Render value as HTML | Allow value to be provided as HTML. |
| Hidden* | Allow Datalist to be hidden. This is a mandatory field. |
| Exclude in export? | Allow Datalist to be excluded in export. |
| Width | Width of the Datalist. |
Inline Style | Allow user to change the inline style. |
| Alignment | Determine the type of Header. |
| Header Alignment | Determine the type of Header Alignment. |
Action Mapping
...
...
Image Removed
| Debug Mode | Turn on the debug mode to show the plugin details in the system log to find bugs for the script |
Formatter
...
Determine which type of formatter to be used.
...
Image Removed
Image Datalist Formatter Properties
| Name | Description | Screen (Click to view) |
|---|
| Form | Determine which form to display image. |  Image Removed
|
| Click on image to view full size? | Allow user to enlarge the image when clicked. |
| Height | Height of the image. |
Width | Width of the image