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 Transition issue This post function automatically executes a specific transition on the selected issue issues or transitions the issueissues to a selected status. Both, transition and target status, have to be available from the issue's current 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:


Image AddedConfiguration

UI Expand
titleTarget issue

Select the issue(s) to be transitioned. The

UI Text Box
typenote

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.

Image RemovedBasic configuration*

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

Target issue*

Info
iconfalse

Select the issue to be transitioned, the following options are available:

OptionDescription
Current issueThe current issue will be transitioned.
Parent issueThe current issue's parent will be transitioned.
Sub-tasksThe 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-tasksThe current issue's sibling sub-tasks will be transitioned. Only useful if the current issue is a sub-task
Linked issuesLinked issues will be transitioned. If you choose this option you can further filter your selection (e.g. by issue type or status). 
Linked epicThe related epic will be transitioned.
Issues under epicAll 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 epicAll 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)
Expand
titlemore info...

(info) the input has to be an issue key

Mode*

Define the issues that will be transitioned by defining an expression. The JQL mode and Issue list mode are available.

UI Text Box
typenote

The expression must return either a valid JQL expression or an issue list with issue keys.




Pick either a status which is shown by name or a parser expression ((info) expects a status ID).
UI Expand
titleMode
Info
iconfalse

Select the transition to be executed or the status to be transitioned to. The following options are available:

Transition to status

Expand
titlemore info...
OptionDescription
Execute transition
Expand
titlemore info...

Pick either a transition which is shown by name and ordered by workflows or a parser expression ((info) expects a transition ID)

Either select an existing transition from any available workflow or set the transition manually using a parser expression in Basic text mode.

UI Text Box
typeinfo

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.

UI Text Box
typeinfo

The expression must return a status name.

If more than one transition is available to reach the configured status, the first transition (found

transition

by Jira) will be executed.


Additional options



UI Text Box
typetip

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.



UI Expandinfo
iconfalse
titleAdditional options

Choose between the following options (multi choice is possible):

Option
 
Description
Ignore conditions
  •  Ignore validators
  •  Ignore project permissions
  •  Delayed execution : The execution of this post function will be delayed by the value specified in milliseconds.

Conditional execution

Existing conditions in the transitions to be executed will be ignored.

Ignore validators

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.
Delayed execution

Include Page
DECADIS:_snip_delayed_execution
DECADIS:_snip_delayed_execution



UI Expand
iconfalse
titleConditional execution

Include Page
DECADIS:_snip_condExecution_Server
DECADIS:_snip_condExecution_Server


The post function will only be executed if the condition is met (returns true .).

UI Expand
iconfalse
titleRun as

Include Page
DECADIS:_snip_runAs_Server_postFunction
DECADIS:_snip_runAs_Server_postFunction

Info
iconfalse

Enter a condition (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.

Note



Image ModifiedUse cases and examples

using this post function


Page properties report
firstcolumnUse case
headingsFunction, Use case description, ComplexityJWT feature, Workflow function, Parser functions, Label
sortByTitle
cqllabel = "use-case-workflow" and space = currentSpace() and parent 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 descriptionTransition any issue to any available target status.
Label

Status
colourRed
titlestaff pick