How to configure and use the Alerts app for SharePoint Online by Accelerator 365
The Alerts app from Accelerator 365 displays important notifications to your users. Display alerts in a web part on any part of your SharePoint page or prominently inject an alert above the navigation across entire SharePoint sites.
Jump to
- Recommended setup considerations
- Configuring the app for the first time
- Create an alert
- Display an alert:
Recommended setup considerations
The Alerts app stores its data in SharePoint lists. This includes data such as the alerts that have been created, in addition to the users that have dismissed a particular alert (see the Technical details page for further information). These lists, referred to as the "data source", can be created via the web part property pane and do not require manual setup.
We recommend creating the data source on the same site as where the app will be displayed if possible. In some rare scenarios, you may wish to create a single data source and display it on multiple pages, across multiple sites.
Note: only users in the Site Owners group can create a data source.
Note: it is only possible to create one data source per site.
Configuring the app for the first time
The Alerts package contains two web parts - Alerts Directory and Alerts. First, you will need to configure the Alerts Directory.
- If you are not already in edit mode on your page, select Edit on the top right of the page.
- Add the Alerts Directory web part to your page.
- Select the Edit web part button located on the web part toolbar to open the properties pane.
- Select create data source from the first section in the property pane.
- You can optionally enable audience targeting to promote alerts to specific audiences across your site.
Create an alert
Once the Alerts Directory web part has been configured, you will then have the option to create an alert.
- As a user with edit permissions to the Alerts Directory, select the Add alert button that appears on the web part.
- A panel with a form will appear on the right side of the page. Here you can:
- Write an alert message with basic rich text formatting, such as bold, italics, underline, and hyperlinks.
- Select from 5 alert types. Alert types are based on 5 pre-set colours.
- Display an icon with your alert from our icon library.
- Enable/disable the advanced options for an alert to:
- Collapse into a single line
- Scheduled to appear and disappear at a set date and time
- Or be dismissed by users
- Select the audiences to target your alert to.
- Create your alert by selecting the Save option.
Display an alert
There are 3 options to choose from when displaying an alert:
1. In a web part
- If you are not already in edit mode on your page, select Edit on the top right of the page.
- Add the Alerts web part to your page.
- Click on the Configure button on the web part. The web part properties pane will appear.
- Connect to the data source site you created in the Alerts Directory web part.
- An optional setting in the web part properties pane allows you to hide the web part if there are no alerts to display. Enable or disable this option based on your preference.
- Publish the page for users to view your alert.
2. In the Viva Connections Dashboard
Note: this option requires you to have set up the dashboard experience for Microsoft Viva Connections. Further details can be found here.
- Navigate to your Viva Connections Dashboard page and select Edit on the top right of the page.
- Add the Alerts card to your page.
- Select the Edit card button located on the card toolbar to open the properties pane.
- In the properties pane, you can:
- Choose from the medium and large card size
- Enter a title for the card
- Connect to the data source site you created in the Alerts Directory web part.
- Select the audiences to target your card to.
- Publish the dashboard page for users to view your alert via the Dashboard for Viva Connections web part.
3. Across your site
Note: only a user with the SharePoint Administrator role can set up this type of alert due to properties that need to be set in SharePoint.
- Click the Settings icon on the SharePoint suite bar and navigate to Site contents.
- In Site contents, a configuration panel for the Alerts extension will appear at the foot of the page. Click on Configure button
- A property pane will appear, allowing you to connect the Alerts extension to your Alerts Directory to display alerts across SharePoint sites.
You will need to insert a JSON string in the pre-defined format below, replacing the bold items with the SharePoint domain and the site where your Alerts source is located.
JSON format
{
"default":{
"sourceSiteUrl":"https://yourdomain.sharepoint.com/sites/yoursite"
},
"overrides":[
{
"sites":[]
}
]
} - Your JSON will be validated to ensure it is correctly formatted. Click on the Save button to apply the SharePoint properties for Alerts.