Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Panel

On this page

Table of Contents
exclude(On this page).*
stylecircle
typeflat
separatorPipe

UI Text Box
sizemedium
typeinfo

The Add or remove watchers post This post function allows users to be added or removed from the current issue's watchers list. This post function uses fields, user groups, or project roles user selection tools.

You can retrieve the users from either an existing fieldproject role, or group.


Image AddedConfiguration

UI Expand
titleMode

The mode parameter defines how you want to retrieve the users to be added or removed as watchers. The following modes are available:

OptionDescription
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. 

UI Text Box
typenote
If used in the Create Issue transition, make sure that the post function is triggered after the Creates the issue initially post function.

UI Text Box
type
note

In this documentation and the post function configuration you will notice the symbol ( * ) next to some parameters, it means that this field is mandatory and shall not be left empty. Fields without the symbol are optional.

Basic configuration*

Below you will find a detailed description of each parameter of the basic configuration of the function.

Mode*

Info

Define the content of the comment by selecting one of the following modes:

  • Add users from a field
  • Add users from a project role
  • Add users from a group
  • Remove users from a field
  • Remove users from a project role
  • Remove users from a group
  • Remove all watchers

Group*

info

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


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. 

UI Text Box
typeinfo

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 watchersCheck this option to remove all watchers from the current issue.


UI Text Box
typeinfo

If you need to add or remove watchers from multiple groups or project roles, you need to configure additional post functions

Info
Select the group containing the users

.



Enter a condition (Logical/boolean condition) using the JWT expression parser - full feature list syntax.

You can even logically link and gather conditions in expressions as you like in order to map more complex conditions.

The post function will only be executed if the condition is met (returns true).
UI Expand
iconfalse
titleConditional execution
Note

Include Page
DECADIS:_snip_condExecution_Server
DECADIS:_snip_condExecution_Server


UI Text Box
typenote

If used in the Create Issue transition, make sure that the post function is triggered after the "Creates the issue initially" post function.



Image AddedUse cases and examples

Page properties report
firstcolumnUse case
headingsJWT feature, Workflow function, Parser functions, Label
cqllabel = "use-case-workflow" and ancestor = currentContent()


Excerpt Include
DECADIS:Contact support
DECADIS:Contact support
nopaneltrue


Page properties
hiddentrue


Tech review

Status
colourGreen
titledone

Style guide

Status
colourGreen
titledone

Status
titletodo
Status
colourYellow
titleReady for review
Status
colourGreen
titledone
Status
colourRed
titleflagged


Page properties
hiddentrue


Short descriptionAdd or remove watchers based on field values, project roles or groups. 
Label