This is the documentation of JSU for Jira Cloud. If you are using JSU on Jira Server or on Jira Data Center, see our JSU Server/Data Center documentation. |
The 'Follow Up Transition' Post Function will evaluate 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'.
Consider the following workflow:
Our issue has a mandatory number custom field.
At the end of the 'Go' transition, we have configured to 'Follow Up Transition' Post Function.
Each transition leading away from the status 'Junction' have 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, they will end up at the status 'In Progress'. If they enter 42, this will lead to 'Closed'.
In this example, we have been careful to configure our workflow conditions so that always only and exactly one condition can be true. Like this, the user will never get 'stuck' at the 'Junction' state. Instead the 'Follow Up Transition' will lead them to the correct end state.
The Follow-up Transition post function does not have any additional parameters to configure, however you must have a least one workflow condition configured.
Let's continue the example from above, where a number field is evaluated. We will configure three conditions; one for each outgoing transition from the 'Junction' status.
Here are some more ideas on how you might use the 'Follow Up Transition' Post Function.
A simpler more common case is, that you have only two transitions leading away and you evaluate basically the same condition, but at one condition negated.
a == b?
Again you can use the Value Field Condition Conditions for this setup.
Check it: 'Follow Up Transition' Post Function
Yes: Condition a == b?
No: Condition a != b?
Some extra steps in your workflow might only be necessary if some condition is not fulfilled. Otherwise, that step could be skipped.
See the Conditional Approval Process Use Case for another real-life example.
Usually, the problem can be tracked down, by manually walking through what the follow-up post function would do:
If exactly one condition is valid
that transition will be triggered
It's important that you do your analysis with the same user, that got stuck in the Junction status. 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 an issue that got stuck in 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 must review your workflow conditions on the transitions leading out from the Junction status.
If there is only 1 button, there might be something wrong with that following transition. For example, a validator could prevent the transition from getting completed. Try (with the same user, who got stuck in Junction) to click that button to see what happens.
Another reason might be that the triggered transition does not run through. For example, if it has a validator configured, which fails.