Instant Notification for Observations and Workorders
Function available in version 2024.01 - Release April 2024
The ALIS Notification system allows you to be notified by e-mail or Microsoft Teams on certain events that are happening in the ALIS system. These events are pre-defined and currently focus on observations and work orders. (Later we will add events for connected devices, stay tuned!)
TLDR; You need to create a “Notification-subscription” that is triggered on a certain event-type and define who the users are that need to be notified. You can select a default ADB Safegate email Server or configure your own “target” in how you want to be notified.
Notification setup overview
Below you can find how the notification system works in ALIS - to start we explain the different terms.
Event: determines what will trigger the notification. For examples: work order created, work order completed, work order closed, observation created, observation critical severity change, …etc.
Target: determines how the recipients will receive the notification through the chosen type of transportation (Email, ADB Safegate Email, Microsoft Teams, and Web hook).
Recipients: determines who will receive the notification (example@email.com, example@adbsafegate.com, Teams channel, …etc.)
Subscription: links the event, target, and recipients together.
How to configure the notifications
Step 1. Set up the notification target
Step 2. Set up the notification subscription ( Please carefully read the WARNING in this step)
Step 3. Check the status
Step 4. Receive the notifications
Step 1. Set up the notification target
1.1 Navigate to the Targets page from ALIS web app
1.2 Enter the general information
1.3 Choose the transportation (4 options)
Use to define which server will carry the notifications to the recipients. There are 4 types of transportations to choose, each with its unique configuration.
Option 1: ADB Safegate Email Transportation | Option 2: Email Transportation |
---|---|
This is a pre-configured ADB Safegate internal email server. Non-ADB Safegate recipients can still use this server to receive the notifications. | This transportation uses other email servers to send the notification. You have to manually do the configuration. |
Option 3: Microsoft Teams Transportation | Option 4: Web hook Transportation |
---|---|
To receive notifications via Microsoft Teams, you have to enter the Webhook URL. More information can be found in this link Create Incoming Webhooks | To receive notifications from other webhooks, you have to manually do the configuration. |
Step 2. Set up the notification subscription
2.1 Navigate to the notification subscription page
2.2 Enter the general information and choose an event
There are currently 2 types of events that can trigger the notification
Work order (3 options) | Observation (5 options) |
---|---|
|
|
2.3 Choose the pre-configured target and add the recipients (go back to Step 1 if you did not set up the target yet)
If your target uses ADB Safegate Email transportation | If your target uses Email transportation | If your target uses Microsoft Teams transportation |
---|---|---|
You have to do at least one of the followings to finish the set up:
* *Receipients can be non-ADB Safegate | You have to do at least one of the followings to finish the set up:
| You don’t have to add recipients in the subscription because the recipients are already the member within that Teams channel. |
What is ‘use recipients from event’ box?
If you check this box, the system automatically adds the person involves in that event to the recipient list.
Example with work orders event:
Scenario: You set up a notification subscription with an event work order created and you check the box ‘use recipients from event’. Then you create a new work order and choose Red team in the section Technician group.
What happens next: The system will automatically detects that Red team membes are the 'recipients from event’.
All members from Red team will automatically get the notification that a new work order is created.
Non-Red team members will NOT get this notification.
Additioon: If you want a non-Red team person to also receive the notification, their email has to be manually entered in the recipients section. Moreoever, when a new work order is created for other technician groups (blue team, default team, etc.) this person will also get the notification as well. In short, this person will always get the notification when an event is triggered regardless of the group.
Warning! Please check your User Groups for “Default Team” members or any team that has the “Workorder Recipient” permission. When you enable notifications for new work orders with the function “Recipients from work order” it will inform ALL users that belong to that group. This could result into unintentionally informing users.
Example with observations event:
Scenario: You set up a notification subscription with an event observation attention flag change and you check the box ‘use recipients from event’. Somebody reported an observations and later you decided to put the attention flag on that same observation.
What happens next: The system will automatically detect that 2 people are involved in this observation event.
The recipients from event will be the 1) observation’s reporter and 2) you - who made changes to the atttention flag. These 2 people will receive the notification.
Other people wil NOT receive the notification.
*If you want a third person who is not involved in the event to also be notified, their email has to be manually entered in the recipients section.
3. Check the notification status
When an event is triggered, the notification will be sent to the recipients. You can see their statuses if the notifications are successfully delivered or not.
If error occurs, you should go back to check the set up of your Targets or Subscriptions again.
4. Receive the notifications
If your target uses ADB Safegate Email transportation
The sender will be ADB Safegate internal server.
The recipients will receive the notifications via the emails previously configured in the subscription.
*Don’t forget to check your spam/junk folder, you notification could be in there.