Creating notifications

  1. In the Notifications page, select New.
  2. Enter a unique notification title using up to 100 characters.
  3. Configure the notification type: Geofence or Parametric.

ClosedLearn more

Geofence notifications inform you of asset movement that occurs inside or outside of a geofence. This notification can notify you of unauthorized asset movement (for example, equipment leaving a geofence after hours or on weekends).

Parametric notifications are a set of defined events that you define and specify thresholds for which conditions you are notified. Parametric notification types enable a finer degree of control for when this notification is generated.

Notification types are separated by VisionLink application.

Note – Some notification types require an occurrence count (After x Occurrences). This is the number of times the notification must be generated before you are notified. The occurrence serves as a number counter. It triggers only after a certain number of notifications has occurred. Additionally, the counter obeys the schedule times of the notification, and increments only during events that occur within the selected time. After the notification is triggered, the counter is reset to zero and triggers again when the counter reaches the specified occurrence.

ClosedWhat you need to know about occurrence counts

Scenario 1 — Not Reporting notifications

The user wants to know when an asset status changes to Not Reporting, which indicates its device has not reported to VisionLink for seven days or more.

  • The user sets the occurrence count to 1 (the recommended setting) for Not Reporting notifications.
  • The user selects the assets and sets the schedule time to All Day for every day.
  • An asset status changes to Not Reporting Friday at 8:01 AM, which is seven days after it last reported to VisionLink.

In this example, the Not Reporting notification will be triggered Friday at 8:01 AM. After the notification is triggered, the counter is reset to zero. If the asset status remains Not Reporting, then the notification would not be triggered again. However, if the asset status changes to any other status, and then changes to Not Reporting, then the Not Reporting notification will be triggered seven days after the asset last reported to VisionLink.

Scenario 2 — Asset On notifications

The user wants to know when assets report Asset On events after the second occurrence in a day.

  • The user sets the occurrence count to 2 for Asset On notifications.
  • The user selects the assets and sets the schedule time to All Day for every day.
  • The asset reported Asset On events at the following times (for simplicity, Asset Off and other events are not listed here): Monday at 10:00 AM, Tuesday at 8:30 AM, and Tuesday at 9:30 AM.

In this example, the Asset On notification will be triggered Tuesday at 9:30 AM (not Tuesday at 8:30 AM), because the schedule time factor is in place for the event to be considered. Note that events do not necessarily need to occur immediately following each other; the counter will increment only when an event is received.

After the Tuesday at 9:30 AM notification is triggered, the counter is reset to zero, and the notification is triggered again when the second Asset On event is received.

ClosedTo create a geofence notification

  1. Select Geofence, and then select the geofence name(s).
  2. If required, enter the occurrence count.

ClosedTo create a parametric notification

  1. Select the parameter. Some parameters (such as Asset Status) require option selections (such as Not Reporting). Other parameters (such as Engine Hours, Excessive Daily Idle, Fuel, and Odometer) require mathematical operators (such as Greater than or equal to, Less than or equal to, etc.), which specify thresholds for which conditions you are notified. For example:
  • As a best practice, select Greater than or equal to for Engine Hours and Odometer before entering the value. Doing this ensures you would receive the notification the next time the device reports after the threshold is crossed. If you selected Equal to, then you would receive the notification only if the device reported that exact value.
  • A Fuel Loss notification would notify you when the fuel level drops by greater than or equal to the percentage you specify (such as 10%).
  • An Excessive Daily Idle notification would notify you when assets idle daily for greater than the threshold value. This is a cumulative value. The notification is triggered as soon as the threshold has been exceeded. However, the device’s reporting frequency determines when the notification is sent.
  • You can create a customized Fault Codes notification. The selected Customize option (Include or Exclude) and selected fault codes (by assets, groups, or geofences) determine which fault codes are included in, or with Severity, excluded from the notification. See What you need to know about customized fault code notifications.
  1. If required, enter the occurrence count.

ClosedWhat you need to know about customized fault code notifications

For example, if you select the Customize Include (option) and Coasting in Neutral Warning (selected fault code) for Off-Highway Trucks (selected assets), you would get notifications for only the selected off-highway trucks coasting in Neutral. Any assets other than the selected off-highway trucks reporting coasting in Neutral would be excluded from this notification.

You can add a Severity to or remove a Fault Code Type from a Customize Include notification. Use caution, because these selections change the notification behavior. For example:

  • If you select High Severity, you would receive notifications for all High Severity fault codes and for your customized fault codes selection.
  • If you remove the Diagnostic fault code type, you would receive notifications for all Event fault codes and for your customized fault codes selection.

Note – You must add a Severity to a Customize Exclude notification.

The Severity of each fault code is not known for, nor is unique to, a specific fault code. Fault Code Severity is provided at the time a fault code is sent from the device; Severity cannot be used to sort the fault code list in VisionLink Administrator. Only the Fault Code Description and Fault Code Type are known before a device generates a fault code.

  1. If you have already selected the assets in a different application, your selected assets appear in the Selected Assets pane. You can add or remove assets as needed. Search for assets by Asset ID, Serial Number, Product Family, Manufacturer, Geofences, Model, Device type, or Account.

Note – Selected geofences are preloaded to the Selected Geofences panel and cannot be removed. Geofence selections must be changed in Configure Notification Type. If needed, geofences can be added to the Selected Geofences panel.

  1. Optionally, select the notification schedule, which are the individual days and time ranges when you want to start and stop receiving notifications. If no schedule is selected, then the notification is sent at all times. This schedule is set for the asset's time zone, not the user's time zone. Hour Meter and Odometer values in notifications are captured at the time the event occurred, not when the notification was generated. This helps users understand the notification in context of its meter values.

Note – Select the time range by selecting and dragging the slider on the desired day. To add more time ranges, select the Plus sign and repeat. To copy a time range to all days, select the time range on the day and select Copy to All. To remove a time range from a day, select the time range on the day and select Remove.

  1. Select the recipients for the notification from a contacts list. Notifications uses the Predictive Search feature to build a list of matching contacts as you enter characters in the Search Contact field. When you select the contact, it is added to the end of the list of email addresses.

Note – Contacts that are associated with VisionLink accounts appear as white text on a blue background. Contacts that are not associated with VisionLink accounts appear as black text on a gray background.

  1. If the contact is not found, you can add it. Enter the email address and select Add Contact. Be sure to provide the email address in a suitable format.

ClosedLearn more

An SMS/text email address must be in a suitable format for the mobile carrier: <number>@<mobile carrier's SMS gateway address>. For example, 1234567890@txt.att.net (ATT U.S.) or 9876543210@vtext.com (Verizon U.S.). Contact your mobile carrier for the correct number and SMS gateway address format.

Note – A user account is not required for a subscriber to get notifications. For example, suppose a security company monitors your geofences off-hours. They could get notifications of possible theft, but they would not have a user account with access to VisionLink Unified Fleet.

Note – To ensure notification emails reach the recipients, ask them to add the email address AlertManager@myvisionlink.com to their email address books or contacts lists.

  1. Select Save.

Managing notifications

Duplicating notifications

Deleting notifications