The Add comment post function automatically creates a comment in the current, parent or any issue(s) returned by a parser expression. The comment text can be composed of free text in combination with field codes or functions provided by the selected parsing mode.
The comment author can be selected among various user fields and the visibility can be restricted by project role or by user group.
Select the issue the comment will be added to. 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 or an issue list. The comment will be added to every issue in the given issue list.
Enter the comment's text that will be created. You can enrich the styling of your comment by using the avaible markdowns.
If you would like to mention a user, you can use a markdown like the following
Select the user that will be used to execute the post function. By default, it is set to the current user that executes the transition.
The configured user must have all necessary permissions to create the comment in the target issue.
Select the comment visibility.
- Unrestricted (all users)
- Restricted to Project Role
- Restricted to Group
If the comment should be restricted, the configured comment auther must be a member of the in the configured role or group.
The result of the logical expression must return a boolean value of either:
true→ the post function will be executed
false→ 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
|Use case||Type||Function||Use case description||Complexity|
|Add comment when rejecting an issue||Add comment|
When an issue is rejected, a comment will be added to the current issue mentioning the reporter.
|Alert the assignee of important issues|
Add a comment to an issue mentioning the assignee.
The comment will only be added, if the issue priority is set to "High" or "Highest" to ensure that the assignee will only be alerted for the important issue
|Alert the reporter|
Add a simple comment to an issue mentioning the reporter.
This use case might come in handy if you don't want to use extra events in your notification schemes to notify specific users - like the reporter.
|Push status updates to the linked Epic||Add comment|
Add a comment to the linked Epic including the summary and status of the current issue.
This is helpful when you don't want to keep track of individual Stories and only receive notifications of the linked Epic (e.g. as a watcher or reporter).
|Push status updates to the parent||Add comment|
Add a comment to the parent issue including the summary and status of the current issue.
This is helpful when you don't want to keep track of individual sub-tasks and only receive notifications of the parent issue (e.g. as a watcher or reporter).