Adding email notifications

Add email notifications to be automatically notified of file, code review, or code review file changes. For example, you can add a notification to be informed when files are checked in to a specific branch.

1. Choose Tools > My Email Notifications.

The My Email Notifications dialog box opens.

2. Click Add.

The Add My Email Notification dialog box opens.

3. Enter a Notification Name.

4. On the Trigger When tab, select the events that cause the email to be sent.

5. Click the Preconditions tab to set the condition that files must meet to send the email.

6. Select a precondition.

The Precondition dialog box opens. You can add preconditions based on branch and repository, filename, committed changelists, workflow states, users performing file events, security groups for users performing file events, or custom field values.

7. Enter or select the precondition values.

Preconditions have the same fields used in filter, advanced find, and report restrictions. See Adding restrictions.

8. Click OK.

The precondition values are added. The values are displayed in the conditions list and the Summary field.

9. Repeat steps 6-8 to select any additional preconditions. To change a precondition value, double-click the value in the list.

When you add more than one precondition, Surround SCM treats them as ‘and’ conditions. Triggers only fire when all of the selected preconditions are met.

10. Clear Enabled if you do not want the notification to be active.

11. Select Disable email notification after it runs once if you only want the email to be sent once.

12. Select Consolidate multiple file events into one email to send one email for all files the notification runs on. An email is sent for each file if this option is not selected.

13. Click Edit Email Template to modify the default template. See Editing email templates.

14. Click OK to add the notification.