JIRA 5.0 RC 3 Release Notes

24 January 2012

JIRA 5.0 RC 3 (a.k.a 5.0 milestone 11 or 'm11') is a public development release leading up to JIRA 5.0. A Release Candidate (RC) is a preliminary release leading up to the official release of a JIRA version. RC releases are a fairly stable snapshot of our work in progress and provide an advance preview of new features to the general public. JIRA plugin developers can also use RC releases 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.

The Atlassian team is proud to bring you the JIRA 5.0 RC 3 release. Thank you for your feedback during the recent Beta and EAP releases and please keep providing it here.

(info) Upgrading to JIRA 5.0 RC 3:

Overview

JIRA 5.0 connects people, teams and other applications together. JIRA 5.0 helps connect people and teams by allowing them to share issues and search results and mention other team members in an issue. People and teams are better connected to other applications with remote 'issue links' to other JIRA sites or web page URLs and activity streams that span all your linked Atlassian applications.

JIRA 5.0 also introduces a large number of improvements for developers to help connect JIRA to other applications, including the introduction of:

  • New REST APIs to manage every facet of an issue,
  • New remote 'issue link' and activity stream features, specifically for integration with other applications, and
  • A stable Java API for JIRA.

Highlights:

Remote 'issue links'

Sharing issues and 'mentions'

Rapidly create and edit issues



  • Create links to JIRA issues on another JIRA site
  • Create links to any URL
  • Create links via JIRA's Java or REST API
  • Share issues quickly with other users
  • Mention a user in an issue comment
  • JIRA uses autocomplete whenever you 'share' or 'mention' a user
  • Rapidly create and edit issues in a dialog box
  • Create multiple issues in succession
  • Customise to show fields you use most often

Do not use in production

Beta releases should not be used in production environments as they are not officially supported.

Please also take note of the following information:

  • Beta releases are not safe— Beta 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 Beta releases represent work in progress, we cannot provide a supported upgrade path between Beta releases, or from any Beta to the eventual final release. Thus, any data you store in a JIRA Beta release may not be able to be migrated to a future JIRA release.

Highlights


Remote 'issue links'

The remote 'issue links' feature provides a powerful way to link JIRA issues to items external to your JIRA installation, residing on external applications.

Along with a Java and REST API to add these links, end users can also:

  • Add an issue link from a JIRA issue to an issue on another JIRA site, including reciprocal links between these issues.
  • Search for a Confluence page from a JIRA issue and add an issue link to that page.
  • Add an issue link from a JIRA issue to any web page URL, such as a page of documentation, a technical note, or any other page on another web site.

Check out a live example here.

If you are a:

  • JIRA user — see Linking Issues for details on using remote 'Issue Links' within JIRA.
  • JIRA system administrator — see Configuring Issue Linking for details on how to make remote 'Issue Linking' available to your users by setting up the required application links between JIRA and other applications.
  • JIRA developer — see JIRA Remote Issue Links on our developer documentation site.

^Top



Sharing issues and 'mentions'

Screenshot: Sharing a list of issues with other users

Screenshot: Mentioning a user in an issue comment

Need someone else to take a look at a JIRA issue or a list of issues?

  • View any issue or a list of issues on the issue navigator, click the Share button at the top-right (or type s) and specify JIRA users (based on their names or user names) or any email address of people you want to share the issue with.

    Recipients will be emailed a link to the issue (or a list of issues 'shared' via the issue navigator).
  • Mention other JIRA users in an issue's Description or Comment field when creating, editing or commenting on an issue.

    JIRA users will receive details of the issue in an email message (sent to the addresses registered with their user accounts). The message's subject line will indicate that the person who used this feature 'mentioned' them on that issue.

(info) Please Note:

  • Users required the Browse Users global permission to access the Share button or the autocomplete feature when 'mentioning' a user. However, if you know the username of a JIRA user, you can still mention them.
  • JIRA system administrators will need to configure JIRA's outgoing SMTP mail server for the 'share' and 'mentions' features to work.

^Top

 

 

Rapidly create and edit issues

JIRA 5.0 lets you create and edit issues and sub-tasks much faster. Creating and editing is now performed in a dialog box (rather than a separate form), so that you do not need to leave the current page or have it reload just to start creating or editing an issue or sub-task.

You can customise fields on the Create Issue/Edit Issue dialog boxes by removing or adding fields fields through the Configure Fields button. JIRA remembers your last set of field choices, giving you a personally customised dialog box that presents you with your most commonly used fields whenever you create or edit an issue.

