
This page explains how to select files/changesets that will be included in a Crucible review.
On this page:
To add content to a review,
- Log in to FishEye/Crucible and either;
- Create a review, as described on Creating a Review, or
- Open an existing review, which you are the creator or moderator of, and click the Add Content (
) button.
- The 'Add Content to Review' dialogue will be displayed (see screenshot below). Select the method you want to use, to find the content for your review:
- 'Browse Changesets' — Allows you to choose changesets from a Source Code Management (SCM) repository to add to a review. See Selecting Changesets for Review.
- 'Explore Repositories' — Allows you to browse for files from a Source Code Management (SCM) repository to add to a review. This option only appears when FishEye is installed. See Selecting Files for Review using by Exploring Repositories.
- 'Search for Files' — Allows you to search a Source Code Management (SCM) repository for files or changesets to add to a review. This option only appears when FishEye is installed. See Selecting Files for Review using the Crucible Search.
- 'Suggest Files' — Analyses the list of files in the current review and makes suggestions based on certain logic (for example, suggesting a newer version of a file if one exists). This option only appears when FishEye is installed. See Using the Suggestions Feature When Adding Files to a Review.
- 'Pre-commit' — Allows you to upload patch files to a review. See Adding Pre-commit Patch Files to a Review.
- 'Attachments' — Allows you to upload any file to a review, including binary files and files outside of a Source Code Management (SCM) repository. See Adding Attachments to a Review.
- Follow the appropriate instructions in the sections below to add content to your review.
- Click the 'Done' button to finish adding content to the review.
Screenshot: The Add Content menu for Crucible reviews
Selecting Changesets for Review
|
Click the 'Browse Changesets' option on the 'Add Content' dialogue to add changesets to your review. Screenshot: The Browse Changesets View in the Add Content dialogue By default, Crucible presents a list of the author's changesets in reverse chronological order. You can see other changesets by changing the options at the top of the screen. Click the checkbox next to a changeset ID to add the entire changeset. Note,
Options for adding changesets:
Click the 'Done' button once you have finished selecting the desired files. The files will be added to your review and your review will be displayed. |
Selecting Files for Review by Exploring Repositories
|
Click the 'Explore Repositories' option on the 'Add Content' dialogue to browse repositories for files to add to your review. Screenshot: Browsing for files to add to a review
Choosing the way files are added to the review: When adding files to a review, you can set the form of review taking place in the 'Add to Review as' drop-down menu:
Click the 'Done' button once you have finished selecting the desired files. The files will be added to your review and your review will be displayed. |
Selecting Files for Review using the Crucible Search
|
Click the 'Search for Files' option on the 'Add Content' dialogue to use the Crucible search to find files to add to your review. Screenshot: Searching for files to add to a review If you are not certain about which changesets/revisions/files to include in a review, use the Search view to find them. Adjust the search filters to find the files you need. If the simple filters are not enough, read about EyeQL queries in the FishEye documentation. Read the FishEye documentation for more information about the searching your repository. Choosing the way files are added to the review: When adding files to a review, you can set the form of review taking place in the 'Add to Review as' drop-down menu:
Click the 'Done' button once you have finished selecting the desired files. The files will be added to your review and your review will be displayed. |
Using the Suggestions Feature When Adding Files to a Review
|
Click the 'Suggest Files' option on the 'Add Content' dialogue to view and add files suggested by Crucible to your review. You need to have already added some file(s) to review for Crucible to suggest additional files. Images: Viewing and adding file suggestions to a review Crucible can make intelligent suggestions when you are creating a review. The Suggestions feature logic is based around the following:
Choosing the way files are added to the review: When adding files to a review, you can set the form of review taking place in the 'Add to Review as' drop-down menu:
Click the 'Done' button once you have finished selecting the desired files. The files will be added to your review and your review will be displayed. |
Adding Pre-commit Patch Files to a Review
|
Click the 'Pre-commit' option on the 'Add Content' dialogue to add pre-commit patch files to your review. Screenshot: Adding pre-commit patch files to a review For a full explanation of the 'Patch View' functions, read about creating a patch review. Click the 'Done' button once you have finished selecting the desired files. The files will be added to your review and your review will be displayed. |
Adding Attachments to a Review
|
Click the 'Attachments' option on the 'Add Content' dialogue to add attachments to your review. Screenshot: Adding attachments to a review You can upload additional files to be used in the review, including binary files, images or code files that are not stored in a version control repository. The 'Upload' view contains various controls to help you do this. These are listed below. Choose the 'Upload Method' as either 'Select file from the file system' or 'Paste text from clipboard':
Click the 'Upload' button, when you have made your selection. Once complete, a list of uploaded files is displayed at the bottom of the screen. To add another iteration of a file, make changes to the file and upload it again with the same filename. It will be added as a new version. Click the 'Done' button once you have finished selecting the desired files. The files will be added to your review and your review will be displayed. |
Attachments:








