This page last changed on Aug 22, 2008 by smaddox.
The Atlassian IDE Plugin allows you to conduct Crucible reviews right there in your integrated development environment.
On this page:
Error formatting macro: toc: java.lang.NullPointerException
Crucible Status Icon
After you have defined at least one Crucible server in the plugin configuration panel, the Crucible status icon is displayed in the status bar. The icon has the following states:
- Grey when there are no reviews pending for which you have been made a reviewer by the review author or moderator.
- Grey with a green tick
and a number of pending reviews next to it, when there is at least one pending review which has not already been seen in the Crucible tool window tab.
In addition to the icon, a popup window appears whenever a new pending review becomes available on the Crucible server.
Screenshot: Crucible status icon in the IDEA status bar

Click the Crucible icon to open a Crucible tab. The icon state will be reset to grey.
The Contents of the Crucible Tab in the Plugin Window
The Crucible tab in the plugin window shows the list of reviews for which you have been made a reviewer.
Screenshot: Crucible tab in the plugin tool window
You can perform the following functions for each line in the list:
- Double-click a line, or right-click and select 'View', to open the selected review in a new browser
Above the review list, there is a row of buttons with the following functions:
— Open the plugin configuration panel.
— Get help on the usage of the Crucible tab (i.e. open this page in your browser).
— Refresh the status of the reviews in the list by polling defined Crucible servers.
Initiating the Review
To initiate a review of the code you have just created:
- Invoke the VCS Commit dialogue on the set of changes you want to have reviewed (file, directory, change set or project). For example, invoke the Subversion -> Commit if SVN is your version control system (VCS) of choice.
- This opens the 'Commit Changes' dialogue (pictured below), to which the plugin adds a 'Crucible Patch... button.
All other functionality of the 'Commit Changes' dialogue remains unchanged.
Screenshot: Subversion commit dialogue with the 'Create Crucible Review' button
- Click the 'Crucible Patch...' button.
- This opens the 'Create Patch Review' screen, pictured below.
Screenshot: Creating a Crucible review
The fields on the 'Create Patch Review' dialogue are the same as the ones in the Crucible web UI. Additionally, the dialogue contains a read-only view of the patch to be reviewed in the 'Universal diff' format. In brief, the dialogue allows you to:
- Select a Crucible server, the project key and the version control system (VCS) repository key, if you choose to use one.
- Define the review title.
- State the review objectives.
- Place a tick in the 'Open browser to complete review creation' checkbox if you want to open the newly created review in a browser window. This allows you to define the moderator and reviewers and perform other tasks to finalise the review creation.
- Click the 'Create review...' button to create the review on the Crucible server.
Refer to the Crucible documentation for more information about Crucible reviews.
RELATED TOPICS
Configuring the Plugin
IDE Plugin User Guide for IDEA
|