Adding label 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.

Label restrictions limit results to files with labels that do or do not include a label that matches text or a regular expression. For example, you can create a restriction to find all files with the ‘WysiWrite 1.0.0 Build 3’ label.

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 labels that match the specified text string.
Match regular expression includes labels that match the specified regular expression.

4. Enter the text or regular expression.

To select the label from a list, click Browse. Select a mainline branch, select the label, and click OK to add the label to the restriction.

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

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

6. Click OK to add the restriction.