Notifications

:!: Attention! This module is licensed separately and can be not included in your package.

You can be notified about any activity of an object that you consider to be significant. It can be speeding, location, sensors values, etc. A notification can be delivered by e-mail or SMS, shown online in a popup window or just registered in the system to be included later in the report.

The number of notifications allowed can be known from your account parameters (see User Settings => Account).

To create, edit and view notifications, choose the appropriate item in the top menu.

How to Create a Notification

  1. Push the 'Create Notification' button (green plus).
  2. Choose unit(s) to create a notification for (see Jobs for details), and push Next. If you have only one unit available, it is selected automatically, and this page is not displayed.
  3. Select what you would like to control: geofence, speed, alarms, sensor values, message parameter, etc. Push Next.
  4. Adjust control parameters needed for the notification type selected in the previous window: select geofences, indicate speed limits, etc. Push Next.
  5. Input your text for the notification using special tags listed in the table below. They will be substituted with real values when notification triggers.
  6. Indicate how the notification should be delivered: sent by e-mail or SMS, popup online, registered in unit history, etc.
  7. Key in a name for the notification and adjust the schedule for its performance.
  8. Push OK. The created notification will appear on the list in the left part of the window.

All of the steps of creating notification are described in detail below.

Notification Type

Geofence control
In case of this choice, in the following window you have to select geofence(s) to control and control type: control entries to or exits from geofence(s). To choose several geofences at once, hold <ctrl> key and click on needed geofences in sequence.

In addition you can narrow trigger case adjusting speed limitations or sensor value range inside (outside) the geofence. Then the notification will trigger when a unit being inside (outside) a controlled geofence breaks these limitations.

For additional speed control, indicate lower and higher speed limit, and the notification will trigger if beyond the limits.

For sensor control you can set trigger inside the indicated values as well as outside them. Choose sensor types on the dropdown list or set the mask using a wildcard symbol (*). If there will be two or more sensors of the same type or mask found, their values can be summed or calculated separately (select the corresponding option).

Speed control
Define the minimum and/or maximum speed values. If a unit goes out of this range, the notification will trigger. In addition, you can activate sensor value control - in this case the notification will trigger only if both conditions are met.

Alarm button trigger
For this type of notification no specific settings are needed.

Digital input activation/deactivation
Specify the number of digital input and select control type: trigger on input activation or deactivation.

Message parameter control
Four control types are provided: value range, text mask, parameter availability, and parameter lack. To control Value range, specify parameter name, define minimum and maximum values for it, and select whether to trigger in the specified range or out of it. To control parameter text, enter parameter name and Text mask using wildcard symbols (? and *). For Parameter availability and Parameter lack it is enough to indicate parameter name. These two last mentioned options can be interpreted as parameter appearance and disappearance if on the last page of the dialog you set the option 'Generate notification only when state changed'. :!: For in and out parameters it is possible only to control parameter availability/lack.

Sensor value control
Choose sensor type on the dropdown list or set the mask using a wildcard symbol (*). Preset minimum and maximum values, indicate if you want similar sensors to be summed or calculated separately, and select control type: trigger in the specified range or out of it. If there will be two or more sensors of the same type or mask found, their values can be summed or calculated separately (select the corresponding option).

Connection loss
Choose control type. It can be a simple connection loss which registers cases when no satellites lock the unit during a period of time. There are also cases when all sensors are active and their values are known but it is impossible to locate the unit. To register such cases, choose the option “Connection or coordinates loss”. Set also loss time: how long (in minutes) the loss of connection should continue before a notification triggers.

Idles
For this type of control, indicate speed and time. Speed should be more then 0 km/h in order to exclude possible equipment errors. Indicate also time allowed for staying. If this time exceeded, this will be considered as an idle, and the notification will trigger. In addition, you can activate sensor value control - in this case the notification will trigger only if both conditions are met. It is convenient to control idles with engine on, for example.

SMS control
You can receive a notification when a certain SMS message comes. To define, which SMS messages you are interested in, enter a mask for message text. This feature can be useful, for example, when a device sends SMS of a certain content in case of malfunction.

Interposition of units
This type of notification allows you to control approaching of units to each other and moving away from each other. Select control type (approaching or moving away) and specify radius in meters - if this distance between units is insufficient or exceeded, then the notification will trigger. Choose units which position will be estimated regarding the units which were chosen for the notification itself.

In addition you can narrow trigger case adjusting speed limitations or sensor value range (like in geofence control).

Route control
For this type of notification, select route statuses to control: route start, route finish, route interrupt, arrival to control point, control point skip, departure from control point, entrance to geofence, exit from geofence.

Driver control
Choose control type: driver assignment or driver reset. To control both activities, two notifications of different types will be required. Using this notification you can control all drivers (*) or just some of them – input driver's name (or code) mask.

