Notifications

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 create a notification rule, 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, 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 form fields

Notification variables

Specify a notification variable using this syntax:

${variable-name.variable-parameters}

Notification variables

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 ${script:script_name} embedded script tag to the notification rule or to the related notification template. The fields below are available for the script embedding:

• Subject
• Message
• Message (HTML)
• Other

To create a notification script, 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 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);