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 following options are available:

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.

Basic configuration*

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

Target issue*

more info..
Info
iconfalse

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

  • Current issue
  • Parent issue
  • Sub-tasks
  • Sibling sub-tasks
  • Linked issues
  • Linked epic
  • Issues under epic
  • Sibling issues under epic
  • 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
    title

    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 input has to be an issue key.

    Mode*

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




    more info...
    UI Expand
    titleMode
    Info
    iconfalse

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

    title
    OptionDescription
    Execute transition
    Expand

    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
    Pick either

    The expression must return a transition

    which is shown by

    name

    and ordered by workflows or a parser expression ((info) expects a transition ID)

    .


    Transition to status
    Expandtitlemore info..

    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
    Pick either

    The expression must return a status

    which is shown by

    name

    or a parser expression ((info) expects a status ID).

    .

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

    transition

    by Jira) will be executed.



    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 Expand
    iconfalse
    titleAdditional options

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

    OptionDescription
    Ignore conditions

    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
    : The execution of this post function will be delayed by the value specified in milliseconds.

    Include Page
    DECADIS:_snip_delayed_execution
    DECADIS:_snip_delayed_execution



    Enter a condition (Logical / boolean condition) using the JWT expression parser functions syntax.

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

    UI Expand
    iconfalse
    titleConditional execution
    UI Text Box
    typenote

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

    Include Page
    DECADIS:_snip_condExecution_Server
    DECADIS:_snip_condExecution_Server


    UI Expand
    iconfalse
    titleRun as

    Include Page
    DECADIS:_snip_runAs_Server_postFunction
    DECADIS:_snip_runAs_Server_postFunction
    Choose which user* will be able to execute this post function. By default it is set to the Current user.



    Image ModifiedUse cases and examples

    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