Release 8.x

8.22.0

21 Feb 2024

Compatibility with Jira 9.13.x

ScriptRunner for Jira is now compatible with Jira 9.13.x. 

Documentation update: new ScriptRunner JQL AI

If you're not sure where to start with JQL Functions or are in need of a quick search filter, try out our new ScriptRunner JQL AI. With this tool, you can simply type in what you would like to search for, and it will provide you with your search in JQL format. 

Documentation update: new custom script field example

We've created a new custom script field example for you to use and follow. With this custom script field you can show the work remaining in all issues in an epic.

8.21.0

08 Feb 2024 

Script editor refresh

The Example Scripts modal is now accessible on the Script Editor page using the button. In addition, we have moved the Help and Fullscreen buttons so they sit above the code editor for easy accessibility. 

We have also made the type checking dialog more prominent so you can easily see when there is an error with your code. 

Bugs fixed

In this release, we've focused on fixing bugs to improve your experience of ScriptRunner for Jira Server/Data Center. See the Jira issues in the table below for more detailed information.

8.20.0

24 Jan 2024 

New Duplicate feature for Fragments

You can now duplicate a script fragment from a fragment's ellipsis menu. Check out the Script Fragments page for more information. 

Vendors API update

We've listened to feedback about our Vendors API and have implemented some changes:

• We've added support for asynchronous Promises in Vendors API getValue()
• We've added isPopulated optional method to API, to determine if the field is populated with data, and inform ScriptRunner of mandatory fields not filled in.

Documentation update: new Feature Release Summary page

We've created a new Feature Release Summary page, where you can explore all the feature releases we've introduced to ScriptRunner for Jira, starting from version 7.0.0 onwards. This hub is designed to assist you in finding the ideal version to upgrade to, all while catching up on any enhancements you might have missed since your last update.

New features

Bugs fixed

In this release, we've focused on fixing bugs to improve your experience of ScriptRunner for Jira Server/Data Center. See the Jira issues in the table below for more detailed information.

8.19.0

10 Jan 2024 

Compatibility with Jira 9.12.0

We have fixed the bug where users are unable to set values on user multi-picker fields, such as the Approvers field, using Behaviours. ScriptRunner for Jira is now fully compatible with Jira 9.12.0.

Bug fixed

8.18.0

13 Dec 2023 

Compatibility with Jira 9.12.0 (with known bug)

ScriptRunner for Jira is now compatible with Jira 9.12.0. We are aware of a bug where users are unable to set values on the Approvers field using Behaviours. This issue occurs on the Service Desk portal.

If you don't use this functionality, there are no known compatibility issues with ScriptRunner on Jira 9.12.0.

We will endeavor to fix this bug as soon as possible. If you have any issues you believe to be related to this bug, please don’t hesitate to contact our support team.

Fragment locator update

The fragment locator on the Script Fragments page has been updated to a toggle button for better visibility. Previously the locator was a clickable link.

New web panel example script

A new example script is available for when you create a web panel fragment. This new script provides you with a simple example of a colored banner. 

Documentation update: new Script Fragments tutorial

We have created a new Script Fragments tutorial that guides you through key terms and some easy-to-follow Script Fragment examples. 

New features

8.17.0

29 Nov 2023 

New Example scripts modal

The Example scripts modal is your go-to destination for finding basic script examples (formerly snippets) and Adaptavist Library scripts without having to leave the ScriptRunner app. This modal replaces the Show snippet section.

To access this modal, you can select the Example Scripts button in any code editor within ScriptRunner. Learn more about this new modal on the Example Scripts page.

Code editor refresh

In addition to the new Example Scripts modal we have redesigned the code editor so it’s even more user-friendly. We have moved the Help, Expand editor and Fullscreen buttons so they sit above the code editor and are easily accessible. We've also made the type checking dialog more prominent so you can easily see when there is an error with your code. 

Fragment location removed

The fragment location null/system.admin.header.pageactions has been removed. If you update to version 8.17.0 and you're using this location in a fragment, you will need to update the fragment location to system.admin.header.pageactions.

Fragment locator available in more places

You can now enable/disable the fragment locator from within a script fragment. Previously you could only enable/disable the fragment locator from the Fragments feature page. 

New features

Bugs fixed

In this release, we've focused on fixing bugs to improve your experience of ScriptRunner for Jira Server/Data Center. See the Jira issues in the table below for more detailed information.

8.16.0

15 Nov 2023 

Behaviours bug fixed

We have fixed a bug (SRJIRA-6929) related to the Behaviours mapping issue that has impacted ScriptRunner for Jira versions 8.12.0 to 8.15.0. If you upgrade and encounter any problems with behaviours, please don't hesitate to contact our support team.

