Filter Files

File filters allow you to filter the set of files that is displayed in the file list pane. File filters also limit the set of files that project-level operations are applied to. For example, if you define a file filter to display only those files that have an extension of c or h (the filter string would be "c,h" with no quotes), and you then applied a label at the project level, only those files that satisfy the file filter criteria would be labeled. Files which do not satisfy the filter are unaffected.

There are two types of file filters in QVCS: Anonymous and Named. The main difference between them is that named file filters can be saved, maintained, and reused as often as you like, while the anonymous file filters will remember only the last used value for each possible filter criteria.

Anonymous File Filters

You can define a set of anonymous file filters by clicking on the Filter Files toolbar button. The resulting "File Filters" dialog allows you to define and apply filters to the list of files that are displayed. You can define and enable as many of the filters as you like, though some combinations may not make any sense. Any file displayed must satisfy all the currently active filters.

Define File Filter Dialog

This is the dialog which appears when you click the Filter Files toolbar button.

Property filters can only be applied to files that have archives associated with them. The following property filters exist:

Last Edit By

This filter can take a single QVCS user name, or a set of QVCS user names separated by single commas (no white space). Only archives whose most recent check-in was created by one of the QVCS users on the Last Edit By list will be displayed. Note that QVCS user names are case-sensitive: a user named USER1 is different than a user named User1.

With Label

This field identifies a single label string that a file's QVCS archive must contain in order to be displayed. A file whose archives do not contain the given label will not be displayed. Labels are case-sensitive.

Without Label

This field identifies a label string. Only those files whose QVCS archives that don't have the label will be displayed. Labels are case sensitive.

After Label

This filter defines a label string. Only those archives with a tip revision that is newer than the label will be displayed. Note that if a QVCS archive was created after the label was applied, it won't show up when using this filter. In this circumstance, it might be better to use the After Date filter.

Before Date

The "Before Date" filter defines a date in the format defined by the current locale. Only files whose most recent revisions were created before the given date will be displayed. You can filter a range of dates by using this filter in concert with the After Date filter.

After Date

The "After Date" filter defines a date in the format defined by the current locale. Only files whose most recent revisions were created after the given date will be displayed. You can filter a range of dates by using this filter in concert with the Before Date filter.

Locked by

The "Locked by" filter allows you to show just those files that are locked. The filter value can be the * character, in which case the filter shows all locked files, regardless of who holds the lock. Alternately, you can enter a QVCS user or a set of users separated by a single comma (no white space) to show just those files with archives locked by the specified user(s).

Is On Access List

Fill in the edit field with the name of a QVCS user. QWin will display only those files that include that QVCS user on their access list. This filter only supports single user names.

Not On Access List:

Fill in the edit field with the name of a QVCS user. QWin will display only those files that do not include that user on their access list. This filter only supports single user names.

Name filters allow you to show only files that satisfy the name filters. The filters apply to both archived and uncontrolled files.

File Extension

This filter identifies the file extension of those files whose information you want to see. The extension should not include the '.' character, and if you define more than one extension, separate each extension by a single comma (no spaces). For example, to display just .c, .cpp, and .h files, you would define an extension filter of "c,cpp,h" (no quotes). Only those files with the given extensions will be displayed.

Exclude Extension

This filter identifies the extension of those files you wish to exclude from the display. If defining multiple extensions, separate each extension by a single comma. For example, to exclude the display of .obj, .exe, and .pch files, you would define a filter of "obj,exe,pch" (no quotes). Only files without any of these extensions will be displayed.

Simple filters don't require you to define a filter string ? they are simple ON or OFF type filters.

Hide non-controlled files

Enabling the "Hide non-controlled files" filter allows you to hide the display of uncontrolled files that share the same directory as project files. Normally, these files are visible. In some circumstances, showing non-controlled files can be distracting; enabling this filter allows you to hide them so that the display is less cluttered.

Show Obsolete Files

This filter allows you to see any archives that you have marked as obsolete. Normally, obsolete files are hidden from view.

Named File Filters

Named file filters provide an alternate way to limit the set of files that are displayed in the file list panel. You select the named filter that you want to use by using the drop down selection box on the toolbar.

