Page History

Notifications keep you updated on the new records, changes, and events in SimpleOne platform. Changes in any field of a task or a whole table may trigger outgoing notification emails. Use notification rules described below to define who receives information about particular changes in the system, and the scope of that information. 

SimpleOne has a set of out-of-the-box notifications: see the Available Notifications article to learn about them.

Notification rules

Notification rules are used when you need to set up notification sending rules, depending on various conditions, or in case of the event happened.

You can create new notification rules, or modify existing ones. To  

To create a notification rule, please complete the steps below:

1. Navigate to the System Notification → Notification Rules.
2. Click New and fill in the fields.
3. Click Save or Save and Exit to apply the changes.

Notification Rule

form fields

Use cases

We need to configure a basic notification for the Employee table, which implements the following logic:

• When a new employee is added, all employees receive a notification.

We create a notification rule as below:

Notification template

Notification templates are beneficial to pattern the notification process, being a very flexible tool. They provide a possibility to develop templates for different tasks and cases.

To create a notification template, please complete the steps below:

1. Navigate to the System Notification → Notification Templates.
2. Click New and fill in the fields.
3. Click Save or Save and Exit to apply the changes.

Notification template Template form fields

Notification variables

Specify a notification variable using this syntax:

${variable-name.variable-parameters}

Notification variables form fields

Scripting for notifications

Email scripts allow for business rule-like scripting within an outbound email message.

With them, you can change the email output of your system based on various criteria, Mail scripts allow performing simple tasks, such as displaying issue data, and the complex ones, like making advanced DB queries,

Notification scripts

Use the notification scripts  to dynamically change the parameters of the outgoing messages using the SimpleEmailOutbound class. 

You can use the same script in multiple email notifications and notification templates. To do so, add a Add a ${script:script_name} embedded script tag to the notification rule or to the related notification template record body. The fields below are available for the script embedding:

• Subject
• Message
• Message (HTML)
• Other.

To create a notification script, please complete the steps below:

1. Navigate to System Notification → Notification Scripts.
2. Click New and fill in the fields.
3. Click Save or Save and Exit to apply the changes.

Notification Scripts Script form fields

To receive the values of the current and event objects, use dot-notation to address the properties relating to the column names and the current and sys_event tables. See the example below:

(function runNotificationScript(
    /* SimpleRecord */ current,
    /* SimpleTemplatePrinter */ template,
    /* SimpleEmailOutbound */ email,
    /* SimpleRecord */ event
    ) {

    email.setSubject(current.number + '- additional comment has been added');
    email.setBody(`A comment from: ${event.sys_created_by.display_name}: "${event.param_2}"`);

    if (current.days_count > 3 && !current.requester.vip) {
        email.addAddressCc(current.requester.email, current.requester.display_name);
    }

})(current, template, email, event);