View Source

This page explains how to add content, such as files and changesets, to a Crucible review. The procedure depends on whether you are setting up a post-commit or pre-commit review:

Post-commit reviews – You want code changes that have already been committed to the SCM to be reviewed. In Crucible, you can browse and search for files or changesets in the SCM, which you then add to the review. Crucible can suggest files that should be considered for review, based on recent activity.
Pre-commit reviews – You want code changes that have not yet been committed to the SCM to be reviewed. In Crucible, you need to add patch files to a pre-commit review.

Related pages:

Note that Crucible supports 'iterative' reviews – for both post-commit and pre-commit reviews you can update the review with new versions of files, and changesets, created after the review was started.

On this page:

General procedure

To add content to a review:

Log in to FishEye/Crucible and either;
- Create a new review, as described on Creating a review, or
- Open an existing review, for which you are the creator or moderator, and click the Add Content () button.

In the 'Add Content to Review' dialog, click an option for how you wish to add content to the review, and then follow the instructions in the relevant section below:

Post-commit reviews
Browse Changesets	Allows you to choose changesets from a Source Code Management (SCM) repository. See Selecting changesets for review below.
Explore Repositories	Allows you to browse for files in a SCM repository. This option only appears when FishEye is installed. See Selecting repository files for review below.
Search for Files	Allows you to search a SCM repository for files or changesets. This option only appears when FishEye is installed. See Searching for files to review below.
Pre-commit reviews
Pre-commit	Allows you to upload patch files to a review. See Adding patch files to a pre-commit review below.
All reviews
Attachments	Allows you to upload any file to a review, including binary files and files outside of a SCM repository. See Adding attachments to a review below.

Click Done to save your changes, without starting the review.

Selecting changesets for review

Click Browse Changesets in the 'Add Content to Review' dialog to add SCM changesets to your review.

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 dialog:

Repository	A list of the repositories that contain the files that can be reviewed. If the repository you require is not in the list then it has not been added to FishEye. Please contact your Crucible/FishEye administrator.
Author	A list of all the authors who have made changes within the repository. When creating a review, this will default if possible to the username of the user authoring this review and will therefore show their changesets.
Branch	This will only show files and recent changes on that branch from the repository set above.
Commit message	Filter for specific commit messages.
Add to Review as	Choose the form of the review. See Choosing the way files are added to the review below.
Scroll to changeset	Allows you to jump to a particular change set by entering its title and pressing Enter.

Select the checkbox next to a changeset ID to add the entire changeset. Note that:

You cannot add individual file revisions to a review, although you can remove them once the changeset is added. Click Remove all revisions from review to remove all.
You cannot add changesets that are entirely svnprops changes (i.e. it has no non-metadata changes). For details, see How do I force reviews to include SVN property changes?

Crucible 3.5 > Adding content to the review > CRU29_changesets.png

Selecting repository files for review

Click Explore Repositories on the 'Add Content to Review' dialog to browse the SCM repositories for files to add to your review:

By default, the folders are sorted by path name but they can also be sorted by last-commit or first-commit.
To select a particular revision of a file, select Load full history... from the revision number list. This will refresh the available options in the list.

Note that:

Empty folders are greyed out.
The 'Cog' menu has options to Hide empty directories and to Hide deleted files.

Crucible 3.5 > Adding content to the review > CRU29_repo_files.png

Searching for files to review

Click Search for Files on the 'Add Content to Review' dialog to search for files to add to your review.
Search is only available when using FishEye with Crucible.

Adjust the search filters to find the files you need. If the simple filters are not enough, consider using EyeQL queries.

Read more about searching your repositories in the FishEye documentation.

Crucible 3.5 > Adding content to the review > CRU29_search_files.png

Adding patch files to a pre-commit review

Click Pre-commit on the 'Add Content to Review' dialog to add previously created patch files to a pre-commit review.

Choose an upload method:

Select file from the file system	Charset – click the edit icon () to choose the character set being used. UTF-8 is the default.
Select file from the file system	Choose File – click to to browse for the file that you want to add to the review.
Paste text from clipboard	Patch text — paste your copied text in this text area.

For more information see Creating patch files for pre-commit reviews.

Crucible 3.5 > Adding content to the review > CRU30_upload_patch.png

Patch anchoring

A short-coming of patches for code review is the reduced context around code changes because the patch does not include all lines of code from the file. Crucible 'patch anchoring' overcomes this by searching for the relevant file content in the connected repositories, and automatically anchoring the patch to the trunk or the branch with the most recent commit activity. Crucible can then seamlessly display more context, as required.

See Using Crucible patch anchoring for more information.

Adding attachments to a review

Click Attachments on the 'Add Content to Review' dialog to add attachments to your review.

You can attach additional files to be used in the review, including binary files, images or code files that are not stored in a version control repository.

Charset	Click to choose the character set being used. UTF-8 is the default.
Choose File	Browse for a file that you want to add to the review.
Upload	Browse for a file that you want to use as the base of a diff with a previously attached file.

To add another iteration of a file, upload a different version of the file with the same filename. It will be added as a new version.

Crucible 3.5 > Adding content to the review > CRU29_attach_files.png

Choosing the way files are added to the review

Click Done once you have finished selecting the required files. The files will be added to your review and the review will be displayed.