Atlassian Integration Guide : Dragons Stage 6 - Get JIRA and Crucible Talking
This page last changed on Jun 22, 2011 by smaddox.


You are embarking on stage 6 of the Atlassian Dragon Quest. Be prepared to ride on the dragon's back, for he is swift and strong and will take you where you need to go.

In this stage you will add a Crucible project and connect it to your JIRA project. Then you will create a review, add a comment to the review and create a JIRA issue from that review comment. To consolidate your victory, you will add a Crucible gadget to your JIRA dashboard.

Time estimate: This stage will take approximately 30 minutes.

On this page:

Step 1. Create a Crucible Project and Link Your Crucible Project to Your JIRA Project

In this step you will create a Crucible project and link it to your JIRA project.

  1. Go to your FishEye/Crucible URL in your web browser, e.g. http://localhost:8060/fisheye.
  2. Click the downward-pointing arrow next to your username ('charlie') then click 'Administration' in the dropdown menu.
  3. Click 'Projects' in the left-hand panel.
  4. The 'Projects' screen will appear. Click 'Create a New Project'.
  5. The 'Edit Project' screen will appear. Enter the following information:
    • Name: Dragons
    • Key: DRA
    • By default, allow anyone to join reviews after creation – Select this checkbox.
  6. Leave all other fields at their default values and click 'Save'.
  7. The 'Projects' screen will appear again, displaying your 'Dragons' project.
  8. Click 'Application Links' in the 'Operations' column next to your 'Dragons' project.
  9. The 'Dragons Application Links' screen will appear. Click 'Add Link' and select your JIRA server in the dropdown menu.
  10. Click 'Create'.

Screenshot 1 (click to enlarge): Crucible Dragons project linked to JIRA Dragons project

Full details are in the Crucible documentation.

Problems? Please raise a support ticket for the product you're stuck on, see answers from the community, or search the forum of past dragon slayers.
Victory? Please continue.

Step 2. Create a Review

In this step, you will create a Crucible review from the dashboard activity stream and add a comment in that review.

  1. Click the 'Dashboard' tab in FishEye/Crucible.
  2. Find changeset '0:922fd9308885', the first changeset in the activity stream. Click the cog icon next to the date for the commit and click 'Create Review' in the dropdown menu.
  3. The 'Edit Review Details' screen will appear. Click 'Start Review'.
  4. Click 'Confirm' on the warning screen. The 'DRA-1' review screen will appear.
  5. Click 'App.java' under 'src' in the file tree on the left. The code for this file will appear in the right-hand panel.
  6. Scroll down to line 11 in the code and click the '11'.
  7. A text area will open for you to enter a comment. Add a comment as follows:
    • Enter the following text in the text area: This comment does not mention dragons. Please amend the text.
    • Select the 'Defect' checkbox.
  8. Click 'Post'. The review comment will appear.

You can now view your review in the 'Reviews' tab on your 'DRA-1' JIRA issue. Go to JIRA and open your 'DRA-1' issue. Click the 'Reviews' tab. The tab shows the reviews related to the issue, meaning the reviews involving changesets related to the issue.

Screenshot 2 (click to enlarge): Reviews tab on a JIRA issue

Step 3. Create a JIRA Issue from a Crucible Review

Next, you will reopen JIRA issue DRA-1 so that you can create subtasks for it. You will create a JIRA subtask from the comment in your Crucible review, and resolve the issue via Crucible.

  1. Go to JIRA and view your 'DRA-1' issue.
  2. Click 'Reopen issue'.
  3. The 'Reopen Issue' screen will appear. Click 'Reopen issue'.
  4. Go to your FishEye/Crucible dashboard.
  5. Click 'Re: DRA-1' in the 'Re: DRA-1 commented on review' text in the activity stream.
  6. The review details screen will appear. Click 'This comment does not mention dragons' in the 'Latest Comment' column.
  7. The review comment will appear. Click the 'Create Issue' link in the comment panel.
  8. The 'Create Issue' panel will appear. Click 'Assign to Me'.
  9. Click 'Create'. The key of your new issue (DRA-5) will be displayed in the review comment, with a status of 'Open'.
  10. Click the issue key, 'DRA-5'. The issue will open in JIRA.
  11. Click your browser's back button to see your review again.
  12. Click the 'Resolve' link next to the issue key in your review comment. The status of the issue in the review comment will change to 'Closed'.
  13. Click the issue key, 'DRA-5'. The issue will open in JIRA with a status of 'Closed'.

