Quick Connect Sync Engine 5.5 - Administrator Guide

Using workflow alerts

The One Identity Quick Connect Sync Engine provides an email notification service that allows you to inform recipients about the completion of a workflow run.

For each synchronization workflow that includes at least one synchronization step, you can configure multiple alerts. Then, when a workflow run completes, the recipients signed up for the alert receive an email message informing them about the completion of the workflow run. For example, you can use workflow alerts to inform recipients when a workflow run completes with errors.

To manage alerts for a workflow, go to the Workflows tab in the Quick Connect Administration Console, and then click the Manage alerts link below the workflow.

To manage outgoing mail profiles for sending workflow alerts, in the Quick Connect Administration Console, click the Settings menu in the upper right corner, and then click the Mail Profiles.

In this section:

• Creating or editing a workflow alert
• Deleting a workflow alert
• Managing outgoing mail profiles

Creating or editing a workflow alert

To create or edit an alert

1. In the Quick Connect Administration Console, open the Workflows tab.
2. Click the Manage alerts link below the workflow for which you want to create or edit an alert.

   The Manage alerts link is only available on workflows that include one or more synchronization steps.

3. In the Manage Workflow Alerts dialog box, do one of the following:
   1. If you want to create a new alert, click the Add button under the Workflow alerts list.
   2. If you want to edit an existing alert, select that alert in the Workflow alerts list, and then click the Edit button under the list.
4. Use the following options in the dialog box that opens to specify alert settings, and then click OK:
   • When this event occurs. Select an event that will trigger the alert. You can select one of the following:
     • Workflow run completes (with or without errors). Triggers the alert upon the workflow run completion regardless of any errors encountered in the run.
     • Workflow run completes with errors. Triggers the alert only when the workflow run completed with errors.
   • Send email to. Type the email addresses of the recipients to which you want to send a notification email message when the selected event occurs. When specifying multiple email addresses, use a semicolon as a separator.
   • Email message subject. Type the text you want to include into the notification email message subject.
   • Ignore mapping errors. Select this check box if you want the alert to skip mapping errors in workflow runs. This check box is only available when you select Workflow run completes with errors in the When this event occurs option.
   • Ignore non-fatal errors in. Select this check box if you want this alert to skip non-fatal errors in workflow runs. A non-fatal error causes a workflow run to partially succeed. A fatal error causes a workflow run to fail. If you select this check box, you must also select one of the following options:
   • All workflow steps. Causes the alert to skip non-fatal errors in all steps of the workflow.
   • The specified workflow steps. Causes the alert to skip non-fatal errors in the workflow steps you specify in the text box below. Type workflow step numbers separated by commas (example: 1, 3, 5). To specify a range of steps, use a dash as a separator (example: 1, 3, 5-8).

   This check box is only available when you select Workflow run completes with errors in the When this event occurs option.

5. Use the Send email using this outgoing mail profile list to select the settings to be used for sending notification emails generated by the alerts in the Workflow alerts list.

   To configure the current outgoing mail profile, click the Properties button. For more information, see Managing outgoing mail profiles.

6. When you are finished, click OK to close the Manage Workflow Alerts dialog box.

Deleting a workflow alert

To delete an alert

1. In the Quick Connect Administration Console, open the Workflows tab.
2. Click the Manage alerts link below the workflow for which you want to delete an alert.

   The Manage alerts link is only available on workflows that include one or more synchronization steps.

3. In the Workflow alerts list, select the alert you want to delete, and then click the Delete button under the list.

Managing outgoing mail profiles

To create, edit, or delete an outgoing mail profile, in the Quick Connect Administration Console, click the Settings menu in the upper right corner, and then click the Mail Profiles. Then, follow the appropriate procedure below.

To create a profile

1. Click the Add button below the list of profiles, and then specify the settings you want to use. For the descriptions of the settings you can specify, see Outgoing mail profile settings.
2. When you are finished, click OK.

To edit a profile

1. In the list, select the outgoing mail profile you want to edit.
2. Click the Edit button below the list of profiles, and then specify the settings you want to use. For the description of the settings you can specify, see Outgoing mail profile settings.
3. When you are finished, click OK.

To delete a profile

1. In the list, select the outgoing mail profile you want to delete.
2. Click the Delete button below the list of profiles.