Update: Vendors API

The getting value now works with all fields with our Vendors API. Previously this value did not work with some vendor API text fields. 

Additional bugs fixed

In this release, we have also focused on fixing bugs to improve your experience of ScriptRunner for Jira Server/Data Center. See the Jira issues in the table below for more detailed information.

8.15.0

01 Nov 2023 

8.12.1 bug fixed

We are pleased to inform you that we have now resolved the Behaviours mappings bug in version 8.12.1 of ScriptRunner for Jira. Please note:

• If you have already upgraded to version 8.12.1, or 8.14.0, and your behaviours are functioning properly, you can now proceed with confidence to upgrade to version 8.15.0.
• However, if you upgraded to version 8.12.1, or 8.14.0, and are still experiencing any issues with your behaviours please contact our support team. We will guide you through resolving this issue.
• If you have been using ScriptRunner for Jira 8.11.0 or earlier, you should be able to upgrade to 8.15.0 without issue. We have conducted thorough regression testing prior to this release, but if you do encounter any problems with behaviours after the upgrade, please don’t hesitate to contact our support team.

Additional updates

Bugs fixed

In this release, we've focused on fixing bugs to improve your experience of ScriptRunner for Jira Server/Data Center. See the Jira issues in the table below for more detailed information.

8.14.0

18 Oct 2023 

New: Vendors API

We have developed a new API for Atlassian Marketplace Vendors to use with their custom Jira fields to make them compatible with our DC Behaviours feature. Find out more details on the Vendors API page.

This is not a feature you'll be able to see in the app directly. This feature will let plugin creators define their fields in a ScriptRunner-compatible way which allows your Behaviours to interact with their fields. 

HAPI breaking changes

We have moved the location of a number of exceptions which may cause a breaking change for you if you have used them in a script. Find out more details in the HAPI Changelog. 

New documentation: Fragment locations

We've created the following new pages on Fragment locations to make it easier for you to understand, and identify, web item and web panel locations:

• Script Fragment Locations
• Web Item Locations
• Web Panel Locations

Bugs fixed

In this release, we've focused on fixing bugs to improve your experience of ScriptRunner for Jira Server/Data Center. See the Jira issues in the table below for more detailed information.

8.12.1

11 Oct 2023 

We are pleased to inform you that we have now resolved the bug in the Behaviours update task in version 8.12.0 of ScriptRunner for Jira. Please note:

• If you have already upgraded to version 8.12.0 and your behaviours are functioning properly, you can now proceed with confidence to upgrade to version 8.12.1.
• However, if you upgraded to version 8.12.0 and are still experiencing any issues with your behaviours please contact our support team. We will guide you through resolving this issue.
• If you have been using ScriptRunner for Jira 8.11.0 or earlier, you should be able to upgrade to 8.12.1 without issue. We have conducted thorough regression testing prior to this release, but if you do encounter any problems with behaviours after the upgrade, please don’t hesitate to contact our support team.

8.12.0

20 Sep 2023 

New Automation for Jira actions and triggers (Beta)

We've developed new actions and triggers for you to use in Automation for Jira:

• Create Asset (action)
• Update Asset (action)
• Asset Object Created (trigger)
• Asset Object Updated (trigger)

With these actions and triggers, we've provided a simple way for you to work with Assets (Insight) in Automation for Jira rules. 

Update to Behaviours configuration

We have updated Behaviours to use a new unique identifier. This change mainly impacts users who migrate behaviours using the migration guide or a third party tool.

Bugs fixed

In this release, we've focused on fixing bugs to improve your experience of ScriptRunner for Jira Server/Data Center. See the Jira issues in the table below for more detailed information.

8.11.0

07 Sep 2023 

New Automation for Jira actions (Beta)

We've developed new actions for you to use in Automation for Jira:

• Lookup Asset (Insight) Object
• Lookup Asset (Insight) Objects from AQL (IQL)

With these actions, we've provided a simple way for you to work with Assets (Insight) while creating rules in Automation for Jira. 

Behaviour bug fixed

We have fixed a bug (SRJIRA-6796) that caused our Behaviours feature to work incorrectly in the Jira Service Desk portal when triggering off of a Select list.

Bugs fixed

In this release, we've focused on fixing bugs to improve your experience of ScriptRunner for Jira Server/Data Center. See the Jira issues in the table below for more detailed information.

8.10.0

23 Aug 2023 

HAPI update

We've developed HAPI updates for retrieving user date information and linking/unlinking issues with the issue type ID. Find out more details in the HAPI Changelog. 

New features

8.9.0

09 Aug 2023 

