Introduction

This article guides you through how to set up alert notifications for BPA Platform.

Such notifications can be sent to the system administrator, task owner, or both.

Who Are the System Administrators and Task Owners?

System administrators are the BPA Platform users who have System Administrator selected as their Server Role:

User Properties - Server Roles

Click the image to view full size.


A task owner is the BPA Platform user who created the task:

Task Owner

Click the image to view full size.

When creating BPA Platform users, ensure the Email address field is completed for those users who should receive alert notifications:

User Properties - Email address

Click the image to view full size.

Available Notifications

You can send notifications for the following:

Warning Notifications

Warning Type Description Notify Who?
Task

A problem has occurred during a task run but the task has continued. Note that this scenario is very rare.

The setting of the end-step of the task, whether Continue or Abort, does not affect this notification being sent.

System administrators and task owners
System A problem has occurred in BPA Platform but this hasn’t affected any other functionality. System administrators only
Step

A problem has occurred with a task step but BPA Platform has continued the task anyway.

The setting of the task step, whether Continue or Abort, does not affect this notification being sent.

System administrators and task owners
Security A security error has occurred but this hasn’t affected any other functionality. System administrators only

Error Notifications

Warning Type Description Notify Who?
Task

An error has occurred during a task run which has caused the task to fail.

The setting of the end-step of the task, whether Continue or Abort, does not affect this notification being sent.

System administrators and task owners
System A problem has occurred in BPA Platform that affects BPA Platform from functioning fully, including preventing tasks from running. System administrators only
Step

An error has occurred in a task step during a task run which caused the task to fail.

The setting of the task step, whether Continue or Abort, does not affect this notification being sent.

System administrators and task owners
Security A security error has occurred which affects BPA Platform. System administrators only

How Do I Set This Up?

Note: If running BPA Platform 2020, you must use the BPA Platform Client (classic) to make any changes to the notifications and alerts global configuration.

Only System Administrators can configure system notifications.

  1. Log into the Classic client.
  2. Go to Manage > Options > Notifications tab.

    BPA Platform - Global Options - Notifications tab

  3. Enable the relevant notification types.
  4. From the SMTP panel, enter a "From" name and email address into Display Name and From Address. This is who the emailed notification will look to be from, and must be a valid email address in your SMTP server.
  5. Click Server Configuration and configure the connection details for the SMTP server that the notifications are sent through.

At the time of writing, all task owners and all system administrators who have valid email addresses configured in their BPA Platform account receive all valid warnings and errors that occur.

Sample Scenarios

Scenario Enable ...
Trying to save a file to a location that doesn’t exist Errors > Task or Step
Trying to run a task when the BPA Platform license has expired Errors > System
Trying to save a file with a non-supported punctuation mark in the filename, for example, forward-slash (/). (Save FileClosed The Save File tool saves output from another task step capable of producing document, as one or more files on the local drive, on-premise file server, external server, or cloud based server. actually replaces / with underscores) Warnings > Step
Trying to trigger a task with the Microsoft SQL Server TriggerClosed The Microsoft SQL Server Trigger tool uses the Microsoft® SQL Server™ trigger functionality to create a trigger on a table of a specified SQL data source. When a specified data modification is attempted, such as an attempt to add or delete a table row, the trigger then causes a task to run. tool when the database has been deleted Warnings > Security
Logging into the BPA Platform client with incorrect credentials Warnings > Security