Features

This page summarises ScriptRunner for Jira Cloud's features, and describes additional functionality we have developed to optimize your scripting experience.

You can find all of the following features within the ScriptRunner menu. Check out our Navigation page for more information on how to navigate ScriptRunner. 

ScriptRunner Enhanced Search

The ScriptRunner Enhanced Search feature provides advanced JQL function search capabilities, or queries, in Jira Cloud, which you can modify or extend. You can use ScriptRunner JQL functions anywhere you are able to use Jira JQL functions.

Script Console

Use the Script Console to experiment and run scripts on the script editor. You can enter your own scripts, or use one of the many example scripts provided. The Script Console is useful for testing scripts or performing operations that you only want to do once.

Built-In Scripts

Use Built-In Scripts to automate manual, complex, and time-consuming tasks. Built-in scripts have been created for some of the most commonly run tasks in ScriptRunner for Jira Cloud. For example, you can use the Bulk Clone Issues to select Jira issues to clone and move to another project as a set of issues in bulk.

Scheduled Jobs

Use Jobs to automate the running of scripts at regular intervals—saving your administrators time, and reducing the risk of human error.

Script Listeners

Use Script Listeners to create automated procedures in ScriptRunner that listen for a specific event to occur in Jira and then carry out an action when it does. Script Listeners sit on your instance and wait for a webhook event to happen before executing the listener script. Webhooks are fired after an action has taken place in Jira, such as when a project is created or if an issue is updated.

Workflow Extensions

Use Workflows to enhance and automate your workflows beyond Jira's native possibilities. ScriptRunner for Jira Cloud extensions to Atlassian's workflows enable you to set up rules relating to the transition of an issue's status within Jira Cloud, giving you increased control over how and when an issue transitions. You can also set up post-transition rules.

Behaviours

Use Behaviours to define how fields behave for issues in a given project or issue context. For example, you may want to create a behaviour that hides a field for a specific user group until it's relevant for them to interact with that particular field. To use the Behaviours feature, you must install the Behaviours - ScriptRunner for Jira Cloud companion app.

Escalation Service

The Escalation Service allows you to define a process for modifying issues after a certain amount of time has elapsed. This is useful for business procedures that require tasks to be completed within a certain time-frame (service level agreement). Escalation Services can be used if, for example, a task has been opened but not assigned for 7 days. You could automatically move it to a "Prioritize" status, or add a comment, which will cause an email to be sent.

Script Variables

You can use Script Variables to specify variables that can be inserted into your scripts (Script Console, Script Listeners, Workflow Post Functions, Scheduled Jobs, Escalation Service). The variables are encrypted and stored within your ScriptRunner for Jira Cloud instance. You can use them to share common variables between your scripts, or to store sensitive data such as passwords that require encryption rather than hard-coding them directly in scripts.

Script Fragments

Use UI Fragments to customize the UI of your Jira instance. For example, you can use this feature to create a custom link or button or show a custom banner on your JIra instance. 

Scripted Fields

Use Scripted Fields to display information that would otherwise be unavailable for an issue by calculating or combining data from one or more existing fields and displaying the result in as a custom field. The results are updated when viewing an issue and when an issue containing a Scripted Field is updated. You can enter your own script into the script editor, or use one of the many example scripts provided.

Useful features to improve your scripting experience

HAPI

HAPI is an API developed to carry out common tasks in Jira, including managing issues, searching for issues, updating fields and much more! HAPI is a simple alternative to Jira's regular API and can be used in your Groovy scripts. See the HAPI page for more details on this feature and to find examples of how to use HAPI.