Open topic with navigation

Searching and filtering

You can search for files, changelists, workspaces, branch maps, streams, jobs, and labels using filters. Each of these has its own filtering procedure, but there are many shared search and filtering tools, which are described here.

Find files in a depot or workspace

To find a file in the depot or in your workspace:

1. Go to Search > Find File…​.
2. On the Find File tab, under Search in, enter the directory path you want to search. You can drag and drop the file path from the Depot or Workspace tree in the Tree pane.

3. Enter any of the following search criteria:

   • Under Name matches any of the following, select an operator (contains, is, starts with, ends with) and enter all or part of the file name. You can add multiple name match rows.
   • Under Submission date or changelist, enter a date, changelist, or range of dates or changelists.
   • Select Include deleted depot files.

4. Click Find.

   Click a file in the search results pane to view file details.

Find a file, folder, or item in the active tab

1. Click Search > Find or type +F (Windows) or +F (Mac).

2. Enter the search term in the Find dialog.

   You can enter any part of a search term to retrieve results, unless you select Match whole word only. To search in a different tab, you must close the Find dialog, go to the new tab, and reopen the Find dialog for search.

Find specs using filters

You can use filters to find specific labels, submitted or pending changelists, workspaces, and so on. These items are also referred to as' specifications.'

To enter filter criteria for most specification types:

1. Click the Filter disclosure triangle in the upper pane of the specification (Submitted, Jobs, Labels, etc) tab.

2. Enter your filter criteria in the appropriate fields.

   Use the following buttons to add or delete filter rows:

   • To add conditions, click the plus button.
   • To remove conditions, click the minus button.

You can save and reuse filters, and you can also use the Search menu to initiate searches and select saved filters.

For more information about how to find and filter each specification type, see:

• For changelists, Checking in files
• For workspaces, Creating and managing workspaces
• For branch maps, Managing branch mapping
• For streams, Using the stream graph
• For jobs, Managing jobs
• For labels, Managing labels

Customize Depot and Workspace views using filters

You can apply filters to your Depot and Workspace views to hide or show certain files and folders.

To customize a tree view:

1. Do one of the following:

   • Click Search > Filter Depot or Filter Workspace.
   • On the Depot or Workspace tab, click the filter icon .

2. Select one of the following options:

   	Option	Description
   Depot tree	Show Deleted Depot Files	Select to display files that have been deleted from the depot at head revision
   	Hide Deleted Depot Files	Select to hide files that have been deleted from the depot at head revision
   	Tree Restricted to Workspace View	Select to display only folders and files defined in the workspace
   	Entire Depot Tree	Select to displays the whole depot tree
   	Tree Restricted to Depot Type	Click to open the list of depot types, and then select the depot type to display
   	No Folder Filter	Select to clear a folder filter (only applies if you have a bookmark selected)
   	<path to bookmarked folder>	Select to displays only the bookmarked folder and its subfolders in the depot tree
   Workspace tree	Show Files Not in Depot	Select to display files that only exist in the workspace, not in the depot
   	Hide Files Not in Depot	Select to not display files that do not exist in the depot
   	Show Only Files Not in Depot	Select to display only files that do not exist in the depot
   	Show Hidden Files	Select to display any hidden files
   	Do Not Show Hidden Files	Select to keep hidden files from displaying
   	Entire Computer	Select to display the entire computer folder hierarchy
   	Workspace Root	Select to display only the workspace root

   The tree view refreshes to reflect your selection.

Save and reuse filters

To save a filter:

1. Open the Add Filter dialog by doing one of the following:

   • In the filter pane, click the Apply saved filters icon and select Save Filter…​
   • Go to the Search menu and select Save <spec type> Filter…​

2. On the Add Filterdialog, enter a name and folder location for your saved filter.

3. Click OK to save.

To apply a saved filter:

1. In the filter pane, click the Apply saved filters icon or go to th e Search menu and select the filter type that you want.
2. Select a filter from the list.

To manage your saved filters:

1. Open the Manage Filters dialog by doing one of the following:

   • In the filter pane, click the Apply saved filters icon and select Manage Filters…​.
   • Go to the Search menu and select Manage <spec type> Filters…​.
2. On the Manage Filtersdialog, organize your saved filters by adding, deleting, or moving filters and folders.
3. Close the dialog to save your changes.

To clear a filter, click the Clear filter icon or go the the Search menu and select Clear <spec type>Filter…​.

Filter with file paths

You can view jobs, changelists, or labels associated with particular files by entering the file path under Files match any of the following file paths in the tab’s filter pane, or by using the File Path Builder. You can enter either a depot or workspace file path.

To enter file paths directly into the Files match any of the following file paths field, do any of the following:

• Use standard Helix Server file path syntax (//depot/folder/folder/filename or //depot/folder/... ).

  You can use the standard Helix Server wildcards (* and …​) and revision specifiers (@ and #).

  For more information about wildcards and revision specifiers, see "Issuing P4 Commands" in the Helix Core Server User Guide.

• Drag and drop a file path from the Depot or Workspace tree into the field.
• Click the drop-down arrow to view and select recent file paths.

To get help constructing a file path:

1. Click the Construct a file path icon to open the File Path Builder.

2. Build a file path by selecting any one or combination of the following criteria:

   • Folder path in the depot or workspace.

     Click Browse to view the depot and workspace trees and select a path.

   • File name or partial filename, using contains, is, ends with, or starts with.

   • Revision range:

     • All revisions.
     • Revisions starting or ending at a particular revision number, changelist number, label, workspace, or date/time.

     • Revisions ranging between two revision points (revision number, changelist, label, workspace, or date-time).

       You can browse for changelists, labels, and workspaces.

       As you enter or select values, the resulting file path appears in the Path preview: field.

3. Click OK.

   The file path that you built appears in the Files match any of the following file paths:field.

   All results that meet the search criteria appear in the search results window below.