Adding text restrictions

Restrictions are criteria that files must meet to be included in reports, filter results, and advanced find results. You set restrictions when you add reports, add filters, or perform an advanced find.

Text restrictions limit results to files that do or do not include a specific text string or regular expression. These restrictions are used to locate files based on filename, check out location, check out computer, and other text-based information. For example, you can create a restriction to find files checked out to C:\Design.

Preconditions, which are similar to restrictions, are used in triggers and email notifications. The following information also applies to preconditions.

1. Select a restriction.

The Restriction dialog box opens.

2. Select does or does not to indicate if the files include matching text.

3. Select a matching option.

Match includes files with text that matches the specified text string.
Match regular expression includes files with text that matches the specified regular expression.

4. Enter the value or regular expression.

Surround SCM supports Perl-style regular expressions. See Using regular expressions.

You can use wildcards in the search value, even if the match regular expression option is not selected. Use an asterisk (*) to search for zero or more occurrences of the previous character. Use a question mark (?) to search for zero or one occurrences of the previous character. For example, in a filename restriction, *.cpp finds all files with a .cpp extension.

5. If you entered text, select Match case to match the case of the text.

6. Click OK to add the restriction.