Email Notification Actions

Email Notification Actions

Overview

You can create one or more Email Notifications for any Universal Controller task. For workflow tasks, you can also specify whether you want the email to be triggered by the workflow itself, the workflow and/or its tasks, or by the tasks only.

In order to generate Email Notifications, there must be an Email connection defined, which provides the Email server name and other pertinent information.

Notifications Based on Events

You can generate notifications based on one or more of the following events associated with the task instance of the task for which you create the notification:

  • Status or statuses of the task instance

  • Exit code(s) generated by the program (along with at least one status)

  • Late start

  • Early or late finish

Notifications Based on Status

You also can generate notifications based on the status of:

Creating an Email Notification

Step 1

Display the Task Details of the task for which you are creating the Email Notification.

Step 2

Click the Actions tab. A list of any defined Actions for that task displays. 

Step 3

Click the

 button that displays on the Email Notifications row. The Email Notification Details pop-up displays.
 Using the field descriptions, below, as a guide, complete the fields as needed. 



 
For Workflow tasks, the Email Notification Details includes the Action Inheritance field:
 

Step 5

Click the 

 button to save the record in the Controller database.

Step 6

If appropriate, repeat these steps for any additional Email Notifications you want to create.

Email Notification Details Field Descriptions

The table below describes the fields and buttons that display in the Email Notification Details.

Field Name

Description

Field Name

Description

Action Inheritance

Status

The status of this task, by itself or together with an exit code, that will trigger this Email Notification action. You can specify as many statuses as needed.

Exit Codes

On Late Start

On Late Finish

On Early Finish

On Projected Late

Description

Description of this action.

Action Criteria

This section contains criteria for performing the action.

Action Details

This section contains additional details about the action.

Email Template

Email Template Variable

Email Connection

Reply-To

To

CC

BCC

Subject

Body

Report

Report to attach to this notification.

Report Variable

List Report Format

Report format

Options: 

  • PDF

  • XML

  • JSON

  • CSV

  • TSV

If the attached report is not a List type report, this option will be ignored. 

Attach Local File

Local Attachments Path

Local Attachment

Attach Standard Output

Attach Standard Error

Attach Remote File

Attach Job Log

For z/OS tasks only; attach any job logs generated by the associated task.

Start Line

Number of Lines

Scan Text

File Name

Buttons

This section identifies the buttons displayed above and below the Action Details that let you perform various actions.

Save

Saves a new Action record in the Controller database.

Save & New

Saves a new record in the Controller database and redisplays empty Details so that you can create another new record.

Save & View

Saves a new record in the Controller database and continues to display that record.

New

Displays empty (except for default values) Details for creating a new record.

Update

Delete

Refresh

Refreshes any dynamic data displayed in the Details.

Close

Closes the Details pop-up of this action.