Global - Notifications
A notification is a Task that is stored once on the Server and run from the Flow of any Job or Task. A typical notification is an Email Task that reports a failure. Use a notification when several Jobs or Tasks should do the same thing on an event: when you change the notification, every Flow that runs it uses the new settings.
This page covers the Manage Notifications window, the window where you add and edit a notification, the Variables you can use in a notification, what to check when a notification does not run, and the Notification log.
To open the window, click Server -> Global objects -> Notifications. The Settings icon next to the notification list in Job Flow and Task Flow opens the same window. Load Balancing actions can also run a notification.
Manage Notifications window

The grid lists each notification with the icon of its Task type and its Name, sorted by name. Double-click a notification to edit it.
The toolbar has these commands:
- Add: choose the Task type of the new notification
- Edit: edit the selected notification
- Delete: delete the selected notifications
- Clone: copy the selected notification, see Clone or delete a notification
- Audit log: open the Audit log for all notifications
Right-click a notification for these commands:
- Add, with the Task types as a submenu
- Edit and Delete
- Audit log: the Audit log for the selected notification
- Versions..: the version history of the notification
- Object relations: the Jobs and Tasks whose Flow runs the notification, see Object relations
- Notification log: the Notification log for the selected notifications
- Export ...: export the selected notifications with Export settings
- Send to connection ... and Send to server connection ...: send a copy of the notification to another VisualCron Server
Press Delete to delete the selected notifications, or Ctrl+A to select all of them.
Add or edit a notification
- In the Manage Notifications window, click Add and choose the Task type.
- On the Main settings tab, change Name to a name that says what the notification does, for example "Email ops on failure". A new notification is named after its Task type, for example "Email - Send", so several notifications can otherwise look the same in the Flow list.
- On the tab named after the Task type, fill in the settings of that Task. See the page for that Task.
- Click OK.
The Add/Edit Notification window has these tabs:
- Main settings: Task type (choose a Task type from the list, or type in the search box to find one), Name and Encoding
- The Task type tab: the settings of the Task, including any Connection or Credential it uses
- Output: only for Task types that have output settings, for example SQL or Web Service. See the page for that Task type
Click Variables in the status bar to insert a Variable, see Variables.
When you edit a notification, the window shows the link Copy Notification id. Click it to copy the notification's Id to the clipboard. Right-click it to change the Id: enter the new Id, which must be a GUID. VisualCron shows how many objects refer to the notification. Click Yes to change the Id and update the Jobs and Tasks that use it, No to see the list of objects first, or Cancel. If another notification already uses that Id, VisualCron asks for a different value. The new Id is saved on the Server as soon as you click Yes; clicking Cancel in the Add/Edit Notification window does not undo it. Scripts or API calls that use the old Id are not updated.
Clone or delete a notification
Clone opens a copy of the selected notification, with all its settings, in the Add/Edit Notification window. The copy gets a new Id and is saved when you click OK. It has the same name as the original, so change the name to tell them apart. Jobs and Tasks that run the original keep running the original.
When you delete a notification that other objects use, VisualCron tells you how many objects use it. Open Object relations to see them before you delete.
A Flow action that runs a deleted notification runs nothing. Change those Flows to run another notification before you delete one.
Run a notification from Flow
In the Flow of a Job or a Task, choose the event, for example On error, and select Run Notification with the notification to run. See Job Flow and Task Flow. This example shows a Job's Flow that runs the notification "Email - Send" on error:

Variables
You can use Variables in any field of a notification. The notification runs as its own Task, started by the Flow of a Job or a Task. This decides what the Variables refer to:
{JOB(Active|<property>)}: the Job whose Flow ran the notification, or the Job of the Task whose Flow ran it{TASK(PrevTask|<property>)}: the Task whose Flow ran the notification. In a Job's Flow, this is the last Task that ran, or for On running longer than the Task that is still running. In the Variables window, choose PrevTask (previous or last context sensitive Task) to insert it{TASK(Active|<property>)}: the notification itself
For example, an Email notification run on On error can use the subject {JOB(Active|Name)} failed and the body {TASK(PrevTask|Name)}: {TASK(PrevTask|StdErr)}. StdOut and StdErr have a value only if that Task stores its standard output or standard error, see Task - Main Settings.
The values of the Task that ran the notification are current only for events after that Task has run, such as On success, On error and On complete. For On start and On running longer than, they still hold the values of the Task's previous run.
A notification run by a Job's Flow on On start runs before any Task of the Job. {TASK(PrevTask|...)} then returns the values of the notification itself.
When a notification does not run
- Check that the Flow of the Job or Task has a Run Notification action for the event that happened, and that the action's condition, for example Always or If exit code, matches. See Run a notification from Flow
- Check in Object relations that the notification is still used by that Flow. A Flow action that runs a deleted notification runs nothing
- Open the Notification log. If the run is listed, check Exit code and Output (error)
Notification log
The Notification log shows each run of a notification: when it ran, which Flow event ran it, and its exit code and output. To open it, right-click one or more notifications in the Manage Notifications window and click Notification log. The window title is Notification history, followed by the notification's name when you open it for one notification. The Historic - Notification tab of the Log window shows the same log. There you can also limit it to a Job and a Task, and the grid has no Job name and Task name columns.
Filter the log
- The notification list at the top: a checkbox for each notification. The notifications you selected before opening the log are checked. When you close the list, the dates are reset to the logged runs of the checked notifications and the log reloads. If no notification is checked, the log is cleared
- The Filter.. box at the top of the notification list: type to narrow the list by name or description. The button next to the box clears it
- The two date boxes: the date range, from the first date to the second. When the window opens, the range covers all logged runs of the checked notifications, and those runs are loaded. Each date covers the whole day. If there are no logged runs, the date boxes and Get are unavailable
- Get: load the runs in the date range from the Server
- The Filter... button: show or hide the filter row of the log grid, where you can filter on any column
When every notification shown in the list is checked, closing the list resets the dates but does not reload the log. Click Get to reload it.
Log grid
The newest runs are listed first. The grid has these columns (the order on screen can differ):
- The Task type icon of the notification
- The notification name
- Event time: when the notification started
- Exit code and Execution time
- Output (standard) and Output (error): double-click a cell to open the output, if the notification stored it
- Event type: the Flow event that ran the notification: On start, On error, On success, On complete or On running longer than
- An icon that shows success, failure or still waiting
- Job name and Task name: the Job and Task whose Flow ran the notification. These columns are shown only when you open the log from the Manage Notifications window
- Result: double-click a cell to open the result, if there is one