Adding external issue tracking attachment 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.

External attachment ID restrictions limit results to files attached to items in integrated external issue tracking tools, such as Bugzilla, that match or do not match a specific text string or regular expression for the attachment ID. For example, you can create a restriction to find files attached to a bug in an issue tracking tool with ID 10051.

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 the Connection for the issue tracking tool to search.

3. Select does or does not to indicate if the issue ID includes matching text.

4. Select a matching option.

Match includes files attached to issues with IDs that match the specified text string.
Match regular expression includes files attached to issues with IDs that matches the specified regular expression.

5. 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.

6. Click OK to add the restriction.