JIRA is Atlassian's issue tracking and project management application. This page describes how to integrate JIRA with Crucible. When Crucible was first installed, JIRA integration may have been configured using the setup wizard, which configures the JIRA connection automatically using the most common options. See Configuring JIRA integration in the Setup Wizard. However, JIRA integration with Crucible can be configured at any time after installation, as described on this page. Initial configuration in JIRA Configure the following setting in each instance of JIRA that you wish to link to Crucible: Allow remote API access Consider also the following settings, to make full use of the integration between Crucible and JIRA: Enable subtasks Allow unassigned issues On this page: Related pages: JIRA integration in Crucible User management limitations and recommendations Configuring application links

Linking Crucible with JIRA instances

You can integrate Crucible with one or more instances of JIRA using the Crucible administration screens. There are two parts to integrating each JIRA instance:

• A peer-to-peer link between JIRA and Crucible for sharing information and facilitating integration features. This link is set up using Application Links.
• A client-server link between Crucible and JIRA for delegating user and group management to your JIRA server.

1. Configuring an application link with JIRA

This section describes how to create a two-way trusted applications link between Crucible and JIRA. We assume that your Crucible and JIRA servers are using the same set of users. If not, please refer to Adding an application link for information about the various options available.

To add a two-way trusted applications link between Crucible and JIRA:

1. Go to your Crucible administration screen and click Application Links (under 'Global Settings').
2. Now: 

2. Connecting to JIRA for user management

This option is available only with JIRA 4.3 and later.

To manage your Crucible users using JIRA, configure a connection in JIRA and then set up the user directory in Crucible. Both steps are described below.

2.1. To configure a new connection for user management in JIRA:

1. Log in to JIRA as a user with the 'JIRA System Administrators' global permission.
2. Click Administration on the JIRA top navigation bar. 

2.2. To set up the JIRA user directory in Crucible:

Go to your Crucible administration screen. 

Inline issue creation

Inline issue creation allows a user to create a JIRA issue from a review comment. The user must have the 'Comment' permission in Crucible to see the Create Issue link in the comment. See Creating JIRA issues from the review.

This requires that Crucible is integrated with JIRA 5.0, or later, and is disabled if Crucible is integrated with an earlier version of JIRA.

When creating the issue, the Create Issue dialog only displays required fields for the selected issue type.

• A JIRA administrator can configure other fields to be required (and so displayed) from within JIRA. See Specifying Field Behaviour. 
• Not all field types are supported. In particular, unbundled custom field types are not supported. See Supported fields for inline issue creation.
• If any required field for the selected issue type is not supported, Crucible displays an error, with a link to create the issue directly in JIRA. This link will pre-populate the project, issue type, summary and description fields, but will not create a link from the comment to the issue. 

In the new issue in JIRA, you see a link back to the comment in Crucible. However:

• Issue links may be disabled in JIRA.
• The JIRA login that Crucible uses needs permission to create links.
• The FishEye plugin (available from the Atlassian Marketplace) must be installed in JIRA for permission checking on the display of issue links in JIRA.

You can disable the Inline Issue Creation plugin in Crucible to restore the earlier behaviour.