Manage Files Tab
The Manage Files tab allows you to select and modify which fils make up the review. There are 3 different tabs under this:
- Changesets
- Files
- Search
Before using the Changeset or File tabs, you can narrow the files down first by specifying constraints:
| Repository | This is 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 | This contains a list of all the Authors that 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 | Will only show files and recent changes on that branch from the repository set above. |
| Tag | Will only show files and recent changes tagged. |
Changeset Tab
Below is an example of the Changeset tab:
By default, Crucible presents a list of the authors changesets in reverse chronological order. You can see other changesets by changing the constraints described above.
Click on the checkbox next to the changeset id to add the entire changeset or the checkboxes next to filenames to add or remove individual files. Click on Remove all revisions to remove them.
Understanding changesets in detail
To help decide what files are to be placed under review, the Moderator can click on the icons next to the files to gain further information about them before they go out for review:
| Clock icon or the file url | A view detailing the history of this particular file. |
| Changeset id next to the File url | A view of the complete file, amended lines are highlighted on the left in yellow. |
| Down arrow icon | Option to download the file |
| Change Indicator (+n -n) | This shows how many lines have been amended (eg: +3 -2) and also what type of change has been made. If it says diffs then you can click on this and it will show the differences in the file between the revisions. |
After the files have been chosen, click on the review tab to see the files that are included in the review.
Files Tab
TIP:If it's not a changeset to be reviewed but specific files, it may be easier to find the files by using the File tab.
To find a file, browse the folders by clicking on the relevant folder. The folders by default are sorted by path name but can sorted by last-commit or first-commit
Empty folders will be greyed out.
If the folders contain empty folders then a toggle option called Hide Empty under the Sort options will appear. This is the same for deleted files by toggling the options Hide and Show, above the file names
To choose a file for reviewing, click on the checkbox to the left of the filename and if required the revision number, to be reviewed.
After the files have been chosen, click on the review tab to see the files that are included in the review.
Search Tab
If the Author is not certain about which changesets/revisions to create a review, then they can use the Search tab instead.
Choose the relevant search filters and then click on the Search button. If the simple filters are not enough to find the relevant changeset/file then click on Advanced Search and an EyeQL query can be created to produce the results.
After the files have been chosen, click on the review tab to see the files that are included in the review.