This is the documentation for FishEye 3.2. View the latest version of

Unknown macro: {spacejump}

or visit the latest FishEye documentation home page.

FishEye has a powerful search engine that allows you to find changesets, committers and files. There are two methods for searching in FishEye:

Quick Search

  • Searches across all repositories connected to FishEye.
  • Suggests "quick nav" results as you type.

 

Advanced Search

 

Gives access to the EyeQL query language.

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:

  1. 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.
  2. "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.
  3. 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.
  4. 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.

Tool

Description

Example

CamelCase Pattern Matching

Enter a CamelCase string pattern to find files and directories that match.

BooQCTest returns results like BooleanQueryCoordTest and BooleanQueryClassTest.

Path/File Pattern Matching

Enter a path/file pattern to find files and directories that match.

common/final/Actions returns results like /src/common/eu/systemworks/specialprojects/final/Actions.java.

Field Handles

Use a field handle to restrict your search to a particular field:

  • file — file/directory names
  • commit — commit messages
  • diff — lines added/removed
  • content — file contents
  • committer — committer names

file:build.xml returns files with names matching build.xml.

Search within a Directory (AntGlobs)

AntGlobs can be used in the Quick Search to search within a specific directory.

Search for /src/**/gwt/*.xml and FishEye will return all files with a .xml suffix that are below both a src and a gwt directory. e.g. src/java/com/atlassian/fecru/gwt/FecruCore.gwt.xml but not src/java/com/atlassian/fecru/ApplicationContext.xml

Search for Discrete Strings

Enter a string in quotation marks to find the exact string. Not case-sensitive.

"update version in build" returns matches for the exact string, i.e. it will not return "update build version" or" update version in file".

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

All repositories

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.

Commit messages

Filter your results to changeset comments that match the search criteria.

Diffs

Filter your results to diffs (lines added/removed) that match the search criteria.

Content

Filter your results to files that have content that match the search criteria.

Committers

Filter your results to committers that match the search criteria.

All projectsWhen 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.
ReviewsSearch in reviews
CommentsSearch for review comments
Last modifiedFilter by the date of the last change.
AuthorFilter 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:

  1. Navigate to the repository that you want to search, as described in Browsing through a repository.
  2. Click the Search tab.
  3. Enter your search criteria:

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

 

 

 Except where otherwise noted, content in this space is licensed under a Creative Commons Attribution 2.5 Australia License.