The Create Issue dialog box allows you to rapidly create a series of related issues with similar options. When you select the Create another check box before clicking the Create button, JIRA creates your issue and automatically pre-populating a new Create Issue dialog box with your previous field values, whilst leaving the Summary field blank. Note that this feature does not carry across any attachments that were attached to your previously created issue.

The Assignee, Project and Issue Type fields use 'autocompletion' too. Hence, you no longer a need to scroll through a whole raft of items to specify these fields when creating or editing an issue.

You can easily access this feature by typing 'c' to access the create issue dialog box or 'e' from a currently selected issue on the issue navigator or 'view issue' page to access the edit dialog box for that issue.

^Top

 

 

Search for issues based on their history


"CHANGED" operator introduced

Introduced in JIRA 4.4.3, JQL's "CHANGED" operator can accept the optional predicates FROM, TO, ON, DURING, BEFORE, AFTER and BY, and can be used on the Status, Assignee, Priority, Reporter, Resolution and Fix Version fields.

For example, this link shows all the issues logged against the JIRA project on our 'jira.atlassian.com' site, whose Fix Version field was changed to "5.0".

You can also create more complex JQL queries with the "CHANGED" operator by fine-tuning them with predicates. For example, the following JQL query:

status changed FROM "In QA Review" TO "QA Rejected" BY freddo AFTER startOfWeek() BEFORE endOfWeek()

will find any issues whose Status field value was at some point "In QA Review" but changed to "QA Rejected", by user 'freddo' between the start and end of the current week.

You can use complex queries such as these to generate the 'Single Level Group By Report' in the screenshot above, which shows grouping by 'Team'.

"WAS" operator enhanced

Also introduced in JIRA 4.4.3 was the ability of the "WAS" operator to work with the Fix Version field. 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.

^Top

 

 

Activity streams now show activity from other applications


Screenshot: Activity stream gadget showing activity
from other Atlassian applications

Screenshot: Activity stream gadget showing activity
from non-Atlassian applications

We have expanded 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 Preparing for JIRA 5.0 section of our developer documentation site for more details.

With these new features, you can:

  • See Confluence page updates from your activity streams in JIRA, then drill down into those Confluence pages for more information.
  • See updates from another JIRA site. For example, activity streams on your development team's JIRA site (behind the firewall) can include activity on your support team's customer facing JIRA site.

^Top

 

 

Manage other users' shared filters and dashboards

Introduced in JIRA 4.4.1, 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.

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.

(info) Only users with the Create Shared Objects global permission can share their filters and dashboards with other JIRA users.

^Top

 

 

Administration user interface improvements

Following on with improvements to the Administration User Interface (UI) in JIRA 4.4, JIRA 5.0 provides further improvements to the Administration UI by converting forms on various Administration pages to convenient dialog boxes.

For example, the form for adding users is now a dialog box, which is accessed by clicking Add User on the Users page of JIRA's Administration area.

In addition to the dialog box for adding a new user, the 'Attachments' and 'Workflows' pages have been redesigned and the forms associated with these pages have been converted into convenient dialog boxes too.

^Top

 

 

REST API (with tutorials) for working with issues in JIRA

JIRA's REST API has undergone a significant number of changes and improvements to provide the following:

  • Create new issues.
  • Retrieve metadata for creating new issues and editing existing ones.
  • Delete existing issues and their subtasks.
  • Create remote 'issue links'.
  • Retrieve metadata from your favourite filters and dashboards.
  • Retrieve metadata about your permissions.
  • Almost all system fields and JIRA's built-in custom field types are supported.

(info) 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 '2' (or 'latest' to use the latest REST API version available with your version of JIRA).

Refer to the Preparing for JIRA 5.0 section of our developer documentation site for more details.

We also have a series of REST API Tutorials to help you get started using our new REST API improvements.

(info) You might also want to try out Atlassian's new REST API Browser, which is available in the Atlassian Plugin SDK and can be accessed by adding /plugins/servlet/restbrowser#/user/search to the end of the URL for accessing JIRA (e.g. http://localhost:2990/jira/plugins/servlet/restbrowser#/user/search) within the SDK environment.

^Top

 

 

Stable Java API

JIRA's Java API has undergone a significant number of changes and improvements to provide the following:

  • More stability and compatibility with future versions of JIRA. See our Java API Policy for JIRA for details.
  • Removal of deprecated OSUser classes.
  • Removal of deprecated portlets (replaced by gadgets in JIRA 4.0) and their related APIs.
  • Active Objects is bundled with JIRA 5.0. A new version of Active Objects will be available in the official JIRA 5.0 release. However, if you are developing against JIRA 5.0 RC 3, we recommend that you can obtain the latest version of Active Objects (0.18.4) from our public Maven repository. Refer to our instructions on how to upgrade to this version of Active Objects in JIRA 5.0 RC 3.

