This page last changed on Oct 14, 2008 by smaddox.
The Atlassian IntelliJ Connector allows you to conduct Crucible reviews in your integrated development environment.
This page tells you how to perform a Crucible review which someone else has assigned to you. Without leaving IDEA, you can:
- Open the review and related source in the IDEA editor.
- View your colleagues' comments in the context of the source.
- Select the relevant lines and add your comment or reply to someone else's comment.
- Track comments via highlights and marks in the right-hand gutter.
- View the source diff to see what has changed.
For more about conducting reviews within your IDE, refer to Using Crucible in the IntelliJ Connector.
On this page:
Opening an Existing Review
Screenshot: Crucible tab in the connector window
To open a review in IDEA:
- Open the connector's Crucible tab, as shown in the screenshot above.
- Choose your review filter (see Filtering the Crucible Reviews in IntelliJ IDEA) and expand the review filter groups until you see the review you want to work on.
- Right-click the review line and select 'Open Review'.
- The review opens in the IDEA 'Crucible Review' window, as shown in the screenshot below.
- Click the lines in the left-hand panel of the 'Crucible Review' window, to open the tree and view the files in the review. Existing review comments, if any, will appear in the right-hand panel.
Screenshot: A review open in the 'Crucible Review' window

Viewing the Source
To open the source code which is under review:
- Open the review in IDEA as described above.
- Click the plus signs next to the relevant lines in the 'Crucible Review' window, to open the tree and view the files in the review.
- Double-click a file to fetch the source code from the repository. The source will open in the IDEA editor window as shown in the screenshot above.
Viewing the Diff
To view the change which is currently under review:
- Open the review in IDEA as described above.
- In the 'Crucible Review' window, open the branches of the tree to find the files in the review.
- Select the relevant file and click the 'Show Diff'
icon in the toolbar.
- The diff view opens in a new window, as shown in the screenshot below.
Screenshot: Viewing the diff

Adding a Comment or Reply
To add a comment, you can do one of the following:
- In the 'Crucible Review' window, right-click on the relevant line and select 'Add comment' or 'Reply'.
- Or, in the 'Crucible Review' window, click the 'Add comment'
icon.
- Or, in the IDEA editor window, select and right-click on the relevant source line(s), then select 'Add Crucible Comment' as shown in the screenshot below.
Screenshot: Adding a comment to source lines

Moving to the Commented Code in the Source View
To move to the commented code, you can do one of the following:
- Click the comment in the 'Crucible Review' window. The code view will scroll to the affected line.
- Or click the highlights in the right-hand gutter of the IDEA editor window, as shown in the screenshot below.
Screenshot: Viewing commented code

Completing the Review
Once you have added your review comments, you should mark the review as completed. When all reviewers have completed their reviews, the moderator will summarise the review.
To complete the review:
- Open the connector's Crucible tab, as shown in the screenshot above.
- Find the review in the 'To Review' list. (Refer to Filtering the Crucible Reviews in IntelliJ IDEA for information on selecting the reviews to be displayed.)
- Right-click the review line and select 'Complete Review', as shown in the screenshot below:
Screenshot: Selecting a Crucible review for completion

- The 'Complete Review' dialogue appears, as shown below:
Screenshot: Completing a Crucible review

- Click the 'Complete Review' button.
- When the list of reviews is refreshed, the review will disappear from your 'To Review' group.
RELATED TOPICS
Using Crucible in the IntelliJ Connector
Configuring the IntelliJ Connector
User Guide for the Atlassian IntelliJ Connector
Refer to the Crucible documentation for more information about Crucible reviews.
|