This page last changed on Jun 29, 2009 by rosie@atlassian.com.

FishEye allows you to search through the repository to find particular changesets or files.

Below we describe the three ways to search:

Quick Search

To use this search, enter your search term in the 'Quick Search' box in the top right hand corner of the FishEye screens.

Screenshot: Quick Search box

You can search for the following:

  • Authors
  • Branch names
  • Commit comments
  • Changeset ids
  • Filenames/paths
  • File content
  • Tags
  • Date (YYYY-MM-DD format, or any substring of that)
  • Added/Removed diff text. Requires a re-index of the repository.h

Results are sorted by relevance, with limited results per page. Click 'Next' to load following pages. Search matches inside the results are highlighted in yellow.

Restricting searches by prefixing database field
You can search matches against a given field, by using a search in this format:

author:anna

This would return all results from the author field that match the string 'anna'.

Searches can be specifically restricted to the following available fields:

  • Author
  • Comment
  • Contents
  • File (You can use Antglobs)
  • Branch
  • Tag
  • Cs
  • Date
  • AddedLine (searches diff text)
  • RemovedLine (searches diff text).

Searching for discrete strings with precise case
To search for a specific string that appears discretely, with specific capital or non-capital letters, search with quotation marks, as in the following example:

"Monkey"

This search will ignore occurrences of the string that appear embedded in other strings, have different case, or are part of a path or disk location. The example above would not return "ProjectMonkey", "monkey", or "/zoo/mammals/monkey/archie/".
Note that regular quick searches do not take case into account and phrases cannot be searched in Quick Search at present.

File content Quick Search and Diff Text searching are new features in FishEye 1.6 and will continue to be improved. If you want access to full diff text and historical file contents in the repository, you will need to re-index it.

A note about searching multiple repositories:
Cross-repository searching has a 5-second limitation on searches, to prevent it from becoming unresponsive and consuming server resources on FishEye instances that have large numbers of repositories. This means that cross-repository quicksearch is not an exhaustive search, and may not include all repositories in a large Fisheye instance. Preference is given to repositories with the most recent changes. For exhaustive searches, you should:
  1. Limit your search to a particular repository, if possible.
  2. Perform a full search, rather than a QuickSearch.

Simple Search

To access the simple search screen, click the 'Query' sub-tab when browsing a repository .

Screenshot: FishEye Simple Search panel

You can use this search to retrieve a list of changesets/files using the filters that are available. You can search using one or more of the following filters:

  • Commit comments
  • Contents of files — files must be non-binary, less than 5MB, and located on the trunk/head
  • Added text/removed text
  • File names/paths — Antglobs can be used
  • Authors
  • Branch names
  • Tag names
  • Revision dates before and after.

Results can be grouped by the following:

  • Changeset
  • Revision
  • File
  • Directory.

You can choose to include any or all of the following fields in the results:

  • Path
  • Revision
  • Author
  • Date
  • Comment
  • Changeset
  • Total lines
  • Total lines added
  • Total lines removed
  • Tags
  • Reviews (if you are using Crucible).

The results are shown in a tabular format. You can link to the search results, and you can save the results to a CSV file.

Advanced Search

In some circumstances the results of a simple search may not be specific enough. Using the advanced search, you can create your own complex searches using FishEye's powerful query language called EyeQL.

Screenshot: FishEye Advanced Search

To do an advanced search, click the 'Switch to EyeQL Search' link found at the bottom of the Simple Search screen.

Use Simple Search to build your basic query first

You can flick between Simple and Advanced Search. The EyeQL statement will contain the basics of the statement and you can adapt it as required.


Document generated by Confluence on Jul 06, 2009 21:40