Screenshot 3 (click to enlarge): Closed JIRA issue displayed in a review comment

Step 4. Add a Crucible Gadget to JIRA

Now you will add the 'Crucible Charts' gadget to your Dragon Development Dashboard.

  1. Go to your JIRA URL in your web browser, e.g. http://localhost:8080/.
  2. Click 'Dashboards' at top left of your JIRA screen.
  3. Your 'Dragon Development Dashboard' will appear. Click 'Add Gadget'.
  4. The 'Gadget Directory' will appear, showing a list of the available gadgets for your JIRA dashboard. Enter 'Crucible' into the search box at top right of the Gadget directory screen.
  5. The list of gadgets will change, to show only the gadgets that match your search term. Find the 'Crucible Charts' gadget and click 'Add it Now'. The gadget will be highlighted for a short time and the button's wording will change to 'Adding', while JIRA adds the gadget to the dashboard.
  6. Click 'Finished' to go back to your dashboard.
  7. Configure the 'Crucible Charts' gadget:
    • Enter 'DRA' in the 'Crucible Project Key' field.
    • Click the dropdown arrow next to 'Refresh Interval' and select 'Every 15 Minutes'.
    • Click 'Save'.
  8. Choose a different colour for your 'Crucible Charts' gadget:
    • Move your cursor pointer over the gadget and click the downward-pointing arrow at top right of the gadget frame.
    • Select the dark blue square in the row of colours.

Problems? Please raise a support ticket for the product you're stuck on, see answers from the community, or search the forum of past dragon slayers.
Victory? Please continue.

Victory!

Your JIRA dashboard now has 6 gadgets:

  • The 'Crucible Charts' gadget
  • The 'FishEye Recent Changesets' gadget
  • The Confluence 'Activity Stream' gadget
  • The 'Assigned to Me' gadget
  • The 'Projects' gadget
  • The GreenHopper 'Agile' gadget

Screenshot 4 (click to enlarge): JIRA dashboard with 6 gadgets



Problems? Please raise a support ticket for the product you're stuck on, see answers from the community, or search the forum of past dragon slayers.
Victory? Please continue.
Grab a Bigger Sword and Move to the Next Stage

Attachments:
JIRADashboard4Gadgets.png (image/png)
JIRADashboardStage6.png (image/png)
JIRAIssueSourceTab.png (image/png)
JIRAProjectSourceTab.png (image/png)
CrucibleJIRASettingsSubtasks.png (image/png)
CrucibleJIRAProjectEntityLink.png (image/png)
JIRADashboardStage7.png (image/png)
JIRAIssueReviewsTab.png (image/png)
JIRADashboardStage7.png (image/png)
CrucibleReviewCommentJIRAIssue.png (image/png)
JIRADashboardStage7.png (image/png)
JIRAIssueReviewsTab.png (image/png)
CrucibleJIRASettingsSubtasks.png (image/png)
JIRADashboardStage7.png (image/png)
JIRAIssueReviewsTab.png (image/png)
CrucibleJIRAProjectEntityLink.png (image/png)
CrucibleJIRASettingsSubtasks.png (image/png)
CrucibleReviewCommentJIRAIssue.png (image/png)
JIRAIssueReviewsTab.png (image/png)
CrucibleJIRASettingsSubtasks-v5.png (image/png)
JIRADashboardStage7-v5.png (image/png)
CrucibleJIRAProjectEntityLink-v6.png (image/png)
JIRAIssueReviewsTab-v6.png (image/png)
CrucibleReviewCommentJIRAIssue-v6.png (image/png)
JIRADashboardStage7-v6.png (image/png)
Document generated by Confluence on Jun 22, 2011 21:05