This post function automatically executes a specific transition on the selected issues or transitions issues to a selected status.
It is the preferred way of executing transitions. However, in some cases, e.g. the automatic transitioning of newly created issues using the Create issue post function, users might want to use the following alternative field codes:
Select the issue(s) to be transitioned. The following options are available:
|Current issue||The current issue will be transitioned.|
|Parent issue||The current issue's parent will be transitioned.|
|Sub-tasks||The current issue's sub-tasks will be transitioned. If you choose this option you can further filter your selection (e.g. by issue type or status). Only useful for standard issues.|
|Sibling sub-tasks||The current issue's sibling sub-tasks will be transitioned. Only useful if the current issue is a sub-task.|
|Linked issues||Linked issues will be transitioned. If you choose this option you can further filter your selection (e.g. by issue type or status).|
|Linked epic||The related epic will be transitioned.|
|Issues under epic||All issues related to the same epic will be transitioned. If you choose this option you can further filter your selection (e.g. by issue type or status).|
|Sibling issues under epic||All sibling issues related to the same epic will be transitioned. If you choose this option you can further filter your selection (e.g. by issue type or status).|
|Set target issue manually (parser expression)|
Define the issues that will be transitioned by defining an expression. The JQL mode and Issue list mode are available.
The expression must return either a valid JQL expression or an issue list with issue keys.
Select the transition to be executed or the status to be transitioned to. The following options are available:
Either select an existing transition from any available workflow or set the transition manually using a parser expression in Basic text mode.
The expression must return a transition name.
|Transition to status|
Either select an existing status from any available workflow or set the status manually using a parser expression in Basic text mode.
The expression must return a status name.
If more than one transition is available to reach the configured status, the first transition (found by Jira) will be executed.
Both, transition or target status, have to be available from the issues' current status. The provided list, however, contains all statuses and transitions in the system.
Choose between the following options (multi choice is possible):
Existing conditions in the transitions to be executed will be ignored.
Existing validators in the transitions to be executed will be ignored.
Ignore project permissions
|The "Transition Issues" project permission will be ignored for the user running this post function.|
The execution of this post function will be delayed by the value specified in milliseconds.
This parameter is useful, when multiple operations have to be performed in a single transition. The delayed execution ensures that all previous operations have been completed, e.g. field values that are referenced in this post function are present.
The maximum delay is 60,000 milliseconds (60 seconds).
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
Make sure that the user running the post function has all the relevant permissions to perform the actions defined in the configuration (e.g. "Update Issues")!
If you want to keep track the actions being performed automatically, we suggest to create a dedicated JWT account, granted all relevant permissions, and use it in the Run as parameter to identify which changes have been made with JWT.
Use cases and examples
|Use case||JWT feature||Workflow function||Parser functions||Label|
|Fast-track transition issues assigned to the project lead||Transition issue|
|Keep the status of an issue and its linked issues in sync|
|Keep the status of parents and sub-tasks in sync (post function use case)||Transition issue|
|Reopen parent issue, if a sub-task is reopened|
|Start Progress on parent, if sub-tasks are started|