This page describes how to create a Crucible review directly from an issue in Jira, the Atlassian issue-tracking application.

(question) Jira must be integrated with Crucible before you can do this. See Linking Crucible to Jira for information on how to set up an application link with Jira.

See also Creating Jira issues from the review.

When using Crucible with Jira 6.2.x and later

If your instance of Crucible (version 3.3 or later) is linked to Jira 6.2 (or later), then you can start creating a review from a Jira issue.

To create a review from a Jira issue:

  1. Go to the Jira issue that relates to the work to be reviewed.
  2. Click Commits in the Development panel.
  3. Click the Fisheye / Crucible tab.
  4. Start the process for creating a review for either a single commit, or for all the commits related to the Jira issue.
  5. In Crucible, the new review is in edit mode:
    • The content of the changeset becomes the content (i.e. files) to be reviewed.
    • The author of the commit becomes the author of the review, if Crucible is aware of this user. Otherwise the creator of the review becomes the author.
    • The creator of the review becomes the moderator.
    • The commit log message is used as both the Title and Statement of Objective.

  6. Choose Tools > Start Review, in Crucible, when you are ready.

When using Crucible with Jira 6.1.x and earlier

If you have Crucible linked to a version of Jira earlier than 6.2 (or if you have instances of Crucible 3.2, or earlier, linked to Jira 6.2, or later), the integration functionality continues to behave as previously.

When Crucible is linked with Jira 6.1.x, or earlier, Crucible content appears on the Reviews tab ( and Fisheye content appears on the Source tab) in Jira. 

To create a review from a Jira issue:

  1. Go to the issue in Jira that relates to the work to be reviewed.
  2. Under 'Activity', click the Source tab.
  3. Either:
    1. Click Create review to create a new review for a particular changeset.
    2. Click Create review for all commits to include all changesets from the Jira issue in the new review.
  4. If a similar review already exists, you can add the changesets to that.
  5. In Crucible, the new review is in edit mode:
    • The content of the changeset becomes the content (i.e. files) to be reviewed.
    • The author of the changeset becomes the author of the review, if Crucible is aware of this user. Otherwise the creator of the review becomes the author.
    • The creator of the review becomes the moderator.
    • The commit log message is used as both the Title and Statement of Objective.

  6. Choose Tools > Start Review, in Crucible, when you are ready.

The next step is to add reviewers.

Screenshot: Adding a review from within Jira