Routine servicing
First, you choose trigger type: notify when service term approaches or notify when service term is expired. Then indicate the interval before or after the term for the notification to trigger. This interval can be in days, kilometers or engine hours or all together. You can control all intervals existing in the Service Intervals tab in unit properties or just several intervals. To indicate certain intervals, disable 'Control all service intervals' option and enter a mask using wildcard symbols like * and ?.

Notification Text

The text of notification can be written in any language, contain any characters, words and phrases, and be of any size. Large messages are acceptable for e-mail notifications. Of course, for SMS notifications it is better to form more compact messages.

To be more informative, a notification should contain special parameters (tags) which are substituted with real values in an incoming notification.

Below is the list of such parameters:

%UNIT% Unit name
%CURR_TIME% Current date and time
%LOCATION% Unit location at the moment when notification triggered
%SPEED% Speed registered at the moment when notification triggered
%POS_TIME% Date and time of the latest message with position
%MSG_TIME% Date and time of the message triggered
%ALL_SENSORS% All sensors and their values
%ENGINE_HOURS% Engine hours at the moment of notification
%MILEAGE% Mileage at the moment of notification
%SENSOR_NAME% Triggered sensor name
%SENSOR_VALUE% Triggered sensor value
%ZONE% Triggered geofence name
%LAT% Latitude at the moment of notification (e.g., N 55° 45.7530')
%LON% Longitude at the moment of notification (e.g., E 37° 35.2068')
%GOOGLE_LINK% Link to Google Maps with the position at the moment of notification
(e.g., http://maps.google.com/?q=55.762550N,37.586780E)
%SERVICE_NAME% Service interval name
%SERVICE_TERM% Service interval state (left/expired value)
%PARAM_NAME% Parameter name
%PARAM_VALUE% Parameter value
%DRIVER_ID% Driver's code
%DRIVER_NAME% Driver's name
%OTHER_UNIT% Name of another nuit (used in notifications about interposition of units)

Note that a parameter must be marked by percent sigh from both sides. Otherwise, it will considered as simple text as is and will be not converted to real values.

Example.
The text «'%UNIT%' violated speed limitations. At '%POS_TIME%' it moved %SPEED% near '%LOCATION%'» can be transformed to «'Rover-119' violated speed limitations. At '2000-01-01 12:01:37' it moved 136 km/h near 'KU 8, Thurnau, DE'».

Action

  • Notify by e-mail
    You can indicate one or more e-mail addresses to send a notification to. When all slots to enter addresses are filled, additional slots appear automatically. Besides, you can check the option Attach image from triggered message if your the device used takes pictures.
  • Notify by SMS
    Key in one or more telephone numbers in the international format, for example, +375293293294. When all slots to enter phones are filled, additional slots appear automatically.

  • Display online notification in popup window
    In this case a notification will be displayed in a popup window when the monitoring site is loaded.
  • Register event for unit
    In this case a notification is stored in unit history. Then a report on these events can be generated. If this option is selected. Register as violation is additionally proposed. If you check it too, the notification will be registered not only as event but as violation, and one more report type will be available to you. For further information see reports on Events and Violations.
  • Execute a command
    If you choose this option, when the notification triggers, a command is executed over the unit. Select a command from the list of available items and set necessary parameters if needed. More about commands...

  • Modify users access level
    Choose users which access rights to be modified when trigger conditions occur. Select access level to be set to this user after notification triggers: no access, view, execute commands, edit. This feature can be used, for instance, in the following situation. Let us assume, we have created a user to give him opportunity to track his cargo transportation - we have given him view access to a unit which is carrying this cargo. When this unit enters a destination place (a geofence under control), the notification triggers, and the unit becomes unavailable to the user (view access is modified to no access).

  • Set counter value
    Counter values can be changed (or zeroed) when notification triggers. Select one or more counters (mileage counter, engine hours counter, traffic counter) and set new values for them.

  • Store counter value as parameter
    Current values of mileage or engine hours counters can be stored as parameters in unit data messages (odometer or engine_hours correspondingly). These parameters can used to create sensors on their basis (for example, engine hours sensor) and to get initial/final mileage in reports. For more precise calculations, it is recommended to store counters while the unit is parked, for example, once a day at night time.
  • Register unit status
    A new status can be set for unit when a notification triggers. For instance, when unit enters a geofence, private state can automatically switch to business.

  • Modify unit groups
    You can change the contents of unit groups when a notification triggers - add triggered unit to a group or remove it from a group. On the left there is a list of all available unit groups. Move necessary groups to the right to Add to group or Remove from group sections.

  • Send a report by e-mail
    Enter e-mail address(es) to send a report to if the notification triggers. Select report template, object, format, and other parameters to get a needed report. If the selected report template concerns a unit, there is no need to select a certain unit for the report to be generated. It is better to choose Triggered unit option (then the report will be generated for the same unit that the notification has triggered for).

  • Assign route
    Assigning a new route to unit can be chosen as an action undertaken after the notification triggers. For example, when a route becomes finished, a new route can be assigned, or when unit leaves its garage (as a geofence), a route is automatically created for it. See Route Control for details.

  • Reset driver
    This feature can be used, for example, to reset driver automatically when the unit returns to the depot.

Notification Parameters

In the given window you can set general parameters for a notification as well as define the specific character of its operation. The set of parameters can vary depending on notification type.

  • Notification name
    Key in any mane. It will be displayed on the list of notifications and in the notification itself.
  • Time interval
    The period after which the notification will be deleted.
  • Control period from current time
    This is a period of between the time when the notification triggered and the current server time. If this interval is exceeded, the message is not taken into account.
  • Min duration of alarm state
    This parameter is aimed to exclude cases of accidental trigger that can be caused by equipment errors and inaccuracy. For example, a tracker can show that a unit left a geofence but returned 10 seconds later. In this field you can define how much time the alarm state have to continue in order to be registered. Choose an interval from 10 seconds up to 1 day.
  • Max triggers
    How many notifications can be delivered until it will be automatically deleted.
  • Generate notification: (1) Only when state changed, (2) For all messages
    In the first case the notification will trigger when unit state changes, that is if at the moment when the notification was activated a unit is already in a alarm state, the notification will not trigger. In the second case the notification will trigger as soon as an alarm state is detected. If the second option is selected, the following parameters are not needed.
  • Min duration of the previous state
    This parameter is needed to exclude excessive triggers. For example, the unit can return to the normal state for a very short time and then returns back to the alarm state. In order that the notification in such a case would not trigger twice, this parameter is used. Choose an interval from 10 seconds up to 1 day.
  • Max time difference between messages
    Maximum time between the latest message and the previous one to form a notification. If the interval between the current message and the previous one exceeds this value, the notification does not trigger.
  • Timeout
    Delay from the moment when message was received and before it it will be checked. This delay is especially recommended if a unit has a black box that usually requires time to unload all messages stored in the period of communication loss (for instance, while it was abroad).
  • Enabled
    If activated, the notification after creation/editing will be active. If not, it will be disabled.
  • Time limitations
    It is possible to set limitations depending on time, day or month. For example, the control can be performed only on weekdays and within working hours.

Notifications Management

On the list of notifications you can get the following information:

Notification state: – enabled, – disabled.
How many times a notification has already triggered.
How many units are under control of this notification (see the list of these units in the tooltip).
Control type: Actions:
speeding,
geofences,
alarm button trigger,
digital input activation/deactivation,
sensor value control,
message parameter control,
connection loss,
idle,
SMS control,
interposition of units,
route control,
driver control,
routine servicing.
e-mail,
SMS,
online popup window,
event registration,
violation registration,
command execution,
send a report by e-mail,
modify users access level,
manipulate counters,
register unit status,
modify unit groups,
assign a new route,
reset driver.

Hover the mouse cursor over a notification to see more detailed information in the tooltip: validity period, notification text, and account to which the notification belongs (shown if you have access to more than one account).

The following actions can be executed over notifications:

enable/disable notification,
enable/disable all notifications at once,
edit a notification settings,
create a new notification using this one as the basis,
delete a notification.

If you have just view access to the account where a notification is located, you cannot edit or delete it, and some buttons look different:
you cannot change notification state,
view notification properties (editing not available),
impossible to delete the notification.

Using the dynamic filter, you can save your time when looking for a certain notification on the list. Enter notification name or its part into the search box above the list and estimate the results.

The other way to filter notifications can be used if you have access to more than one account. Then on the dropdown list choose account name to display only the notifications which belong to this account. Note that if you have just view rights to an account, you cannot edit or delete these notifications.

Online Notification

Online notifications will popup on the map. It can be accompanied by a special sound (see User Settings). As more notifications come, they are stored in the same window.

Newly received notifications are added to the list on the top. The captions of unread notifications are bold. The caption for notification is taken from the name that was given while creating notification. To expand or minimize a notification, use the switch button +/-.

If clicking on a notification, the map is centered on the place where the event happened. If clicking on a unit name, map is centered on the latest unit position.

To delete a notification, click on a cross against it. It is possible also to delete all messages (remove all button) or delete all read messages (remove read button).

You can hide or show the notification window. To hide it, press close button or click on notifications icon on the bottom. Click it again when need to show the notification window again. If the icon blinks, it means there are unread notifications. If you place the mouse pointer over the icon, in the tooltip you can see the number of unread notifications.

By default, the notification window appears automatically when a new online notification triggers. However, if you remove the flag Automatically display popup events in User Settings, only the blinking envelope in the bottom panel will indicate that there are new notifications.

Follow us on Facebook Gurtam Wialon Twitter Gurtam Wialon info@gurtam.com   |   Copyright © 2002-2017 Gurtam