User interface update to Listeners, Jobs, and Fragments

The Note field has been updated to Name for Listeners, Jobs, and Fragments. We have also made the Name field more prominent on the main pages for Listeners, Jobs, and Fragments, so you can easily identify your configurations. 

New features

Bugs fixed

In this release, we've focused on fixing bugs to improve your experience of ScriptRunner for Jira Server/Data Center. See the Jira issues in the table below for more detailed information.

8.8.1

31 Jul 2023

Bugs fixed

8.8.0

26 Jul 2023 

Script plugins update

We've done some work on the infrastructure supporting script plugins. As part of this, resources can now be exported and worked on in a script plugin. We are aiming to get closer to feature completion in the coming months.

Dynamic forms update

You can use optionsGenerator within the select list annotation to customize your own list options. This is useful if you can't find a dynamic form annotation that is suitable for your purpose.

New HAPI code helper

We've added a HAPI code helper, also known as a linter, that detects where your scripts can be simplified with HAPI code and suggests an alternative. Find out more details, and information about how to enable/disable this feature, on the HAPI Code Helper page.

Documentation update: HAPI examples

We've created multiple new examples that incorporate HAPI in the scripts, ready for you to explore and customize to your Jira instance. Visit the new HAPI examples page to find out more. 

Bugs fixed

8.7.1

21 Jul 2023 

Jira compatibility

ScriptRunner for Jira is now compatible with Jira 9.10. 

8.7.0

12 Jul 2023 

Dynamic forms update

The workflow scheme picker field, which allows workflow selection, has been added as a dynamic form field. Check out the Dynamic Forms page for more information. 

HAPI update

We've developed HAPI updates for using dot notation with Assets/Insight. We have also developed HAPI for working with issue, entity, and user properties. Find out more details in the HAPI Changelog. 

Bugs fixed

In this release, we've focused on fixing bugs to improve your experience of ScriptRunner for Jira Server/Data Center. See the Jira issues in the table below for more detailed information.

New features

Bugs fixed

8.6.0

28 Jun 2023 

Dynamic forms update

The permission scheme picker field, which allows scheme selection, has been added as a dynamic form field. Check out the Dynamic Forms page for more information. 

HAPI update

You can now reindex issues with HAPI. Check out the Reindex Issues documentation to learn more about reindexing issues.

New features

Bugs fixed

In this release, we've focused on fixing bugs to improve your experience of ScriptRunner for Jira Server/Data Center. See the Jira issues in the table below for more detailed information.

Bugs fixed

8.5.0

14 Jun 2023 

New built-in Listener

There is a new Execution failure notifier you can use to listen for script execution failures in your instance and to notify you of the failure. Check out the Execution Failure Notifier page for more information.

HAPI update

We've developed HAPI updates for creating an issue and Assets. Find out more details in the HAPI Changelog. 

Bugs fixed

In this release, we've focused on fixing bugs to improve your experience of ScriptRunner for Jira Server/Data Center. See the Jira issues in the tables below for more detailed information.

New Features

Bugs Fixed

8.4.0

01 Jun 2023 

Documentation updates

We've identified another breaking change in Groovy 4 that can impact those who use the @Grab annotation to import certain external libraries. The Groovy 4 Breaking Change for Grab Annotations page has more information on this breaking change and solutions on how to fix it. 

Visit the new Vulnerabilities and Security to inform you on how we scan for vulnerabilities and common security concerns.  

New bugs fixed

In this release, we've focused on fixing bugs to improve your experience of ScriptRunner for Jira Server/Data Center. See the Jira issues in the table below for more detailed information.

Bugs Fixed

8.3.0

17 May 2023 

HAPI update

You can now update comments using HAPI. Check out the Work with Comments page to learn more about what you can do with comments.

Snippets are now available for a custom script field

You will now see snippets when adding or updating a custom script field. You can use these snippets to help you develop a script for a script field.

New bugs fixed

In this release, we've focused on fixing bugs to improve your experience of ScriptRunner for Jira Server/Data Center. See the Jira issues in the table below for more detailed information.

New Features

Bugs Fixed

8.2.1

04 May 2023 

Bugs Fixed

8.2.0

03 May 2023 

New bugs fixed

In this release, we've focused on fixing bugs to improve your experience of ScriptRunner for Jira Server/Data Center. See the Jira issues in the table below for more detailed information.

Bugs Fixed

8.1.0

19 Apr 2023 

HAPI update

We've developed HAPI updates for comments and Assets. We've also simplified some examples for accessing links or attachments during a workflow transition. Find out more details in the HAPI Changelog. 

New bugs fixed

