Documentation for JIRA 5.0. Documentation for other versions of JIRA is available too. 
![]()
8 December 2011
JIRA 5.0 RC 2 (a.k.a 5.0 milestone 10 or 'm10') 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 2 release. Thank you for your feedback during the recent Beta and EAP releases and please keep providing it here.
Upgrading to JIRA 5.0 RC 2:
The focus of JIRA 5.0 is to help connect 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:
Remote 'issue links' | Sharing issues and 'mentions' | Create and edit issues rapidly |
|
|
|
Thank you for your interest in JIRA 5.0 RC 2
Download RC 2
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:
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:
Check out a live example here.
If you are a:
Screenshot: Sharing an issue with other users
Screenshot: Mentioning a user in an issue comment
Want to let others know about a JIRA issue or a list of search results quickly? Simply visit a JIRA issue or a list of issues on the issue navigator and then do either of the following:
JIRA users specified in the User name or email field will receive details of the issue or a link to a list of issues in an email message (sent to the addresses registered with their JIRA user accounts). The message's subject line will indicate that the person who used this feature 'shared' the issue(s) with them.
Users will receive details of the issue in an email message (sent to the addresses registered with their JIRA user accounts). The message's subject line will indicate that the person who used this feature 'mentioned' them on that issue.
Please Note:
JIRA 5.0 provides a rapid and customisable dialog box for creating and editing JIRA issues and sub-tasks. Unlike the old Create/Edit Issue forms, these dialog boxes do not require a page reload.
By default, the Create/Edit Issue dialog boxes show all available fields, which you can quickly remove or re-add. JIRA remembers your last set of field choices, giving you a personally customised dialog box that presents you with your most commonly edited fields whenever you create or edit an issue.
The Create/Edit 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-populates a new 'Create Issue' dialog box with your previous options, whilst leaving the 'Summary' field blank. Note that this feature does not carry across any attachments that were attached to your previously created issue.
Note that 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.
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'.
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.
Screenshot: Activity stream gadget showing activity
from other Atlassian applications
Screenshot: Activity stream gadget showing activity
from non-Atlassian applications
We are expanding the Activity Stream features introduced in JIRA 4.4 with:
Refer to the Preparing for JIRA 5.0 section of our developer documentation site for more details.
With these new features, you can:
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.
Only users with the Create Shared Objects global permission can share their filters and dashboards with other JIRA users.
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 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.
For example, the form for editing attachment settings is now a dialog box, which is accessed by clicking 'Edit Settings' on the 'Attachments' page of JIRA's Administration area.
JIRA's REST API is undergoing a significant number of changes and improvements to provide the following:
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.
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.
JIRA's Java API is undergoing a significant number of changes and improvements to provide the following:
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.
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 tab to show up more rapidly.
JIRA 5.0 adds several tools to help Administrators debug the configuration of their instance.
JIRA 5.0 incorporates a new email handler wizard that greatly simplifies the process of configuring incoming mail handlers for creating issues or comments from email messages.
You no longer have to configure a JIRA service and enter in a complex string of Handler parameters for your email handler. Instead you configure your email 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' tab has been separated into two tabs — one for 'Outgoing Mail' (SMTP) and another for 'Incoming Mail' (POP/IMAP) configuration. The configuration options for mail handlers in the 'Services' tab has been incorporated into the 'Incoming Mail' tab.
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.
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.
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.
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.
The JIRA to JIRA issue copy plugin is not bundled with JIRA, although it can currently be download from from the Atlassian Plugin Exchange.
For a list of more issues resolved in JIRA 5.0 so far, click here.
There were some minor changes to markup/style handling between RC1 and RC2, notably:
<div class="content-body"> elements, you will need to add an additional aui-panel class attribute to these elements, i.e. <div class="content-body aui-panel">page-type-viewissue is required on the body.<header id="stalker" class="stalker">) is now wrapped in a div element with a stalker-content class attribute, i.e. <header id="stalker" class="stalker"> ... </header> is now <header id="stalker" class="stalker"><div class="stalker-content"> ... </div></header>