FishEye has a powerful search engine that allows you to find changesets, committers and files. There are two methods for searching in FishEye:
Using the Quick Search
Before you begin:
- This is the default search and will suggest "quick nav" results (from the header search box only). Results are weighted by most recent edit date; files edited within the last twelve months are given greater weighting.
- There is a 100-repository limitation on searches, to prevent it from becoming unresponsive on FishEye instances that have large numbers of repositories. FishEye will also limit the search to the specific repository that you are looking at, if you are already navigating within a specific repository
- The Quick Search will also return code reviews, if you are using Crucible with FishEye. For information on searching Crucible, see Searching Crucible in the Crucible documentation.
To search FishEye using the Quick Search:
- Enter your search criteria in the search box in the FishEye header (i.e. Quick Nav). FishEye 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 file name, repository, committer and username.
- 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 FishEye 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 FishEye.
- 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.
Refining your Quick Search Criteria
The FishEye Quick Search has a number of powerful tools that you can use to refine your search criteria before executing the search.
CamelCase Pattern Matching
Enter a CamelCase string pattern to find files and directories that match.
Path/File Pattern Matching
Enter a path/file pattern to find files and directories that match.
Use a field handle to restrict your search to a particular field:
Search within a Directory (AntGlobs)
AntGlobs can be used in the Quick Search to search within a specific directory.
Search for Discrete Strings
Enter a string in quotation marks to find the exact string. Not case-sensitive.
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.
By default, searches across all repositories.
Choose a repo to restrict the search to just that one. For example, if you enter 'FE' then the search results page will refresh to display only files and directories in the 'FE' repository.
Files and directories
Filter your results to files and directories that have names that match the search criteria.
Filter your results to changeset comments that match the search criteria.
Filter your results to diffs (lines added/removed) that match the search criteria.
Filter your results to files that have content that match the search criteria.
Filter your results to committers that match the search criteria.
|All projects||When using Crucible with FishEye, there is a 'Reviews' section. The All projects dropdown allows you to filter reviews returned in the search results. See Searching Crucible.|
|Reviews||Search in reviews|
|Comments||Search for review comments|
|Last modified||Filter by the date of the last change.|
|Author||Filter by author name.|
Using the Advanced Search
The Advanced Search can only be run against a specific repository, however you can specify more precise criteria against a number of fields for that repository.
To search a FishEye repository using the Advanced Search:
- Navigate to the repository that you want to search, as described in Browsing through a repository.
- Click the Search tab.
- Enter your search criteria:
- Standard Search — Fill in the desired fields in the 'Search Criteria' panel. See the Specifying Search Criteria using the Standard Search Interface section below for more details.
- EyeQL Search — Enter your "EyeQL" query. See the Specifying Search Criteria using EyeQL section below for more details.
Use Switch to EyeQL Search and Switch to Standard Search at the bottom of the 'Search Criteria' panel to toggle between the two search methods.
Specifying Search Criteria using the Standard Search Interface
The Advanced Search interface allows you to specify search criteria for multiple fields, order the results, group the results and choose the display fields in the results. You can link to the search results, as well as save the results to a CSV file.
Please note the following:
- Contents — Files must be non-binary, less than 5MB, and for svn repositories on trunk only. Only HEAD/tip revisions are searched. For older revisions, use the added/removed text search criteria.
- File names — Antglobs can be used to specify the criteria for this field.
Specifying Search Criteria using EyeQL
The Advanced Search also allows you to run searches using FishEye's powerful query language, EyeQL.
Click Switch to EyeQL Search at the bottom of the 'Search Criteria' panel.
For information on how to construct an EyeQL query, see the EyeQL Reference Guide. If you haven't built an EyeQL query before, we recommend that you use the Standard Search Interface interface to build your initial query, then switch to EyeQL to modify that query.
Screenshot: Advanced Search Criteria — EyeQL Interface