Notification Text

The text is used for such notification actions as Notify by SMS or email, Register event for unit, Display online notification in pop-up window.

The text of a notification can be written in any language, contain any characters, words, and phrases, and be of any size. In addition, you can use tags, that is, parameters encrypted with special characters. In a message, such characters will be replaced with real values. If you want to receive a notification by SMS, do not write long messages.

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'».

The units of measurement (kilometers or miles) used to decrypt the tags depend on the resource settings to which the notification belongs. The date and time format is taken from the settings of the creator of this resource.

In the text of the notification with the Send a request action type, enter the parameters of the request. When composing the text of the notification yourself, use URL encoding. Note that when using this type of notification action together with others (such as Notify by email, Notify by SMS, and so on), the same text is created for all notifications.

Below is the list of tags applicable to most types of notifications:

%UNIT% Unit name.
%UNIT_ID% Internal unit ID in the system.
%CURR_TIME% Current date and time.
%LOCATION% Unit location at the moment when notification triggered.
%LAST_LOCATION% Last known unit location. This information may be useful if there is no location information in the triggered message.
%LOCATOR_LINK(60,T)% Create a locator link for the triggered unit (in parentheses indicate its lifespan in minutes, T and G parameters to show tracks and geofences).
%ZONE_MIN% The smallest of the geofences which the unit visited at the moment of notification.
%ZONES_ALL% All geofences the unit visited at the moment of notification.
%SPEED% Speed registered at the moment when notification triggered (is not applicable to fuel fillings or thefts).
%POS_TIME% Date and time of the triggered message, or the last message with the position (for cases case the triggered message has no information about the position).
%MSG_TIME% Date and time of the message that triggered.
%DRIVER% Driver's name (can be displayed only if the driver belongs to the same resource as the notification).
%TRAILER% Trailer's name (can be displayed only if the trailer belongs to the same resource as the notification).
%SENSOR(*)% Unit sensors and their values (indicate a sensor mask in parentheses).
%ENGINE_HOURS% Engine hours at the moment the notification triggered.
%MILEAGE% Mileage at the moment the notification triggered.
%LAT% Latitude at the moment the notification triggered (for example, N 55° 45.7530').
%LON% Longitude at the moment the notification triggered (for example, E 37° 35.2068').
%LATD% Latitude without formatting.
%LOND% Longitude without formatting.
%GOOGLE_LINK% Link to Google Maps with the position at the moment the notification triggered
(for example, http://maps.google.com/?q=55.762550N,37.586780E).
%CUSTOM_FIELD(*)% Custom fields of the unit. If you leave the asterisk sign in parentheses, all available custom fields (including administrative ones) will be shown with their values (in the 'key: value' format). However, you can get the value of a certain field if you specify its name in parentheses. In this case, the resulting notification text will contain the value of the specified field (only the value but not its name).

There are also tags that are applied only to specific types of notifications:

%ZONE% The name of the geofence for which the notification triggered (for the notifications of the Geofence type). In the text of the Outside geofence notification, the %ZONE% tag is replaced with the names of the geofences (separated by a comma) which the unit entered at the time of the previous message and already left. If there is no previous positional message or there are no geofences that satisfy the condition described above, the text of the notification shows only the name of there tag (that is, %ZONE%).
%ZONE_DESC% The description of the geofence (for the Geofence notification) taken from its properties.
%SENSOR_NAME% Name of the triggered sensor (used in notifications of various types).
%SENSOR_VALUE% Value of triggered sensor.
%SERVICE_NAME% Name of service interval (used in maintenance notifications).
%SERVICE_TERM% State of service interval — left/expired value (used in maintenance notifications).
%TRIGGERED_SENSORS% All triggered sensors and their values (used in maintenance notifications).
%LOSE_RESTORE% Connection loss/Connection restored (used in connection loss notifications).
%PARAM_NAME% Parameter name (used in parameter control notifications).
%PARAM_VALUE% Parameter value (used in parameter control notifications).
%SMS_TEXT% Text from SMS message (used in SMS control notifications).
%VOLUME% The volume of the fuel filling or theft (for the fuel filling or fuel theft notifications).
%INITIAL_LEVEL% The fuel level at the moment when the filling or theft began.
%FINAL_LEVEL% The fuel level at the moment when the filling or theft finished.
%TIME_FROM% The time when the fuel filling or theft began.
%TIME_TO% The time when the fuel filling or theft finished.
%DURATION% The duration of the fuel filling or theft (in minutes).
%DRIVER_ID% Driver's code (used in notifications about drivers).
%DRIVER_NAME% Driver's name (used in notifications about drivers).
%TRAILER_ID% Trailer's code (used in notifications about trailers).
%TRAILER_NAME% Trailer's name (used in notifications about trailers).
%OTHER_UNIT% Name of another unit (used in notifications about interposition of units).
%ROUTE_NAME% Route name (used route control notifications).
%ROUTE_STATUS% Round execution status (used in route control notifications).
%ROUTE_POINT% Name of the check point (used in route control notifications).
%ROUTE_SCHEDULE% Schedule name (used in route control notifications).
%ROUND_NAME% Round name (used in route control notifications).
%COUNTRY% Country.
%REGION% Region (state, etc.).
%CITY% City (town, etc.).
%STREET% Street.
%HOUSE% House.

If the data is unknown, the tags are displayed as they are (not substituted with any values). The exceptions are the following tags which do not appear in the notification text when there is no data: %UNIT%, %USER%, %CURR_TIME%, %LOCATION%, %LAST_LOCATION%, %SPEED%, %POS_TIME%, %MSG_TIME%, %UNIT_GROUP%, %ENGINE_HOURS%, %MILEAGE%, %LAT%, %LON%, %LATD%, %LOND%, %GOOGLE_LINK%, %INSURANCE_CASE%, %ZONES_ALL%, %ZONE_MIN%, %UNIT_ID%, %MSG_TIME_INT%, %NOTIFICATION%, %TAG_NAME%, %TAG_ID%, %LOSE_RESTORE%, %LOCATOR_LINK%.

:!: A tag must be marked with a percent sign on both sides. Otherwise, it is considered as plain text and is not substituted with real values.

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