Notification rules
You can create new notifications, or modify existing ones. To create a new notification, please complete the following steps:
To create a notification rule, please complete the steps below:
- Navigate to the System Notification - Notification;
- Click New, fill in the form and click Save.
| Field | Description |
|---|---|
| Name | Displayed notification name. |
| Table | Choose the target table for notifications. For example, if you are creating a notification for the Incident, then select the itsm_incident table. |
| Active | Turn this checkbox on if you want this notification to be active. |
| Sys updated by | Information about who has updated the record. |
| When to Send tab | |
| Condition | The condition to meet before sending the notification. Use the Condition Builder to build the filter that will fit your needs most. |
| Inserted | Turn this checkbox on if you want this notification to be sent when a record is inserted into the table specified in the Table field. |
| Updated | Turn this checkbox on if you want this notification to be sent when a record is updated in the table specified in the Table field. |
| Who Will Receive tab | |
| Users | In this field, you can list the users who will receive the notification within this rule. |
| Other | In this field, you can add contacts to subscribe to the incident activities. It can be email-address (for example, user@domain.com), or it can be |
| Send self | Turn this checkbox on if you want to receive this notification too. |
| What Will Contain tab | |
| Subject | The displayed notification subject. |
| Message | The notification body in plain text. |
| Message HTML | The notification template in rich-text format. This field supports HTML tags, placeholders, SimpleOne API methods. You can also use notification variables ${URI} and ${URI_REF} there. Their usage is described below. |
Notification template
To create a notification template, please complete the steps below:
- Navigate to the System Notification → Notification Templates;
- Click New, fill in the form and then click Save.
Notification template form fields
| Field | Description |
|---|---|
| Name | Displayed notification template name. |
| Subject | Notification template subject. Placeholders like ${current:caller} are supported there: current - this variable is stored in the system and kept in the notification rule; caller - this variable is referred to the relevant field of the table specified in the Table field. |
| Table | If the table is specified, then the template will be applicable only for this table; otherwise, it will be applicable for all tables. |
| Message HTML | The notification template in rich-text format. This field supports HTML tags, placeholders, SimpleOne API methods. You can also use notification variables ${URI} and ${URI_REF} there. Their usage is described below. |
| Message text | The notification template in plain text format. |
| Sys created by | Information about who has created the record. |
Sys updated by | Information about who has updated the record. |
Notification template variables
| Variable | Description | Example |
|---|---|---|
${URI} ${URI_REF} | Display a link to the record. URI: The link text is the word LINK or any other word specified. URI_REF: The link text is the display value of the record. | ${URI} Source: Click here to view the issue: ${URI} ${URI} Output: Click here to view the issue: LINK ${URI_REF} Source: Click here to view the inquiry ${URI_REF} ${URI_REF} Output: Click here to view the inquiry: INQ0005555 |