There are 4 built-in filter collections, two of which you are not allowed to edit ("All files" and "All files (including obsolete files)"). You create your own filter collection through the Maintain File Filter Collections dialog. You can name your filter collection anything you want, provided that filter collection name is not already in use.

As you add specific filters to your filter collection, you can choose whether the filter is an 'AND' filter or an 'OR' filter. Filters that are identified as 'AND' filters must all pass in order for the file to be displayed. In addition, 'AND' filters are applied before any of the 'OR' filters are tested.

You maintain the set of named file filters that are available to you by selecting the Reports and Filters→Maintain Named File Filters menu option.

Maintain File Filter Collections Dialog

This is the dialog which appears when you navigate to the Maintain Named File Filters option.

To create a new filter collection, follow these steps:

• Click the "New Collection" button, enter a name that makes sense to you, and select the project you want to apply the filter to. Once you've created the collection, it will automatically be selected in the drop-down selection list.
• Click the "Add..." button to bring up a dialog which will allow you to define a filter. Select a type from the drop-down list, enter the data required for that filter, and decide whether you want it to be an 'AND' or an 'OR' filter. As an example, you could select a "Locked By" filter, enter the filter data "User1," and make it an 'AND' filter; this would result in a filter collection which would show only those files locked by User1, and which satisfied any other criteria you might define.
• Add as many filters as you like to your collection, and click the OK button. You can now select your filter collection from the drop-down selection box in the toolbar.

To edit an existing collection, select that collection from the drop-down selection list, select the filter to edit, and click the "Edit..." button to alter its behavior. You may also remove filters from a collection with the "Remove" button. To delete an entire collection, select it from the drop-down list and click the "Delete Collection" button.

QVCS does not try to verify that the collection that you define makes any sense. For example, you could define a collection that will always produce an empty collection of files (e.g. include file extension .cpp and exclude extension .cpp).

You can have the following filter types within your collection:

File Extension

Use this filter type to include files with a specific file extension. The filter data should consist of just a single file extension without the '.' character. For example, to create a filter that shows only files with the .java file extension, the filter data should be "java" (no quotes). If you want your filter collection to include more than a single file extension (e.g. c, .cpp, and .h), you include multiple File Extension filters within your named collection, one for each separate type of extension. You would also choose for the filters to be the 'OR' type, since you want one extension OR another extension, etc.

Exclude File Extension

Use this filter type to exclude files with a specific file extension. This filter behaves similarly to the File Extension filter except that a file passes the filter only if it is not of the extension defined by the filter's filter data. If you want to exclude multiple file extensions, you must define a separate Exclude File Extension filter for each extension and set each filter to be the 'AND' type.

After Label

Use this filter type to show those files that have revisions that were created after the label defined by the filter data. If the file does not have the label, then it will not pass the filter.

After Label or Missing Label

Use this filter type to show those files with revisions that were created after the label defined by the filter data. In contrast to the 'After Label' filter type, if the file does not have the label, then it will pass the filter, on the assumption that the file itself was created after the label had been applied.

With Label

Use this filter type to show those files that have been labeled with the label string defined by the filter data.

Without Label

Use this filter type to show those files that have not been labeled with the label string defined by the filter data.

After Date

Use this filter type to show those files with revisions that were created after the date defined by the filter data. The date format should match the default date format defined by your locale (your Windows date format preferences).

Before Date

Use this filter to show those files that have revisions that were created before the date defined by the filter data. The date format should match the default date format defined by your locale (your Windows date format preferences).

Locked By

Use this filter to show only those files that have any revisions currently locked by the user whose QVCS username is defined by the filter data.

Exclude Locked By

Use this filter to exclude those files that have any revisions currently locked by the user whose QVCS username is defined by the filter data.

Exclude Obsolete

Use this filter to exclude files that are marked obsolete. When you first create a new named filter collection, the collection is always populated with this filter type. If you want your filter collection to include obsolete files, then you will have to delete the instance of this filter type from your filter collection.

Exclude Uncontrolled files

Use this filter to exclude files that are not under version control.

Toolbar Operations

Get

Check Out

Add

Check In

Undo Check-out

Lock

Label

File Groups

Sort Revisions

Filter Revisions

Filter Files

Compare