JIRA 5.0 EAP 5 Release Notes
15 September 2011
JIRA 5.0 EAP 5 (a.k.a 5.0 milestone 5 or 'm5') is a public development release leading up to JIRA 5.0. An Early Access Preview (EAP) release is a snapshot of our work in progress, primarily focused on allowing JIRA users to see the new features in advance and provide us with some useful feedback. It also gives plugin developers an opportunity to test and fix their plugins in advance of an official release. For all production use and testing of JIRA, please use the latest official release.
While development work on JIRA 5.0 commenced relatively recently, we want your involvement from the earliest days. Please provide feedback here.A lot of the features in JIRA 5.0 focus on making JIRA easier to use and manage. With JIRA 5.0, you can link JIRA issues to other applications, search for issues whose fixVersion WAS a particular value at some point in the past, and administrators can manage shared filters and dashboards that were created by other people and issues can be copied between different JIRA sites.
There are a large number of improvements for the JIRA developer community (and more to come in future EAPs). In JIRA 5.0 EAP 5, new REST APIs have been added to create issues, a stable JIRA API is undergoing refinement and every block area on the 'View Issue' page is now a Web Panel.
Upgrading to JIRA 5.0 EAP 5
Do not use in production
- EAP releases are not safe — EAP releases are snapshots of the ongoing JIRA development process. As such:
- While we try to keep these releases stable, they have not undergone the same degree of testing as a full release.
- Features in development releases may be incomplete, or may change or be removed before the next full release.
- No upgrade path — Because EAP releases represent work in progress, we can not provide a supported upgrade path between EAP releases, or from any EAP to the eventual final release. Thus, any data you store in a JIRA EAP release may not be able to be migrated to a future JIRA release.
Highlights of JIRA 5.0 EAP 5
Remote Issue Linking (improved in EAP 5)
The Remote Issue Linking feature provides a powerful way to link JIRA issues to another application. Along with a Java and REST API to add links, end users can also add a link in a JIRA issue to any URL, such as some documentation on another site, a technical note, or any relevant web page or URL.
For more information about this feature, see JIRA Remote Issue Links.
More Enhancements to JQL — New "CHANGED" Operator and "WAS" Improvements (improved in EAP 5)
Enhancements were introduced in JIRA 4.4 that allowed you to search the history of an issue's Assignee and Reporter fields.
In JIRA 5.0, JQL supports the new "CHANGED" operator, which can accept the optional predicates "FROM", "TO", "ON", "DURING", "BEFORE", "AFTER" and "BY".
For example, the following JQL query:
status CHANGED FROM "In Progress" TO "Open" BY pslade BEFORE endOfWeek() AFTER startOfWeek()
Will find any issues whose Status field value was at some point "In Progress" but changed to "Open", by user 'pslade', and after the start and before the end of the current week.
The "CHANGED" operator can be used on the Status, Assignee, Priority, Reporter, Resolution and Fix Version fields.
The "WAS" operator can be used on the Fix Version field too. For example, the following JQL query:
fixVersion WAS 4.4
Will find any issues whose Fix Version field was at some point (or currently is) set to 4.4.
Activity Streams Now Show External Content
We are expanding the Activity Stream features introduced in JIRA 4.4 with:
- The ability to show external activity from another Atlassian application (such as Confluence, FishEye/Crucible and Bamboo) via an Application Link.
- The ability to combine this external activity into an Activity Stream gadget on a JIRA dashboard.
- An API for creating entries in activity streams from remote applications via the REST API or locally via Java.
Refer to the Plugin Developer Notes for JIRA 5.0 for more details.
Manage Other Users' Shared Filters and Dashboards
JIRA administrators have the ability to change the ownership of or delete other user's shared filters and dashboards. A shared filter or dashboard is a filter/dashboard created (and hence, owned) by a user, which the user has then shared with others.
Since JIRA only allows the editing or modification of shared filters/dashboards by their owners, this new JIRA feature is especially helpful in situations where a user has left an organisation, but the shared filters or dashboards they created continue to be used by others within the organisation.
Only users with the Create Shared Objects global permission can share their filters and dashboards with other JIRA users.
You can access these features by selecting 'Administration' > 'Users' > 'Shared Filters' or 'Shared Dashboards' (or using the keyboard shortcut 'g' + 'g' + start typing 'shared filters' or 'shared dashboard').
On the 'Shared Filters' or 'Shared Dashboard' pages, you can search for any shared filters/dashboards, or use the cog icon to change the owner of a shared filter/dashboard to another user or delete the shared filter/dashboard:
Administration User Interface Improvements (new in EAP 5)
Following on with improvements to the Administration User Interface (UI) in JIRA 4.4, JIRA 5.0 will provide further improvements to the Administration UI by converting various forms and pages in this area to convenient dialog boxes.
In JIRA 5.0 EAP 5, the 'Create New User' form, accessed by clicking 'Add User' on the 'User Browser' page of JIRA's Administration area, is now a dialog box.
REST API Improvements
JIRA's REST API is undergoing a significant number of changes and improvements to provide the following:
- Create new issues.
- Retrieve metadata for creating new issues.
- Retrieve metadata for editing existing issues.
- Delete existing issues and their subtasks.
- Create remote issue links.
Please also note that the we have changed the
api-version name component of URLs for JIRA's REST API calls from '
2.0.alpha1' to simply '
Refer to the Plugin Developer Notes for JIRA 5.0 for more details.
Java API Improvements
JIRA's Java API is undergoing a significant number of changes and improvements to provide the following:
- More stability and reliability with future versions of JIRA.
- Removal of deprecated OSUser classes.
- Removal of deprecated portlets (replaced by gadgets in JIRA 4.0) and their related APIs.
Please see the Plugin Developer Notes for JIRA 5.0 for more details.
Please also be aware that the JIRA's Java API is likely to undergo a rapid number of changes from one JIRA 5.0 EAP release to the next.
Lucene 3.2 is now fully integrated into JIRA. Initial benchmarking shows performance improvements across a number of JIRA features.
The 'Activity' tabs on the 'View Issue' page are now loaded in the background when this page is first viewed, allowing the information on these tabs to be displayed more rapidly.
New Troubleshooting and Debugging Tools (new in EAP 5)
JIRA 5.0 adds several tools to help Administrators debug the configuration of their instance.
- A number of email debugging tools are now provided to System Administrators in the new 'Logging and Profiling' page under 'Troubleshooting and Support'
- Enable or disable mail logging
- Turn debug mail logging on or off
- Configure a logging level for a new package easily in the default loggers section.
- For testing and troubleshooting LDAP connections, much more comprehensive testing is now provided, including basic connections, user retrieval, user membership, group retrieval, group membership and authentication.
New Plugin to Try Out — Remote Issue Copying
This new JIRA 5.0-compatible feature, currently undergoing development as a plugin, allows you to copy issues from one JIRA site to another.
Once you have an Application Link established between your JIRA site and another, a new issue action 'Remote Copy' will appear in the view issue page. You can limit this action to a particular user group, but by default everyone can use it.
You will be prompted to map field values by field names for JIRA's built-in (system) fields and/or to configure default values for required fields.
You will require the appropriate permissions to set the field value on the target site.
Custom fields are generally supported, although so far, we have only provided a mapper for the SelectCFType custom field type. Supporting more custom fields is a matter of writing more mappers (which we intend to make pluggable for the final JIRA 5.0 release).
The Remote Issue Copy feature is currently available as a plugin that needs to be installed on each JIRA server you wish to copy issues between. You also need to configure the following before you can copy issues between your JIRA sites:
- An Application Link from the source JIRA site to the target JIRA site — see Adding an Application Link.
- A Project Link from the source JIRA Project to the target JIRA Project — Adding Project Links between Applications.
The Remote Issue Copying plugin is not yet bundled with JIRA. However, you can download it from from the following link:
Other Enhancements and Fixes
For a list of more issues resolved in JIRA 5.0 so far, click here.