Alerting using notifications

Notifications are used to make sure the right people and right systems get notified when a problem occurs.Create a notification to specify that whenever a critical transition of a classifier state occurs, a contextual message is created and sent through a notifier.

Notifications use notifiers which leverage data integration routes. As such an infinite variation of notifications can be created:

  • Emails
  • Events in an internal alerting system
  • SMS
  • Web-service messages
  • ...

To create or configure a notification, you must have the Notification right.

Access the Notifications screen

From the HTML view, on the main menu, click the Notifications icon.

Create a notification

Details area (1)

To create a notification, provide the following information:

  • The notification name
  • The notification key: If left empty, the key will be the same as your notification name. 
  • The notification startup policy: If it must be started manually or if it is started automatically at node startup.
  • The classifier on which the notification is based: the notification will intercept every update of the selected classifier and then will process it according to your transitions rules.

When you create a notification, you are asked to select a classifier. Once the notification is saved, you will not be able to select a different classifier for your notification. To use a different classifier, create a new notification instead. 

Notification context (2)

A notification is triggered whenever the state of its assigned classifier attribute transitions.  With the classifier attribute value, you only see the final state of the transition. You may want to have additional context information like the initial state of the transition or other attribute values of the entity that holds the classifier attribute.

To do so, click the "Add attribute" button. A pop-up screen opens to display all the attributes of the entity that holds the classifier attribute.

To select an attribute, click its row. The attribute is added to the notification context. 

By default, an attribute value is queried at the instant when the classifier state transition occurs. If you want to query a value the instant just before you must select "at previous instant". This is useful to query the initial state of the classifier transition.

To remove an attribute from the notification context, click its trash icon.

Attributes from other entities

If you'd like to query the value of an attribute from another entity, click on the "Add attribute" button. In the attribute selection dialog, click the '+' sign of the selection context entity above the attributes list: 


The entity path selection popup is displayed.

In the list of available entities, select an entity to construct your path. Each time you select an entity, it is added at the top of the dialog and the available entity list is refreshed from your selection.

Then when clicking the select button, the attribute selection dialog displays all attributes available from the selected path.

Query Delay

The values of the attributes of the notification context are not queried immediately when the notification is triggered. As some of these attributes are computed, the query is delayed to allow the attributes to be calculated.

Configure the notifiers (3)

Notifications can monitor two types of transitions:

  • Alert raising (Raise when)
  • Alert cleaning (Clear when)

For each transition type, you can select which notifier to call and fill in its parameters. In the screenshot at the top of the page, only a mail notifier is available. 

To choose which transition should trigger a notification, check the box that meets your alerting conditions.

The icons on the first column  represent the initial state of your classifier while the icons on the first row represent the new state of the classifier.

A state transition should be selected either for raise or for clear, never for both. When a state transition is already checked elsewhere its icon is 

For example, to send an alert email when the status of payment changes from green to red and from orange to red:

  • Select the corresponding checkboxes in the Raise when area.
  • Implement the email notifier in the Raise when area:
    • Check the mail checkbox.
    • In the To field, enter the relevant email address that should receive this notification.
    • In the Message field, enter the body of the email.

You can reference values from the notification context in your notifiers by adding two {braces} around their alias.

Manage notifications


A notification can be in two states:

  • Started – The notification is up and running. Changes in the state of your classifier are intercepted and messages are forwarded to the specified notifiers.
  • Stopped – The notification is no longer intercepting changes in the state of your classifier. Nothing is forwarded to the notifiers. There is no catchup of the events that occurred when a notification is stopped. They are ignored once and for all.

If an error occurs when you start or stop a notification, a question mark icon is displayed right of the action icon. Hover over the the icon for a description of the issue. 

If you have more than one notification, and would like to start or stop several of them at the same time, you can select all the notifications you need, then click the Start or Stop hyperlink.

See also

For more information about how to set up notifications and notifiers from a data integration standpoint, see also Notifications and notifiers.

Related Links