This page last changed on Nov 04, 2009 by smaddox.

The Atlassian Connector for Eclipse allows you to conduct Crucible reviews right there in your integrated development environment. Your Crucible reviews will appear in your Eclipse 'Task List' view.

Before reading the information below, please make sure that you have installed the Atlassian Connector for Eclipse, as described in the installation guide, and defined a task repository for at least one Crucible server, as described in the configuration guide.

Summary of What You Can Do

Below are the highlights of viewing and acting upon Crucible reviews within Eclipse. Follow the links to the relevant sections of the user guide.

Adding a Query to Retrieve and Filter your Reviews

To retrieve your Crucible reviews and display them in your Eclipse task list, you will create an Eclipse Mylyn query. The query allows you to select an existing Crucible filter or define a custom filter.

When you define a task repository for your Crucible server, Eclipse Mylyn will prompt you to add a query for the new Crucible repository. You can also add more queries later, as described below.

To add a query for filtering your Crucible reviews,

  1. If you have not already set up a task repository for your Crucible server, please do so by following the steps in the configuration guide
  2. Open your Eclipse 'Task Repositories' view and find the task repository that you defined for your Crucible server:
    • In the Eclipse toolbar, select 'Window', 'Show View', 'Other'.
    • The 'Show View' popup window appears, as shown in screenshot 1 below. Open the 'Tasks' folder and click 'Task Repositories'.
    • The 'Task Repositories' view appears, as shown in screenshot 2 below. Right-click the task repository that you defined for your Crucible server and select 'New Query'.
  3. The 'Edit Repository Query' window appears, as shown in screenshot 3 below. Now you can choose to define a custom filter or use a predefined filter that exists on your Crucible server.
    • To define a custom filter:
      1. Select the 'Custom' radio button.
      2. Click 'Next'.
      3. Enter a title for your query, as prompted. Select the review field values that you want to filter on. For example, see screenshot 4 below.
        When selecting the review 'State', you can select more than one value by holding down the Ctrl key.
      4. Click 'Finish'.
    • To select an existing filter from your Crucible server:
      1. Select the 'Predefined Filter' radio button.
      2. Click one of the filters offered below the radio button, as shown in screenshot 3 below.
      3. Click 'Finish'.
  4. Your Crucible reviews will appear in your 'Task List' view, as described below.


Screenshot 1: Opening the 'Task Repositories' view




Screenshot 2: Adding a new query




Screenshot 3: Selecting a predefined review filter




Screenshot 4: Defining a custom review filter



Viewing your Reviews in the Eclipse Task List

Crucible reviews are included in your Eclipse 'Task List' view. You can take advantage of Mylyn's context management to keep track of the files and other assets associated with your review.

To open your Eclipse 'Task List' view,

  1. In the Eclipse toolbar, select 'Window', 'Show View', 'Task List'.
  2. The 'Task List' view appears, as shown in screenshot 5 below. Open the folder with the name corresponding to the query, i.e. the Crucible filter, that you created earlier.


Screenshot 5: Viewing your Crucible reviews in an Eclipse task list



Next, take a look at how you can monitor review updates in Eclipse.

RELATED TOPICS

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


Document generated by Confluence on Nov 05, 2009 21:57