Push Notifications

Prerequisites

Browser Push Notifications are shown if the following prerequisites are met:

1. Browser Push Notifications feature is available only with DWP subscription
2. Supported browsers:
   • Chrome
   • Firefox
   • Edge
3. Configured and enabled push notifications:
   1. Enabled by DWP Administrator;
   2. Enabled in your Profile (Person settings);
   3. Allowed in your browser.

      Browser Push Notifications feature is not supported for Internet Explorer and Safari browsers.

4. Access to Administration application for push notifications configuration.

5. Access to Matrix42 Push Service. 

6. Matrix42 Account in role "Push Notification Administrators"
   To check and manage access to the Push Service you need a valid Company administrative account: open Matrix42 Accounts page → My Company → Groups → Push Notification Administrators System Group → click Edit:
   
   
   Here you can find a list of current Push Notification Administrators or revoke access by removing the selected for the user checkbox:
   

Notifications Center and Notifications Monitor

Notifications Center is a new and stand-alone area of the application that can be accessed via the  bell icon and requires Push Notifications license:

Notifications Monitor is managed separately and is available in the application under the  monitor icon:

Notifications Monitor is not related to the Notifications Center with push notifications. It doesn't require an additional license and is available in the default version of the DWP.

Notifications Monitor is available only in those applications that have Show Notification Monitor checkbox enabled in the Application settings.

Administration

The Administrator can enable and configure Push Notifications both for mobile devices and browser as follows:

1. Open Administration application → Settings → Edit → Push Notifications;
2. Select the Push Notifications Enabled checkbox;
3. Click on the Setup Push Notification to configure Matrix42 push server and generate the token. Proceed according to the instructions suggested on the push server.

Push Notifications configuration example in the Global System Settings of the Administration application

The registered token will be displayed as follows:

Later on, you can unbind the registered for the Push Notifications Services environment on the Matrix42 Mobile Portal:

Person profile

Push Notification Settings are applied for mobile and browser notifications. Employees define which push notifications they would like to receive in their personal Profile settings:

Person Profile: Push Notifications Settings example

Push Notification Settings options:

• Show all notifications (including emails): default option. This option also enables Notification Center in the browser application;
• Selected notification types: choose from the list of available options which types of messages you would like to receive. This option also enables Notification Center in the browser application;
• Don't show notifications: the person will not receive any push notifications. Notification Center in the browser application is not available;

Selected notification types option allows you to see the list of all notification types and choose which of them you would like to receive:

Selected notification types option example

Browser Settings

The last step to enable push notifications is to allow them in the browser you use:

Push notifications are supported in the following browsers (including links for manual browser push notification settings):

• Chrome (https://support.google.com/chrome/answer/3220216)

• Firefox (https://support.mozilla.org/en-US/kb...ations-firefox)

• Edge (https://answers.microsoft.com/en-us/...4-739231e8eaa3)

• Internet Explorer: not supported

• Safari: not supported

Push notification structure

Each push notification message has a standard structure and consists of the following elements:

1. Colored icon
2. Title
3. Date and time
4. Body of the message
5. Link

The look&feel of some elements can be adjusted as described in this chapter, but the structure is the same for all types of messages.

Managing push notifications

Notifications Center allows you to view the messages and manage them as follows:

• icon on the notification closes the message. Once closed, the message is no longer available, as the notifications are not stored in the application database.
•  Delete all action clears all messages from the Notifications Center. The notifications will no longer be available and cannot be restored after you run this action.

Push notifications storage

Browser push notifications are not stored in the application database and when they are closed or deleted from the Notifications Center they are no longer available, cannot be restored, or resend.

All notifications are received in real-time when the user is logged in to the DWP application. The browser tab with the active application can be opened, closed, or even the browser can be closed and the user will still receive the notifications. Notifications can be received until the user session expires. Once logged in, the notifications are sent again according to the current browser and user profile settings.

Default types

By default, the system has 4 types of notifications, each marked with a specific icon, color, and template for the title and body of the message:

1. Escalation
2. Approval
3. Email
4. News

Default push notification types examples starting from the top: Escalation, Approval, Email, News

How to create a new notification type 

All push notification types are stored in SPSPushNotificationEventPickupType. This pickup defines the content of the push notification. 

SPSPushNotificationEventPickupType with default types of the push notifications

To create a new custom notification type click Add and fill out the following fields:

• Icon: an icon that will be shown for this type of messages in the Notification Center;
• Value: set the value in the 20000-49999 range for the new record;
• Display String: the name of the notification type;
• Color: the color of the selected icon;
• Internal Name: a technical name that can be used in the custom implementation for this notification type, for instance, in the Send Push Notification Workflow activity.
• Title: this text is shown in the push notification message title and is visible for the end-users in the Notification Center;
• Body: this text is shown in the push notification message body and is visible for the end-users in the Notification Center;

Notifications for New Email received

Push Notification is sent when the new email for the user was created and saved to the database. This notification can be received if the user has subscribed to this notification type in the user Profile settings.

The notification body contains the subject of the e-mail. Click on the link to instantly view the e-mail details:

Notifications from workflow

Notifications are sent when the Order Approval related workflow activities are adjusted accordingly, for instance, Send Push Notification property in the standard 1 Step Approval workflow:

Additionally, push notifications can be configured for the news or other event types in the standard Send Push Notification workflow activity.

Fill out mandatory fields:

• Alert Body: the body of the push notification message;
• Alert Title: the title of the message;
• Event name: choose from the suggested options. The list of options stores all available notification types and is taken from the SPSPushNotificationEventPickupType pickup, see Internal Name field.
• Users: set users or user role.

Custom Notifications

To create a custom push notification:

1. Create a new push notification type;
2. Configure a Send Push Notification workflow activity in your workflow.