Notifications (alerts)
1. Overview
Notifications offer a way to send email reminders, alerts, or the latest data based on a schedule or under certain conditions. The related dashboard or view is exported and attached as an image, PDF, Excel, or another format.
For example, you can set up a notification that emails your dashboard to your group once a week, or when the latest hourly data indicates a problem. You can also be notified when someone replies to your note.
2. Set up a notification
To create a notification for yourself or others, open an existing view such as a dashboard or report, click Notification in the toolbar, then choose the type of notification you want to create.
3. Types of notifications
3.1. Scheduled
A scheduled notification occurs on a periodic schedule which you define by selecting recurrence and other scheduling options.
Click Define schedule to configure the scheduling options.
Select the Run Immediately option if you want to run the notification immediately upon saving (instead of waiting for the first scheduled event).
3.2. Note
A note-based notification lets you know when a user has added a note (annotation) to a metric set.
Use the dropdown to select the metric set you want to monitor for notes.
3.3. Data driven
A data driven notification occurs when a change in data is detected on a scheduled basis (i.e., polling).
Click Define schedule to schedule when to check for data changes.
Then click Add condition to choose what data changes you want to monitor (e.g., a value increasing for the past 3 days).
Select the Run Immediately option if you want to run the notification immediately upon saving (instead of waiting for the first scheduled event).
3.4. Data correction
A data correction-based notification lets you know when a user has added a measure correction (data annotation) to a metric set.
Use the dropdown to select the metric set you want to monitor for data corrections.
4. Notification options
4.1. Define schedule
This option is used both for scheduled notifications, and for determining when data driven notifications poll for data.
At the top of the Schedule Rule dialog, use the Enabled checkbox to enable or disable the schedule. This is useful if you want to temporarily suspend the schedule instead of deleting the notification.
To adjust the notification schedule for daylight saving time, select your time zone from the dropdown and select the Daylight Savings Time checkbox. Leave this unchecked for a constant interval between notifications.
To define a schedule, first enter the start date and time for the schedule under Start Date.
Choose between one of the following repetition patterns:
- A daily pattern occurs every day or every nth day.
- A weekly pattern occurs weekly or every nth week. You can also indicate the days of the week to include in the schedule.
- A monthly pattern occurs once a month. You can choose which months to include and also which day of the month.
Select the Intra-Day Recurrence checkbox if you want to specify different times within a scheduled day to be part of the schedule. Click Add Occurrence to add a time of day to the schedule.
Finally, decide how the schedule should end under End Date. You can choose to keep the schedule going forever, indicate that it should end after a certain number of occurrences, or enter a specific date to end by.
4.2. Select export content
Notifications export the current view to the format of your choice and deliver it along with the notification.
Click Select export content when creating any type of notification and choose from the available export formats, including:
- Excel
- Image (PNG)
- CSV
- PowerPoint
Depending on the format, you can choose to export the entire view (e.g., dashboard) or a selected data visualization. For more details about export options, see Share or export your work.
You can choose to store the current parameter (filter) settings to be used when exporting content by selecting Preserve Current Parameter Values.
4.3. Set up delivery options
Click Delivery options after selecting export content.
The Delivery Method is initially set to Email the exported content as an attachment, or it can be set to File to place it in a specified location. There may also be other delivery choices if an extension is installed.
4.3.1. Email notifications
By default, the notification is set up with you as the recipient. Click Add recipient to add users, groups or email addresses to email. (Recipients will have the option to Unsubscribe included in the email.)
Enter the subject and body text for your email message in the fields provided, or click Edit template in advanced editor to apply formatting to the email body. Right-click where entering text for a list of available placeholders:
- Recipient name – the user name of the email recipient.
- Creation date – the date when the notification was created.
- User name – the name of the user who created the notification.
- View name – the name of the view (e.g., dashboard or report).
- Embedded image – the exported image (only available if the export format is set to Image).
To customize the export for each user (also known as report bursting), you can use either of the following:
- When adding or editing a recipient, click Customize parameters to set specific filter settings for each. These parameter values will override any set on the dashboard or view.
- Or, when using custom attributes, select the option Export Using Recipient Account, which will retrieve the appropriate data for each recipient when exporting.
4.3.2. Create file
To have the notification delivered as an export file that is placed in a specified folder location, set Delivery Method to File.
Specify a Folder location for storing the generated files, which must be a location accessible to the Dundas BI server such as a folder shared over your network.
The File Name Template is a prefix that will be used to compose the actual filenames.
The File Lifespan option determines whether files from previous notifications are overwritten. If a notification occurs before the file lifespan expired for the previous one, a new file is generated with a different name.
4.4. Data driven condition
The Data Driven Condition dialog is displayed when you add a new condition to a data driven notification. A data condition specifies the criteria for detecting or evaluating changes in data.
Select a Condition Category to determine when to notify the recipients:
- Increases – An increase is detected in the target data.
- Continuously Increases – Regular increases are detected in the target data over a specified period.
- Decreases – A decrease is detected in the target data.
- Continuously Decreases – Regular decreases are detected in the target data over a specified period.
- Enters State – The target data has entered a specified state.
- Exits State – The target data has left a specified state.
- Stays in State – The target data remains in a specified state for the specified period.
- In State(s) – The data is in the specified state.
The state of the data is determined by checking the values against some conditions of your choice.
When monitoring for a value that Continuously Increases or Continuously Decreases, you can either set the Previous Number of Polls that should show a value increasing/decreasing, or set the Hourly Interval to the number of hours during which the value should increase/decrease.
4.4.1. Choose data to monitor
Choose the Visualization and the Metric Set you want to monitor out of the list of visualizations that are currently displayed.
Under Target Cells, click one of the two buttons to choose which numeric data to monitor for changes.
If you click Add target cell, the current data is displayed in a table and you can click directly on the values to monitor. You can add target cells multiple times, or for some conditions click to select an entire column when adding target cells.
Click Add target cell manually to instead select numeric data to monitor according to the filters you set. Select which Measure values to monitor from the dropdown.
A filter will appear for each hierarchy currently displayed by the metric set & visualization, allowing you to choose filter values. For date/time data, you can click the triangular token menu button to the right to choose relative time options such as Today.
4.4.2. State conditions
If you chose a state condition category, expand the States section below to choose the conditions to check the numeric data against.
You can drag states that were already defined as part of the metric set, or click Add custom state to define your own conditions.
Drop or add a state under Target States to monitor data that enters that state (required for Enters State), or Source States to monitor data the exits that state (required for Exits State). When monitoring state transitions, you can optionally choose both a source and target: for example, the figure below shows the configuration for detecting a state transition from the Good state to the Bad state.
4.4.3. Multiple data conditions
Click the submit button at the bottom of the Data Driven Condition dialog when finished.
You can add multiple data conditions for the same notification. With multiple conditions, use the Multiple Condition Operator to indicate whether all conditions (And) or any conditions (Or) must be met for the notification to occur.
5. View or update notifications
Existing notifications in Dundas BI can be viewed and updated by you or your administrator.
5.1. Personal notifications
From the main menu, click Profile to view and edit your user profile.
In the My Profile dialog, scroll down and click Notifications to view a list of your notifications.
You can enable, disable, or run multiple notifications at a time by selecting the notifications and clicking one of these options at the top of the dialog.
Click the Edit icon for a notification to make updates to it.
When you click to edit the notification or one of its options such as Select export content, it will be necessary to open the dashboard or other view that the notification was created from. If not open already, you'll see a dialog telling you this along with its name. Click Ok in this dialog to open the required view and continue, or you can cancel.
5.2. Managing notifications
As an administrator, you can view all of the existing user-defined notifications for this instance.
From the main menu, click Admin, then Account Service, and then Notifications.
Use the controls at the top to search, sort, and filter the list of notifications by tenant, account, or the kind of notification.
Click Edit for a notification in the list to make updates to it.
Alternatively, similar to the personal notifications, an administrator can view the notifications for a user from the user account.
From the main menu, click Admin, then Account Service, and then Accounts.
Click Edit to open the User Account Details panel and click User's Notifications.
Click a notification in the list to make updates to it.