Site announcement

We are switching off article comments on this website. Read about the upcoming changes to Atlassian Documentation.

Skip to end of metadata
Go to start of metadata

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

Use Quick Search

Simply enter your search criteria in the search box in the FishEye header to search across file, repository, committer and user names, as well as commit messages and reviews ( if you are using Crucible with FishEye).

  • Use search tools and filters to refine your results. See Refining your Quick Search Criteria and Filtering Quick Search Results below.
  • Results are weighted by edit date; files edited within the last twelve months are given greater weighting.
  • There is a 100-repository limit on searches, to prevent FishEye becoming unresponsive when there are 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
  • If FishEye is integrated with JIRA you can see a summary of a JIRA issue in your search results by hovering over the issue key. See JIRA Integration in FishEye.
  • See also Searching Crucible in the Crucible documentation.

Refine 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 pattern to find matching files and directories.

BooQCTest returns results like BooleanQueryCoordTest

and BooleanQueryClassTest.

Path/File pattern matching

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

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

Use AntGlobs to search 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 phrases

Enter a phrase in quotation marks.

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".

Filter 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, see details below.

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, see details below.

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.

Use 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.

  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.

Specify criteria using the 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.

Specify criteria using EyeQL

Advanced Search also allows you to run searches using FishEye's powerful EyeQL query language.

Click Switch to EyeQL Search at the bottom of the 'Search Criteria' panel.

See the EyeQL reference guide for more information. If you're unfamiliar with EyeQL, consider using the Standard Search Interface to build your initial query, then switch to EyeQL to modify that.

7 Comments

  1. Our BAs need to search a specific set of property files in our CVS repository for property names...I've found that the content:_searchtext_ syntax returns search results in a nice visual format...

    http://i.imgur.com/4etO3z0.png

    but it searches all files.. 

     

    I was trying to craft a query that uses simple search to do this... e.g. file:App*Config*.properties content:search_text  but I've found that I can only search for a filetype or for content.. not both.. is there a way of specifying this search criteria... 

    If I use advanced search I can use the file name and contents fields to specify what I want.. but the search is obviously harder for non-technical ppl... and the results format is also less than ideal: no in-line preview and clicking the search results navigates the user to the revisions view which does not show the source

    http://i.imgur.com/0VlKGO1.png

    if the simple search could be made to support multiple fields that would be excellent... also the advanced search could use some improvements... 

  2. Anonymous

    Can we have advanced search on all repos?

  3. Anonymous

    Search in content is case sensitive and search whole word only... with QuickSearch or Advanced search.

    It's almost impossible to find methods or properties name, without knowing the exact camelcase name.

    A non-case sensitive, whole word and wildcard (? * **) option whould be welcome...

  4. Anonymous

    I find the opposite - search in content is always case-insensitive. This is a problem when you're doing something like:

    content matches "thE"

    case-insensitive search throws back over a thousand matches, a case-sensitive search would return about 3.

    Ideally there would be some way to choose whether a search was sensitive or insensitive, either by changing keyword (matches vs imatches or similar) or by modifying the search string ("(?i)thE" or similar).

    Any chance of something like that being possible?

  5. Hello,

    How to search more number of JIRA issues in fisheye, currently im using below one to search only one issue but how would i use it for more number of issues.

     

    select revisions from dir "/" where comment Matches "LIQ-48084" order by date  desc  group by changeset return path, revision, author, date, csid

     

     

    1. Hi, have you seen the EyeQL page here: EyeQL Reference Guide?

    2. Hi,

      To select more than one story Id from JIRA:

      select revisions from dir "/" where comment =~ "(LIQ-48082)|(LIQ-48084)" order by date  desc  group by changeset return path, revision, author, date, csid