In this release, we've focused on fixing bugs to improve your experience of ScriptRunner for Jira Server/Data Center. See the Jira issues in the tables below for more detailed information.

New Features

Bugs Fixed

8.0.0

05 Apr 2023 

Groovy 4 update

We have updated ScriptRunner for Jira Server/Data Center to Groovy 4!

Our primary motivator for this update is to provide support for JDK 17. Groovy 3 doesn't support JDK 17, and with Jira 9.5.0 and Confluence 8.0 being JDK 17 compatible, an upgrade to Groovy 4 is necessary.

So, apart from JDK 17 compatibility, what comes with this update and how will it benefit you? 

New features in Groovy 4

The following are the most significant new features that have been added in Groovy 4 :

• Switch expressions which, unlike switch statements, are optimised towards branches that handle one case and break out rather than fall through to the next case.
• Sealed types
• Records
• Ranges have been enhanced with support for ranges open on the left, for example, 3<..5, or both sides, for example, 0<..<3
• Support for annotating generic types, for example List<@IntRange(min = 0, max = 10) Integer>

Please have a look at the Groovy 4 Release Notes for a complete list of new features.

Breaking changes in Groovy 4

Groovy 4 contains a number of breaking changes. The ones which are the most significant, and likely to affect ScriptRunner users, are listed below. Please have a look at the Groovy 4 Release Notes for a complete list of breaking changes.

1) Changes to the resolution of properties with both a getter and isser returning different types

For properties that have a getter and an isser returning different types (for example, JiraAuthenticationContext#getLoggedInUser and JiraAuthenticationContext#isLoggedInUser) when accessing the property, instead of calling one of the methods (for example, jiraAuthenticationContext.loggedInUser), the getter is called in Groovy 3 but the isser is called in Groovy 4 - see GROOVY-10821. You don't need to worry about updating scripts with the loggedInUser property on JiraAuthenticationContext as we have included a patch (see more below).

ScriptRunner for Jira patch

For backward compatibility reasons, ScriptRunner ships with a patch to keep the old Groovy 3 behaviour for two conflicting Jira API properties commonly used in customer scripts:

• The loggedInUser property on JiraAuthenticationContext 
• The created property on Issue

We've included this patch as these properties will likely be heavily used in users' scripts. This means you do not need to change any code using these properties.

Solution for other properties

From Groovy 4 if you have custom classes, or are using external classes that implement conflicting isser and getter methods, and you are using the property syntax to get the getter value, you must re-write the logic to use the getter method directly.

For example, this class demonstrates conflicting isser and getter methods:

groovy
class GetterIsser {
  String getSomething() { 'yes' }
  boolean isSomething() { false }
}
 
def myClass = new GetterIsser()
 
myClass.something // used to return 'yes', as of Groovy 4 will return false

From Groovy 4, this should be written as:

groovy
class GetterIsser {
  String getSomething() { 'yes' }
  boolean isSomething() { false }
}
 
def myClass = new GetterIsser()
 
myClass.getSomething() // will return 'yes'

2) Legacy package removal

Groovy 3 provided duplicate versions of numerous classes (in old and new packages) to allow Groovy users to migrate towards the new JPMS compliant package names - see the section about it in Groovy 3 Release Notes for more details. Groovy 4 no longer provides the duplicate legacy classes.

For backwards compatibility reasons ScriptRunner still ships with deprecated version of groovy.util.XmlSlurper and groovy.xml.XmlParser. We recommend you don't use these legacy classes going forward and use their equivalents that can be found in groovy.xml package.

3) Changes related to how Groovy code accesses private fields from within closures

Groovy developers are currently attempting to improve how its code accesses private fields in certain scenarios, where such access is expected but problematic. For example, within closure definitions where subclasses or inner classes are involved (GROOVY-5438). You may notice breakages in Groovy 4 code in such scenarios until they fix this issue.

4) Change to intersect() default Groovy method

intersect() default Groovy method used to draw elements from the second argument passed to it, but now it draws elements from the first argument passed to it - see GROOVY-10275.

5) Error message for users using @Grab to import certain libraries

There has been a breaking change for users using @Grab to import certain libraries. Check out the Groovy 4 Breaking Change for Grab Annotations page for more information on this breaking change and solutions on how to fix it. 

Deprecated SrSpecification class removed

Authors of Script Plugins may be used to writing tests which extend the deprecated com.onresolve.scriptrunner.canned.common.admin.SrSpecification class. This class has been removed. Authors of tests for their scripts should extend the spock.lang.Specification class directly. The Test Runner Built-in Script should still pick up tests as normal.

HAPI update

We've made a breaking change related to retrieving the customer request type. Find out more details in the HAPI Changelog. 

New Features

Bugs Fixed