This post function allows users to add/remove watchers to/from the current, parent, selected or any issue returned by a parser expression. The list of watchers to be added or removed can be configured.
You can retrieve the users from either an existing field, project role, or group.
Configuration
Select the issue to add or remove watchers. The following options are available:
- Current issue
- Parent issue
- Selected issue
- Parser expression
When the option parser expression is selected, an expression parser input field is displayed and the input has to be an issue key . The watchers will be added or removed to the issue specified by the given issue key.
The mode parameter defines how you want to retrieve the users to be added or removed as watchers. The following modes are available:
Option | Description |
---|---|
Add users from a field | You will be presented with a dynamic selection, containing available fields (or field codes) where the user(s) should be retrieved from. If you select a text field, the output must contain a single user name or a comma separated Atlassian account IDs, group names or project role names |
Add members of a project role | You will be presented with a dynamic selection, containing available project roles. All users from the selected project role (in the current project) will be added as watchers. |
Add members of a group | You will be presented with a dynamic selection, containing available groups. All users from the selected group will be added as watchers. |
Remove users from a field | You will be presented with a dynamic selection, containing available fields (or field codes) where the user(s) should be retrieved from. If you select a text field, the output must contain a single user name or a comma separated list of user names, group names or project role names |
Remove members of a project role | You will be presented with a dynamic selection, containing available project roles. All users from the selected project role (in the current project) will be removed as watchers. |
Remove members of a group | You will be presented with a dynamic selection, containing available groups. All users from the selected group will be removed as watchers. |
Remove all watchers | Check this option to remove all watchers from the current issue. |
The following options are available:
Option | Description |
---|---|
Selected user | Select a specific Jira user. |
User in field | Select the field containing the user that will be used to execute the post function. |
The configured user must have all necessary permissions to add or remove watchers in the target issue.
The result of the logical expression must return a boolean value of either:
true
→ the post function will be executedfalse
→ the post function will not be executed
Using the conditional operator, even complex or multi-layered conditions can be constructed.
Make sure to learn more about defining logical expressions and browse through the various examples here: Logical mode
Use cases and examples
If you still have questions, feel free to refer to our support team.