Crucible has a powerful search engine that allows you to find reviews. There are two methods for searching in Crucible:
|
Using the Quick Search
Before you begin:
- The Quick Search will also return changesets and files, if you are using FishEye with Crucible. For information on searching FishEye, see Searching FishEye in the FishEye documentation.
To search Crucible using the Quick Search:
- Enter your search criteria in the search box in the Crucible header (Quick Nav). Crucible offers a number of parameters and functions that you can use to refine your expected results, see Refining your Quick Search Criteria below.
- "Quick Nav" results will appear in a dropdown, as you type. "Quick Nav" will attempt to match against the review name, project and user.
- If you want to use a quick nav result, use the up- and down-arrows on your keyboard and press enter or use your mouse to select the item.
- If the quick nav results don't have what you are looking for, press enter to run a search. Ensure that no items in the dropdown are selected when you press enter.
- The Quick Search results page will be displayed. You can filter your results further, as described in Filtering Quick Search Results below.
Results are sorted by relevance and boosted if they were edited recently. A maximum of 10 results are displayed per page.- If you have integrated your Crucible instance with a JIRA instance, you can display a summary of any JIRA issues referenced in your search results by hovering over the issue key. For more details, see JIRA Integration in Crucible.
- If you want to run another search, enter your new criteria in the main search box or in the search box in the header.
Note, only the search box in the header provides "quick nav" results.
Screenshot above: Quick Search displaying "quick nav" matches
Refining your Quick Search Criteria
The Crucible Quick Search has a number of powerful tools that you can use to refine your search criteria before executing the search.
Search Tool | Description | Example |
---|---|---|
Field Handles | Use a field handle in your criteria to restrict your search to a particular field. Note, you cannot have multiple field handles in a query.
| |
Searching for Discrete Strings | Enter a specific string within quotation marks and Crucible will match against the exact string. Note, this search is not case-sensitive. | Enter " |
Filtering Quick Search Results
Once you have a set of search results on the Quick Search page, you can filter them to a subset of the original results. The filter controls are in the left panel of the Quick Search page in the 'Source' section.
Filter | Description |
---|---|
Projects | Select or enter the name of the project that you want to restrict your results to. For example, if you enter 'CR' then the search results page will refresh to display only reviews in the 'CR' project. |
Reviews | Click this link to restrict your results to reviews that have a title, objective, key, linked reviews or linked issues that match the search criteria. |
Comments | Click this link to restrict your results to reviews that have comments that match the search criteria. |
Filtering Reviews
Crucible allows you to view all the reviews/snippets that you are involved with, as well as everybody's reviews/snippets. You can filter these lists to find reviews.
To filter a list of reviews:
- Navigate to the 'Reviews' tab.
- Click the list of reviews that you want to start with, in the reviews sidebar of the 'Review Dashboard', e.g. 'All Open Reviews'.
- Click the 'Custom Filter' in the reviews sidebar.
Update the filters with your search criteria (see table below) and click 'Apply Filter' to filter the reviews.
Filter
Description
Title
Find reviews by searching for words within the title.
Project
Find reviews under a particular project.
Author
Find reviews moderated by a particular authors.
Moderator
Find reviews moderated by a particular moderators.
Creator
Find reviews created by a particular creator.
Reviewer
Find reviews that are reviewed by a particular reviewer. This will default to the user logged in.
Reviewer Status
This is reliant on the above filter and is used to show reviews that have either been completed by the reviewer, not completed or all reviews.
Match Roles
To use all the above filters, choose 'all'. To use any of the filters, choose 'any'.
Review state checkboxes
Check any of the review state checkboxes (e.g. 'Draft', 'Pending Approval') to filter for reviews in those states.
Searching for Review Comments
To search for review comments:
- Navigate to the 'Reviews' tab.
- Enter your search criteria in the 'Comment Search' section at the bottom of the reviews sidebar.
- Click 'Search Comments'.
The 'Comment Search' page will display your results. You can refine your search using the search criteria on the page:
Project
Find comments on reviews under a particular project.
Comment content
Find comments that contains the specified text.
Review PermaId
Find comments made on the specified review.
After
Find comments made after after a particular date.
Before
Find comments made after before a particular date.
Comment Author
Find comments made by a particular user.
Search Type
You can:
- Tick the 'Defects' check-box to find comments that are flagged as Defects.
- Tick the 'Comments' check-box to find comments that are not flagged as Defects.
Tick neither check-box (or both of them) to find all . ||
Review State
Find comments on reviews that are in a particular state. See Review State Filter (above).
Ranking
Find defects have been given a particular ranking (e.g. 'Major', 'Minor').
Requires Re-Review
Find defects that have been marked as requiring re-review (or not).
Classification
Find defects that have been given a particular classification (e.g. 'Missing', 'Ambiguous').
Screenshot above: Search Comment Filter Options
Displaying Defect Metric Charts for Comment Search Results
Once you have retrieved results for a review comment search, you can click 'Defect Metrics' in the left navigation pane to display defect classification charts.
Screenshot above: Comment Search Results
Notes
Related Topics
Searching FishEye (FishEye documentation)