Conditions

A script condition is a workflow condition that allows you to extend the functionality you find in a basic Jira workflow condition. A condition checks to make sure that a requirement is met before a transition is made available to users. If the script returns false, the transition button is not available for a work item until the condition is met.

There are several ways to enhance your workflow using script conditions, as shown in Example Conditions and Validators, including:

  • Allow a transition only if the summary starts with specified characters.

  • Restrict transitions if certain fields are not populated.

  • Enforce that the work item must have at least one PDF file attachment to transition.

  • Allow only certain users to transition a work item.

ScriptRunner for Jira Cloud provides workflow conditions using the Jira Expression Framework. It is not possible to use the REST API.

Navigate to Context Variables to see the variables provided by this framework that can be used to create expressions. Click the variables to view the properties that can be called.

Create Condition

  1. Navigate to the Workflows menu from within Jira's settings. You will see Active and Inactive workflows displayed.
  2. Click Edit from the Actions ellipsis for your chosen workflow, and the workflow opens. You can choose to view the workflow as a diagram or text; we will use the former for this example.
  3. Select a transition from within the workflow diagram. A list of associated workflow functions, including Conditions, Validators, Post Functions, Triggers, and Properties, is displayed for the selected transition.
  4. Click Conditions, and the workflow's transition options appear.
  5. Click Add condition. You will see the list of conditions that can be added to the chosen transition. 
  6. Select the ScriptRunner condition option and click Add.
  7. Enter the Name of ScriptRunner Script Condition.
    In the ScriptRunner Script Condition field, enter the script condition expression. This script condition must be written as a Jira expression.

Edit Condition

  1. Navigate to ScriptRunner → Workflows. All existing workflows are displayed as the default.
  2. Select Condition from the Type drop-down list. You will now see a refined list displayed.
  3. Click the Actions ellipsis for your preferred workflow and select Edit.
  4. Edit the condition fields and click Save.
On this page