Skip to end of metadata
Go to start of metadata

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 both FishEye and 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 the commits link in the Deployment 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.

 Click here if you're using JIRA 6.1 or earlier...

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

3 Comments

  1. It will show up under the Source tab.

    To get it to appear, make sure you have your projects linked both in JIRA and Crucible.  If they still dont show up restart both services (this is what did it for me).

  2. Anonymous

    It would be also nice if precommit reviews could be opened as well from JIRA.

  3. Would it be possible to create a review as a JIRA Workflow Transition? Or may be a post function? Basically I wanted to have an action like Create Review which will automatically create a review in Crucible