Preparing for JIRA 6.2
This page is intended to be read by JIRA plugin developers to inform them of changes in JIRA 6.2 that could affect their plugins. JIRA users should consult the documentation here.
It is our goal to notify you, our plugin developers, as far in advance as possible of everything we know about that can possibly affect your plugins. Where possible, we will attach release targets.
We will update this page as the release progresses. Please watch this page or check back regularly to keep on top of the changes.
On this page:
To allow us to dedicate resources to providing the best experience on modern browsers, JIRA 6.2 (including minor releases) will be the last release that supports Internet Explorer 8 (IE8). For more information, please see this page.
About the Early Access Program
The JIRA development team release an EAP milestone every two weeks for customers and plugin developers to keep abreast of upcoming changes. These EAP releases are available on the JIRA Early Access Program Downloads page.
Summary of Changes
The risk level indicates the level of certainty we have that things will break if you are in the "Who is affected?" column and you don't make the necessary changes.
|What is the change?||When will this happen?*||Risk level||Who is affected?||Details|
Issue Status as Lozenges
6.2-OD4 (JIRA Cloud)
Plugins that output issue statuses in their UI
See JIRA issue statuses as lozenges for details.
|Upgrade to AUI 5.3||
6.2-OD8 (JIRA Cloud)
|HIGH||Plugins that provide UI||See Plugin upgrade — AUI 5.3 below.|
|JIRA internal events||6.2-OD4 (JIRA Cloud)||LOW||See JIRA internal events below.|
|New entity properties||6.2-OD8||N/A||See Entity properties below.|
|Internet Explorer support||6.2 final||MEDIUM||All plugins||See Internet Explorer 11 supported in JIRA 6.2 below.|
|'creator' column added to 'jiraissues' table||6.2 final||LOW||See 'creator' column added to jiraissues table below.|
|Source distribution — Internal Atlassian dependencies are now Maven-based archives||6.2 final||MEDIUM||See Source distribution — Internal Atlassian dependencies are now Maven-based archives below|
Detailed Explanations of Changes
In this section:
Use of AMD in JIRA
When a module is defined, it cannot be redefined; The first definition will always take precedence. The consequence is that if plugins define modules with the same name as JIRA, JIRA's definitions will overwrite the plugin's definition. This may result in plugins using JIRA's versions of libraries rather than their own definitions.
JIRA defines the following AMD modules in 6.2-OD4:
It is recommended that plugin developers namespace their own AMD modules to avoid any potential conflicts.
Plugin upgrade — AUI 5.3
JIRA 6.2 will include a new version of the Atlassian User Interface library. The new version is two releases ahead from JIRA 6.1, and as such developers should review the release notes for both versions when upgrading their plugins:
- AUI 5.2 Release Notes (note that the jQuery upgrade is reversed as part of the AUI 5.3 upgrade. JIRA 6.2 will use jQuery 1.7.2)
- AUI 5.3 Release Notes
We expect that the changes most likely to cause problems for plugin developers are the upgrades to external libraries:
Changes to JIRA's footer
As part of the AUI upgrade, the JIRA's footer HTML markup has changed. Plugins that provide a footer via
<jira-footer> in their
atlassian-plugin.xml will need to update their output to no longer include the
<div class="footer-body"> wrapper around the
<ul> should become the top level element provided by footer providers. The
div.footer-body element has been replaced with a
section.footer-body element, which is now provided by JIRA, rather than plugins. It's conceivable that this change may affect some CSS selectors.
Changes to JIRA events
JIRA 6.2 will include auditing — the ability to track configuration changes done by administrators. To support this, we have enhanced and modified a number of internal events. In general, events now include more details about the action. Hence, some events have now different constructors (the previous ones were removed). These are not API breaking changes, although they may be perceived to be so. These constructors were only meant to be used internally, but they were never marked as internal. Starting with JIRA 6.2, they will now include a proper
@Internal annotation. Here is the list of events that will change (if for any reason you created those events in your code, please contact us):
We do not expect a lot of people to have used these constructors, but in case you have used them in your plugin, please let us know: contact
bartek (at) atlassian (dot) com or leave a comment under this page.
Internet Explorer 11 supported in JIRA 6.2
We are planning on supporting Internet Explorer 11 for JIRA Cloud and downloadable JIRA. We have scheduled this for the final production release of downloadable JIRA 6.2. Please ensure that your plugin is compatible with Internet Explorer 11, if you want it to work with JIRA 6.2 or JIRA Cloud.
'creator' column added to jiraissues table
Note, this change was also implemented in JIRA 6.1.6.
creator field was introduced in JIRA 6.2 EAP 6 m6 and will be included in the final JIRA 6.2 production release. This field was implemented as a column in the
jiraissues table in the JIRA database. Please note the following:
- New JIRA 6.2 instances: the
creatorfield will be located after the
- Existing JIRA instances that are upgraded to 6.2: the
creatorfield will be inserted as the last column in
We strongly recommend that you do not rely on the order of columns in the tables of the JIRA database, but instead refer to the columns explicitly by name.
JIRA 6.2 will include a new feature allowing add-ons to add key/value stores to JIRA entities, such as issues or projects. These values are indexed by JIRA and can be queried via a REST API or (in some cases) through JQL. More details are provided on the Index Document Configuration Plugin Module page as well as in the JIRA REST API documentation.
Source distribution — Internal Atlassian dependencies are now Maven-based archives
JIRA's source distribution includes the source of the internal Atlassian projects that JIRA depends on (e.g.
atlassian-core, etc.). From this release onwards, these internal Atlassian dependencies for JIRA's source distribution are now Maven-based archives, rather than exports of the source repository for each dependency. There will be a Maven-based archive for each dependency, named <dependencyname-version>-sources.jar. To provide us with feedback, please raise a ticket at https://jira.atlassian.com.
Please note the following:
- The only buildable part of the source package is JIRA itself, not its dependencies.
- A more complete source distribution has been provided as existing exclusions will be removed.
- If you have customized an internal Atlassian dependency, you may not be able to apply that customization to the dependency anymore. If you have done this, try searching/posting to the Atlassian Answers for an alternative solution.
- If you have customized a third-party library that has a dependency from JIRA source, you can still change the dependency in JIRA source. However, if the library has a dependency on an internal Atlassian dependency, you won't be able to change the library. If you have done this, try searching/posting to the Atlassian Answers for an alternative solution.