This page last changed on Feb 25, 2010 by alui.

Once you have set up your Crucible server as an Eclipse task repository, you can create a Crucible review without leaving Eclipse. The Atlassian Connector for Eclipse allows you to create post-commit reviews, as described below, and also patch reviews, as described in another topic.

A post-commit review allows you to ask your colleagues to review changesets that have already been committed to your source repository. You can create a post-commit review by creating a new task via the task repository, or by from files selected in the package explorer, or from the Java file displayed in the Active Task Editor.

On this page:

Creating a Post-Commit Review from the Task Repository

To create a post-commit review from the task repository,

  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. Open the 'Tasks' folder and click 'Task Repositories'.
    • The 'Task Repositories' view appears, as shown in diagram 1 below. (If you have trouble finding the 'Task Repositories' view, try the full instructions with screenshots.)
  3. Right-click the task repository that you defined for your Crucible server and select 'New Task'.
  4. The 'New Crucible Review' window appears, as shown in diagram 1 below. Select 'From a Changeset' and click 'Next'.
  5. The 'New Crucible Review' window now shows recent changesets from your repository, as shown in screenshot 2 below. Select one or more changesets from the list on the left. (Hold down the Ctrl key to select more than one changeset at once.)
  6. Click 'Add' to move the selected changeset(s) into the box on the right.
  7. If prompted, click the 'Edit' button to map your local repository to the repository on your Crucible server.
  8. Click 'Next'.
  9. The 'New Crucible Review' window now prompts you for the review title and other details, as shown in screenshot 3 below. Enter the details and click 'Finish'.


Diagram 1: Adding a review as a task in your Crucible repository


Screenshot 2: Adding changesets to your review




Screenshot 3: Adding the review details



Next, take a look at creating a patch review.

Creating a Post-Commit Review from the Package Explorer

To create a post-commit review from the package explorer,

  1. Open your Eclipse 'Package Explorer'. You can view this in the 'Java' perspective, if you are currently using a different perspective.
  2. Locate the files to be included in the review, in the file tree in the Package Explorer and select them.
  3. Right-click one of the selected files and select 'Team' -> 'Create Review' from the popup menus. The 'Select a repository' window will display.
  4. Select the repository that you are reviewing files from and click 'Next'. The 'Add Resources to Review' window will display with the files you selected.
    If you have selected unversioned or modified resources, they will be added as pre-commit review items.
  5. Click the 'Next' button. The 'New Crucible Review' window will display (as per Screenshot 3 above).
  6. Enter the review details as desired and click the 'Finish' button to create your review.

Creating a Post-Commit Review from a file in the Active Task Editor

To create a post-commit review from a file in the Active Task Editor,

  1. Open a Java file in the Active Task Editor.
  2. Right-click the file in the Active Task Editor and select 'Team' -> 'Create Review' from the popup menus. The 'Select a repository' window will display.
  3. Select the repository that you are reviewing files from and click 'Next'. The 'New Crucible Review' window will display (as per Screenshot 3 above).
  4. Enter the review details as desired and click the 'Finish' button to create your review.
RELATED TOPICS

Working with Crucible Reviews in Eclipse

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


Document generated by Confluence on Mar 17, 2010 21:17