Our new Appfire Documentation Space is now live!

Take a look here! If you have any questions please email support@appfire.com

Build-your-own (scripted) Condition

Owned by David Fischer
Last updated: May 26, 2020 by Radhika Vijji. (Unlicensed)
2 min read

 

A workflow condition that hides/shows a transition based on the result of Jira expression. 

The transition to which the condition is added will be available only if the Jira expression returns true. This can be used to test or compare issue fields, to test linked issues, to check for open Sprints, etc.

To add the 'Build-your-own (scripted) Condition' to a transition:

  1. Click Edit for the workflow that has the transition you wish to configure the condition on.

  2. In the Workflow Designer, select the transition.

  3. Click on Conditions in the properties panel.

  4. Click on Add condition.

  5. Select Build-your-own (scripted) Condition from the list of conditions.

  6. Click on Add to add the condition on the transition.

  7. Input a Jira expression in the Jira expression field.

  8. For information on how to write a 'Jira expression' see How to insert information using Jira expressions.

  9. Click on Add to add the condition to the transition.

Common mistakes while using this condition:

Other related articles

 

 

When you add this condition to a transition, the add-on checks the result of the Jira expression. If the expression returns true, the transition will be available to the user, and if it returns false or a non-boolean value, the transition will be hidden.

Use case

A typical use of this workflow condition is to hide the transition when a field of the issue has a specific value or the current user belongs to a specific group.

Consider a use case where you want to show the “Approve” transition only when the current user is in the “Approvers” field. To configure this:

  1. Add the “Build-your-own (scripted) condition” to the “Approve” transition

  2. Input the following code under “Jira Expression”

    !! issue.customfield_10002 && issue.customfield_10002.some(it => it == user)

Note it is suggested to use the “Issue Fields” tab of the Jira expression editor, select the field from the list and the Jira expressions editor help system shows examples on accessing and testing the field value.

See https://innovalog.atlassian.net/wiki/x/GIDmOw for more uses cases for this condition.