Email Notifications: Difference between revisions
No edit summary |
|||
Line 6: | Line 6: | ||
Notifications have following settings: | Notifications have following settings: | ||
* '''Name''': | * '''Name''': Describing name for the notification identifying the notification in the list of model's notifications. | ||
* '''To''', '''Cc''', '''Bcc''': | * '''To''', '''Cc''', '''Bcc''': To, cc and bcc recipients for the email message. At least one valid email address needs to be defined in any of these fields. | ||
* Subject | * Subject: Subject of the email message. | ||
* Body: | * '''Body: Body of the email message. The body can be defined as an html document, if ''Body is html'' is checked. | ||
* Model filter: | * '''Model filter''': Model data is filtered using this filter, before the data is used for the notification calculation. | ||
* Measures: | * '''Measures''': | ||
* Criteria: | * '''Criteria''': | ||
* Body is html | * '''Body is html''': When checked, the email body is an html document. If unchecked, the email body is plaintext. | ||
* Priority: | * '''Priority''': Priority of the email message: '''High''', '''Normal''' or '''Low'''. | ||
* From email address: | * '''From email address''': | ||
* Sender | * '''Sender''': | ||
* Reply to address | * '''Reply to address''': | ||
* Dimensions | * '''Dimensions''': | ||
In the fields defining the email message (e.g. To, Cc, Bcc, Subject, Body) it's possible to define measure and dimensions names using syntax '''${name}'''. It's also possible to define any expressions inside the curly brackets. Examples: | |||
Email subject: | |||
<pre> | |||
Process is blocked for total of ${numberOfCases} orders | |||
</pre> | |||
<pre> | |||
Process is blocked for total of ${Count(EventLog.Cases)} orders | |||
</pre> | |||
== Sending notifications == | == Sending notifications == |
Revision as of 23:03, 8 February 2021
Introduction
Notifications send emails messages automatically when there is something notable in the processes. When creating notifications, criteria for sending is defined. Notifications set defined for models, and each model can have several notifications.
Creating notifications
Notifications are edited in Email notifications dialog that can be opened in the models list by first selecting Notifications. Defining notifications requires at least project Designer or Administrator permissions (GenericWrite permission).
Notifications have following settings:
- Name: Describing name for the notification identifying the notification in the list of model's notifications.
- To, Cc, Bcc: To, cc and bcc recipients for the email message. At least one valid email address needs to be defined in any of these fields.
- Subject: Subject of the email message.
- Body: Body of the email message. The body can be defined as an html document, if Body is html is checked.
- Model filter: Model data is filtered using this filter, before the data is used for the notification calculation.
- Measures:
- Criteria:
- Body is html: When checked, the email body is an html document. If unchecked, the email body is plaintext.
- Priority: Priority of the email message: High, Normal or Low.
- From email address:
- Sender:
- Reply to address:
- Dimensions:
In the fields defining the email message (e.g. To, Cc, Bcc, Subject, Body) it's possible to define measure and dimensions names using syntax ${name}. It's also possible to define any expressions inside the curly brackets. Examples:
Email subject:
Process is blocked for total of ${numberOfCases} orders
Process is blocked for total of ${Count(EventLog.Cases)} orders
Sending notifications
Notifications can be sent either manually in the Email notifications dialog or by using the Model.TriggerNotifications function.
Notifications can be triggered using a script as follows:
(SELECT 'AnalysisType', '33') UNION ALL (SELECT 'ContextType', 'Generic') UNION ALL (SELECT 'Configuration', '{"Root":"ModelById(123).TriggerNotifications([""Notification 1"", ""Notification 2""])"}') --#GetAnalysis