Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Panel
bgColor#f5f5f5
titleColor#ffffff
borderWidth0
titleBGColor#000000
titleJSU for Jira Cloud
Info

This is the documentation of JSU for Jira Cloud. If you are using JSU on Jira Server or on Jira Data Center, you can find the documentation heresee our JSU Server/Data Center documentation.

Description

The ' Follow Up Transition ' Post Function will evaluate the Workflow Conditionspost function evaluates the workflow conditions of all the next transitions on the target status of the current transition. If exactly one condition is valid, that transition will be triggered as a ' follow up'-up.

Configuration

The Follow Up Transition post function does not have any additional parameters to configure, however, you must have a least one workflow condition configured.

Consider the following workflow:

...

  • Our issue has a mandatory number custom field.

  • At the end of the

    '

    Go

    '

    transition, we have configured

    to '

    a Follow Up Transition

    ' Post Function

    post function.

  • Each transition leading away from the

    status 'Junction' have

    status

    Status
    colourYellow
    titlejunction
    has a workflow condition:

    • 'Under Five' has the condition: Number field < 5?

    • 'Exactly Five' has the condition: Number field == 5?

    • 'Over Five' has the condition: Number field > 5?

  • When the user performs the

    '

    Go

    '

    transition, this will always trigger a follow-up transition.

For example, if the user enters Number=3 during the ' Go ' transition, he will end up at the status 'In Progress'. If he enters 42, this will lead him to 'Closed'.In this example, we this leads to the

Status
colourYellow
titlein progress
status. If they enter 42, this leads to
Status
colourGreen
titleclosed
.

We have been careful to configure our workflow conditions so that always exactly only and exactly 1 one condition can be true. Like this the This way, the user will never get 'be stuck ' at the 'Junction' state. Instead the 'Follow Up Transition' will lead him to the correct end state.

(info) Tip: Since any workflow condition can be used for the follow ups, this provides you great flexibility. The JSU app has some quite useful additional Workflow Conditions . But you might also use some of another third party app.

Configuration

Image Removed

Conditions

However to complete your setup, you have to configure at least one workflow conditions. at the

Status
colourYellow
titlejunction
status.

Conditions

Let's continue the example from above, where a number field is evaluated. We will configure even 3 three conditions - ; one for each outgoing transition from the 'Junction'

Status
colourYellow
titlejunction
status.

Under Five

...

Exactly Five

...

Over Five

Image Removed

Asynchronous Execution

...

Examples

Here are some more ideas, how you might use the 'Follow Up Transition' Post Function.

...

Simple Yes / No example

A simpler more common use case is , that when you have only 2 two transitions leading away and you evaluate basically the same condition, but at ; one condition is negated.

  • a == b? 

Again you can use the Value Field Condition Conditions You can use Jira’s Value Field conditions for this setup.Image Removed

...

  • Check it:

     'Follow

     Follow Up Transition

    ' Post Function

    post function

  • Yes: Condition a == b?

  • No: Condition a != b?

Fast

...

forward example

Some extra step steps in your workflow might only be only necessary if some a condition is not fulfilled. Otherwise, that step could be skipped.Image Removed

...

Management

...

approval

See the Use Case /wiki/spaces/JSUCLOUD/pages/27801892 for another real life example.

Trouble shooting

...

Conditional Approval Process use case for another real-life example.

Asynchronous execution

Include Page
Asynchronous execution
Asynchronous execution

Troubleshooting

Problem: Workflow is blocked at the Junction status

Cause: Not exactly one condition

Usually, the problem can be tracked down, by manually walking through what the follow up reviewing the expected outcome of the post function would do:

...

”If exactly one condition is valid

...

, that transition will be triggered

...

(info) It.”

Info

It's important that you do your analysis with the same user

...

that

...

encountered the problem. There might be issues with permissions

...

that could lead to a different result, depending on the user performing the transition.

If you now look at such an issue , which got stuck in blocked at the Junction status: How many transition buttons does it have? Only if there is exactly one transition button, 'Follow up' will be triggered. If you have none or more than one transition button, you have to must review your workflow conditions on the transitions leading out from the Junction status.

If there is only 1 one button, there might be something wrong with that following transition. For example, a validator could prevent the transition to get from getting completed. Try (with the same user, who got stuck in Junction) to click that button to see what happens.

Cause: Triggered transition fails

Another reason might be that the triggered transition which is triggered does not run through. For example, if it has a validator configured, which failsthat fails.

Tip

You can learn more about workflow validators in Atlassian’s Configure Advanced Issue Workflows article.