Release 9.x

9.0.0

Compatibility with Bitbucket 9

ScriptRunner for Bitbucket is now compatible with Bitbucket 9. See the Upgrade to Bitbucket 9.0 page for more information on best practices for upgrading your instance.

Breaking changes

There are some key breaking changes you should be aware of when upgrading to Bitbucket 9 for:

• Gray APIs have been removed along with other API changes
• JDK has been updated. The minimum supported version of the JDK is now JDK 17. 
• Fragments updates (see more below)

Full details of the changes related to this upgrade are provided in Breaking Changes.

Fragments updates

To adhere to Bitbucket 9, the UI Fragments feature has the following changes: 

Raw XML Module Breaking Change: Fragment XML conditions scripts and web panel class scripts are now provided via XML parameters and are no longer directly set as the condition class element attribute or web panel class element attribute value. The previous formats no longer work in Bitbucket 9.0.0 versions of Scriptrunner. You can use the Raw XML Module Breaking Change guide to help you convert your scripts to the new fragment XML parameters format. Major changes include: 

• Format of the XML condition class attribute and user scripts now added as parameters
• Format of the XML Web Panel class attribute and user scripts now added as parameters

Web Panel Breaking Change: If you used a com.atlassian.plugin.web.model.WebPanel class implementation for the provider class/script of your web panels, the way this is processed will be different after upgrading to Bitbucket 9.0.0. Check out the Web Panel Breaking Change page to learn how to update scripts. Major changes include: 

• The writeHtml method is now ignored
• The Atlassian com.atlassian.plugin.web.model.WebPanel interface is deprecated and has moved to a new location

Web Resource Breaking Change: If you have scripts in plugin.resource.directories you will have to move them to web-resources/com.onresolve.confluence.groovy.groovyrunner. Check out this page to learn more.

Backward compatibility

ScriptRunner 9.0.0 will only support Bitbucket 9.0. and above and will not be backwards compatible with earlier Bitbucket versions. Critical bugs and security fixes will continue to be released for ScriptRunner 8.x.x. We recommend users on older versions of Bitbucket or ScriptRunner plan their upgrade to ensure access to the to ensure access to the latest features, performance improvements, and security enhancements. We recommend following our Upgrade to Bitbucket 9.0 page for information and recommendations on how to upgrade.

Bugs Fixed