This page last changed on Oct 14, 2008 by smaddox.

The Atlassian IntelliJ Connector allows you to conduct Crucible reviews right there in your integrated development environment.

Crucible support automatically disabled for non-SCM projects

If a project is not under a source control management system, the Atlassian IntelliJ Connector now automatically disables the Crucible options for that SCM.cha

On this page:

Specific actions:

Installing and Configuring the Connector

Before reading the information below, please make sure that you have installed the Atlassian IntelliJ Connector, as described in the Installation Guide, and defined at least one Crucible server, as described in the Configuration Guide.

Icon and Popup showing Crucible Status

After you have defined at least one Crucible server in the connector configuration panel, the Crucible status icon is displayed in the status bar. The icon has the following states:

  • Grey when there are no reviews awaiting your attention.
  • Grey with a green tick when there is at least one pending review which you have not yet accessed in the Crucible tab.

Screenshot: Crucible status icon in the IDEA status bar



Click the Crucible icon to open the Crucible tab. The icon state will be reset to grey.

In addition to the icon, a popup window notifies you of status changes and comments added to the reviews which affect you.

Screenshot: Crucible review notification

Accessing the Crucible Tab in IDEA

To open the connector's Crucible tab in IDEA, you can do one of the following:

  • Click the Crucible status icon in the IDEA status bar.

  • Or:
    • Click the Atlassian Connector control button in the IDEA side bar:


    • Then select the Crucible tab in the connector window toolbar:

Contents of the Crucible Tab in the Connector Window

The Crucible tab in the connector window shows a number of review groups (such as 'To Review', 'Out For Review', etc) depending upon the filters you have selected.

Screenshot: Crucible tab in the connector window



The above screenshot shows the dashboard-like display of Crucible reviews which the connector offers within IDEA. The reviews are categorised into groups, as determined by the standard Crucible filters (such as 'To Review', 'Out For Review', etc). You can select one or more standard Crucible filters and also define your own custom filter. (Refer to Filtering the Crucible Reviews in IntelliJ IDEA.) Then expand and collapse the views to suit your needs.

Toolbar in the Crucible Tab

The tool bar above the list of issues provides the following functionality:

  • — Open the connector configuration panel.
  • — Get help on the usage of the Crucible tab (i.e. open this documentation page in your browser).
  • — Refresh the status of the review list by polling your Crucible servers.
  • — Open all the review lists in the Crucible tab, so that you can see the review line items as well as the filter headings.
  • — Close all the review lists in the Crucible tab, so that you can see only the filter headings.
  • — Create a custom Crucible filter. (See Filtering the Crucible Reviews in IntelliJ IDEA.)
  • — Select your filter(s) from the list of standard Crucible filters. (See Filtering the Crucible Reviews in IntelliJ IDEA.)
  • — Open the selected Crucible review in your web browser.
  • — Open the selected Crucible review in an IDEA window. (See Performing a Crucible Review in IntelliJ IDEA.)
Popup Context Menu for Reviews in the Crucible Tab

Right-click a line to show a popup context menu (pictured in the screenshot above) with actions that can be performed for the selected review:

  • View Review in Browser — Open the selected Crucible review in your web browser.
  • Open Review — Open the selected Crucible review in an IDEA window. (See Performing a Crucible Review in IntelliJ IDEA.)
  • Workflow actions, such as Complete Review, Summarize Review and Abandon Review — Move the review through the Crucible workflow statuses. (See below.)
  • Set Reviewers — Ask people to review your work.
Status of Reviews in the Crucible Tab

Different colours and font markings show the status of each review as follows:

  • Blue — Reviews which you need to review.
  • Grey — Reviews which you have already completed.
  • Green — Open reviews created or moderated by you.
  • Letters struck through (like this) — Reviews which have been closed or abandoned.
  • Black — Reviews which are not directly relevant to you.

In addition, the 'Reviewers' column shows the number of reviewers and whether each reviewer has completed the review.

  • A red square means that the reviewer has not yet completed the review.
  • A green square means that the reviewer has completed the review.
RELATED TOPICS

Refer to the Crucible documentation for more information about Crucible reviews.


Document generated by Confluence on Nov 12, 2008 17:20