Refer to the Preparing for JIRA 5.0 section of our developer documentation site for more details.

If you are developing plugins for JIRA 5.0, please also check out our newly published set of JIRA plugin tutorials.

^Top

 

 

Performance improvements

Lucene 3.2 is now fully integrated into JIRA. Customers with moderate to large JIRA installations may notice a significant performance improvement in searches, particularly when other actions and operations such as creating and editing issues are conducted simultaneously.

The content of each 'activity' tab on the 'view issue' page now loads independently of the rest of the 'view issue' page. Instead, the content of an activity tab now only loads when the user clicks the tab. This revised behaviour allows the information on these tabs to show up more rapidly.

^Top

 

 

New troubleshooting and debugging tools

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.

^Top

 

 

New email handler wizard

JIRA 5.0 incorporates a new mail handler wizard that greatly simplifies the process of configuring incoming mail handlers for creating issues or comments from email messages.

There is no longer a need to configure a JIRA service and enter a complex string of mail handler parameters to handle your email messages. Instead, simply you configure your mail handler through a convenient wizard.

Improvements have been made to the layout of JIRA's mail configuration options. The configuration options in the Mail Servers administration page have been separated into two separate pages — one for Outgoing Mail (SMTP) and another for Incoming Mail (POP/IMAP) configurations. The configuration options for mail handlers have been moved from the Services administration page and incorporated into the Incoming Mail page.

^Top

Enhancements to the 'view issue' page

The 'view issue' page has the following enhancements:

  • The Issue Links section of the 'view issue' page has been redesigned to cater for remote issue links (above) and makes better use of space — the separate line used to group issue link types in earlier versions of JIRA has been removed.
  • The right-hand side of the view issue page now uses a fixed width. Hence, when the 'view page' is maximised on large, high resolution monitors, the association between field names and values is not lost.
  • For plugin developers - the left hand side of the 'view issue' page can be customised via web panels. Hence, you can now insert your own custom panels anywhere below the operations bar on the 'view issue' page.
    (info) The web panel location for the left-hand side of the 'view issue' page is atl.jira.view.issue.left.context — refer to the View Issue Page Locations page of the Web Fragments guide in our Atlassian Developers documentation site for more information. Also see our plugin tutorial for an example of customising the right-hand side of the 'view issue' page (a plugin developer-feature which became available in JIRA 4.4).

     

^Top

New plugin to try out — JIRA to JIRA issue copy

This new JIRA 5.0-compatible feature currently under development as a plugin, allows you to copy issues from one JIRA site to another.

After establishing an Application Link between your JIRA site and another and one or more Project Links across these sites, a new 'Remote Copy' action will become available when viewing an issue belonging to a project involved in this project link.

Using JIRA to JIRA issue copy

After clicking the Remote Copy menu item, the Remote Copy 'wizard' will prompt you to choose a remote JIRA project to copy the issue to and will then automatically map fields between your local and remote JIRA projects.

Most system fields and some custom fields are supported. For a detail list of supported fields, see our Issue Field copy rules documentation.

When copying an issue, you can define a bidirectional remote 'issue link' between the issues. If the remote site is on a version of JIRA that does not support remote 'issue links' (prior to 5.0), you can create a single remote 'issue link' from the local issue to the remote issue and a comment will be added to the remote issue with a link to the local issue it was copied from.

Configuring JIRA to JIRA issue copy

The JIRA to JIRA issue copy feature is available to all users by default, although it can be restricted to a particular group.

If certain mandatory System or Custom fields in your local JIRA project are unlikely to exist or have valid values in the remote JIRA projects from which you are copying issues, you can specify default values for these required fields in your local JIRA project. These default values will also be used in the event that the user copying an issue remotely does not have permission to set these fields in your local JIRA project.

Getting the JIRA to JIRA issue copy plugin

The JIRA to JIRA issue copy feature is currently available as a plugin that needs to be installed on each JIRA server you wish to copy issues between.

(warning) The JIRA to JIRA issue copy plugin is not bundled with JIRA, although it can currently be download from from the Atlassian Plugin Exchange.

^Top

 

Other enhancements and fixes

When you access your new or upgraded JIRA 5.0 installation, JIRA launches the What's New in JIRA ... dialog box, which provides brief overview of the new features available in that JIRA version.

(tick) This dialog box can be prevented from showing up whenever you access JIRA by selecting the Don't show again check box at the base of the dialog box. However, you can access this dialog box again by choosing the What's New item from your user name drop down menu.

For a list of more issues resolved in JIRA 5.0 so far, click here.

^Top

Last modified on Feb 20, 2012

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.