Filters
QVCS-Enterprise filters provide a simple and powerful way to limit the set of files that are displayed by the client application. You select the filter that you want to use by using the drop down combo box on the toolbar. You maintain the set of filters that are available to you by using the View/Maintain Filters menu option.
Selecting that menu option will display the 'Maintain Filter Collections' dialog shown here:

Filters are always applied at the client. This means that the server always sends information on all the files within a selected directory to the client and the client, based on the active filter, decides whether information about that file should be displayed or not.
There are 4 'built-in' filter collections. You are not allowed to edit the 'All files' filter collection. You create your own filter collection by clicking on the 'New Collection' button. You can name your filter collection any thing you want, provided that filter collection name is not already in use. Clicking the 'New Collection' button will display the 'Define Filter Collection Name' dialog:

Each filter collection can be associated with a specific project, or it can be for use by all projects. The build-in filters are for use by all projects.
As you add specific filters to your filter collection, you can choose whether the filter is an 'AND' filter or whether it is 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 can have the following filter types within your collection:
FILE NAME FILTER TYPES:
Include Extension: Use this filter type to include files with a specific file extension. The filter data should consist of just the file extension characters. 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 Include Extension filters within your named filter 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.
Include Regular Expression Filename: Use this filter type in a way similar to the Include Extension filter, except that the filter data defines a regular expression instead of the characters of a specific file extension. See this Sun regular expression tutorial for some information on the formatting of regular expressions.
Exclude Extension: Use this filter type to exclude files with a specific file extension. This filter behaves similarly to the Include Extension filter except that a file passes the filter only if it is not of the extension defined by the filter's filter data.
Exclude Regular Expression Filename: Use this filter type in a way similar to the Exclude Extension filter, except that the filter data defines a regular expression instead of the characters of a specific file extension. See this Sun regular expression tutorial for some information on the formatting of regular expressions.
REVISION DESCRIPTION FILTER TYPES:
Revision description regular expression: Use this filter type as a way to search through all revision descriptions for a string that matches the regular expression that you define. See this Sun regular expression tutorial for some information on the formatting of regular expressions.
Exclude revision description regular expression: Use this filter type as a way to exclude all revisions that matches the regular expression that you define. See this Sun regular expression tutorial for some information on the formatting of regular expressions.
LABEL FILTER TYPES:
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 (include if label is missing): Use this filter type to show those files that have revisions that were created after the label defined by the filter data. In contract 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.
With label and all revisions: Use this filter type when you want to include all the revisions within a file that has a specific label. Typically, you would combine this filter with another filter where the purpose of this filter is to limit the set of files that pass the filter conditions, and the other filter constrains the set of revisions that get displayed.
Without Label: Use this filter type to show those files that have not been labeled with the label string defined by the filter data.
Up to label: Use this filter type to show those files that have revisions that were created before the label defined by the filter data. If the file does not have the label, then it will not pass the filter.
DATE FILTER TYPES:
Checked in after: Use this filter type to show those files that have 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. The generated report will include only those revisions created after the date you define.
Checked in before: 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. The generated report will include only those revisions created before the date you define.
FILE PROPERTIES FILTER TYPES:
Include Locked by: Use this filter to show those files that have any revisions that are 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 that are currently locked by the user whose QVCS username is defined by the filter data.
Include File Status: Use this filter to include only those files that have a 'File status' value that matches the string that you define here. For example, to create a filter that would show only 'Stale' files, you would use this type of filter with a filter value of 'Stale'.
Exclude File Status: Use this filter to exclude those files that have a 'File status' value that matches the string that you define here. For example, to create a filter that would not show 'Current' files, you would use this type of filter with a filter value of 'Current'.
Exclude uncontrolled files: Use this filter to exclude files that are not under version control.
Filesize greater than: Use this filter to show only those files that have a workfile size that is greater than the value you define in the filter data.
Filesize less than: Use this filter to show only those files that have a workfile size that is less than the value you define in the filter data.
Include last edit by: Use this filter to show only those files that were last edited by the user whose value you define in the filter data.
Exclude last edit by: Use this filter to show only those files that were not last edited by the user whose value you define in the filter data.
QVCS-Enterprise 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).
|