This documentation relates to an earlier version of FishEye.
View

Unknown macro: {spacejump}

or visit the current documentation home.

FishEye allows you a number of ways to search through the repository to find particular changesets or files.

Methods of searching are described below:

クイックナビ

Quick Nav results appear as soon as you start typing into the 'Quick Search' box in FishEye, before you've pressed Enter to visit the full page of search results. Results are weighted by most recent edit date; files edited within the last twelve months are given greater weighting.

Quick Nav supports the following powerful search features:

CamelCase detection
You can type a string like "UpA" to quickly find a name such as "UnplannedArchitecture". This is a common feature in IDE search systems.

Multiple directory selection
You can type the following: 

common/final/Actions

to find a path like this: 

/src/common/eu/systemworks/specialprojects/final/Actions.java

Results constrained to one repository
When you begin your quick search a page by clicking the 'Source' tab, then choosing a repository (or any page below it), FishEye Quick Nav will only show you results from the repository you're currently browsing. When you're viewing the index of repositories, the Dashboard, or tabs other than the 'Source' tab, Quick Nav will show you results from all the repositories connected to FishEye.

Screenshot: Quick Nav in FishEye

クイックサーチ

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
  • ブランチ名
  • コミット コメント
  • Changeset ids
  • Filenames/paths
  • File content
  • Tags
  • Date (YYYY-MM-DD format, or any substring of that)
  • Added/Removed diff text. (info) Requires a re-index of the repository.
  • Type a CSID to go directly to that page.

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:

  • 作成者
  • コメント
  • コンテンツ
  • File (You can use Antglobs)
  • ブランチ
  • Tag
  • Cs
  • 日付
  • 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/".
(info) Note that regular quick searches do not take case into account and phrases cannot be searched in Quick Search at present.

(info) 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:

  • コミット コメント
  • 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
  • ブランチ名
  • Tag names
  • Revision dates before and after.

Results can be grouped by the following:

  • チェンジセット
  • revision
  • ファイル
  • Directory.

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

  • パス
  • revision
  • 作成者
  • 日付
  • コメント
  • チェンジセット
  • 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.



Log a request with our support team.



Raise an issue for our developers.



See answers from the community.



Blog and update.

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