This post function is used to update one or multiple issue fields in linked issues or sub-tasks.
By default, only linked issues will be updated.
If you want to also update (sibling) sub-tasks, the specific checkbox in the "Additional options" section has to be checked.
⚒️ Configuration
Fields
Every supported field can either be set or cleared.
After selecting a field and clicking the Add button, you can select in the popup how to set the value. There are three or - when dealing with selectable fields - four options:
-
Copy field from current issue
-
Clear field value
-
Set field value manually - Read more about the JWT expression editor
-
The option Selected value is available for the following fields types:
-
Jira Software related fields like Sprint or Epic
-
User related fields like Assignee or Reporter
-
Version related fields like Affects- or Fix version/s
-
Component/s
-
Labels
-
Priority
-
Resolution
-
Security level
-
and all option based custom fields that are supported
-
Filter
Use any of the following filters to refine which issues will be updated.
Filter by project
Filter your project by choosing from one of the following options:
|
Option |
Description |
|---|---|
|
Any project |
This is the default. If selected, the projects the linked issues belong to do not matter. |
|
Current project |
If selected, only linked issues which belong to the same project as the current issue will be updated. |
|
Any but current project |
If selected, only linked issues which do not belong to the same project as the current issue will be updated. |
Filter by link type
Only issues linked to the current issue by the selected link types will be updated. This field is required.
Filter by issue type
Optionally limit the issues to be updated by their issue type.
Filter by status
Optionally limit the issues to be updated by their status.
Filter by field value
Optionally limit the issues to be updated by their field values. To achieve this you must enter an expression in Logical mode. The expression must return true or false.
|
Examples |
|
|---|---|
|
Expression |
Description |
|
Bash
|
This expression ensures that unassigned issues will not be updated. Values in linked issues or sub-tasks have to be referenced by their seed field codes.
|
|
Bash
|
This expression ensures that the due date of the linked issues is equal or later than current issue's due date. Values in linked issues or sub-tasks have to be referenced by their seed field codes.
|
The single filters are AND concatenated. In order for the operation to be successful and update the issues all filter criteria must be met.
Additional options
The following options are available:
|
Option |
Description |
|---|---|
|
Update sub-tasks matching the specified filter criteria |
Check this option if you also want to update sub-tasks matching the specified filter criteria. This option only makes sense when the current issue itself is not a sub-task. |
|
Update sibling sub-tasks matching the specified filter criteria |
Check this option if you also want to update sibling sub-tasks matching the specified filter criteria. This option only makes sense when the current issue itself is a sub-task. |
Run as
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 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 edit the target issue. When using the Jira Workflow Toolbox app user , this requirement is always fulfilled, as the App user has the required permissions.
Additionally, using the Jira Workflow Toolbox app user makes it possible to set or update fields even if they are not present on the screen. The Jira Workflow Toolbox app user can also modify issues that are normally restricted from editing.
Conditional execution
You can optionally specify a logical expression or a Jira expression depending on the chosen Parsing mode to define the circumstances (or conditions) under which the post function should be executed.
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 | JWT feature | Workflow function | Use case description |
|---|---|---|---|
| Update the sub-task's assignees by the current issue's value |
|
Update the sub-task's assignee from its parent | |
| Set the fix version from the current sub-task for all sibling sub-tasks |
|
Update the fix version of all sibling sub-tasks from the current issue . | |
| Copy the due date from the current issue to blocking issues |
|
Copy the due date value from the current issue to blocking issues . |