Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
user:notify:text [22/01/2018 13:39]
tagr 18831
user:notify:text [25/05/2018 11:49] (current)
irra [Notification Text] https://redmine.gurtam.net/issues/21657
Line 17: Line 17:
 Below is the list of parameters applicable to most types of notifications:​ Below is the list of parameters applicable to most types of notifications:​
  
-|%UNIT%| Unit name| +|%UNIT%| Unit name
-|%CURR_TIME%| Current date and time| +|%CURR_TIME%| Current date and time
-|%LOCATION%| Unit location at the moment when notification triggered| +|%LOCATION%| Unit location at the moment when notification triggered
-|%LAST_LOCATION%| Last known unit location\\ (may be useful if there is no position in the triggered message)| +|%LAST_LOCATION%| Last known unit location\\ (may be useful if there is no position in the triggered message)
-|%LOCATOR_LINK(60,​T)%| Create locator link for the triggered unit (in brackets indicate lifespan in minutes, T and G parameters to show tracks and geofences) | +|%LOCATOR_LINK(60,​T)%| Create locator link for the triggered unit (in brackets indicate lifespan in minutes, T and G parameters to show tracks and geofences)
-|%ZONE_MIN%| The smallest of geofences holding unit at the moment of notification | +|%ZONE_MIN%| The smallest of geofences holding unit at the moment of notification
-|%ZONES_ALL%| All geofences holding unit at the moment of notification | +|%ZONES_ALL%| All geofences holding unit at the moment of notification
-|%SPEED%| Speed registered at the moment when notification triggered (is not applicable to fuel fillings/​thefts) | +|%SPEED%| Speed registered at the moment when notification triggered (is not applicable to fuel fillings/​thefts)
-|%POS_TIME%| Date and time of the triggered message or the latest message with position in case the triggered message has no position | +|%POS_TIME%| Date and time of the triggered message or the latest message with position in case the triggered message has no position
-|%MSG_TIME%| Date and time of the message triggered| +|%MSG_TIME%| Date and time of the message triggered
-|%DRIVER%| Driver'​s name (can be displayed only if the driver belongs to the same resource as notification) | +|%DRIVER%| Driver'​s name (can be displayed only if the driver belongs to the same resource as notification)
-|%TRAILER%| Trailer'​s name (can be displayed only if the trailer belongs to the same resource as notification) | +|%TRAILER%| Trailer'​s name (can be displayed only if the trailer belongs to the same resource as notification)
-|%SENSOR(*)%| Unit sensors and their values (indicate sensor mask in brackets) | +|%SENSOR(*)%| Unit sensors and their values (indicate sensor mask in brackets)
-|%ENGINE_HOURS%| Engine hours at the moment of notification| +|%ENGINE_HOURS%| Engine hours at the moment of notification
-|%MILEAGE%| Mileage at the moment of notification| +|%MILEAGE%| Mileage at the moment of notification
-|%LAT%| Latitude at the moment of notification (e.g., N 55° 45.7530'​)| +|%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'​)| +|%LON%| Longitude at the moment of notification (e.g., E 37° 35.2068'​)
-|%LATD%| Latitude without formatting| +|%LATD%| Latitude without formatting
-|%LOND%| Longitude without formatting| +|%LOND%| Longitude without formatting
-|%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)|+|%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)|
 |%CUSTOM_FIELD(*)%| Unit custom fields. If you leave the asterisk sign in the brackets, all accessible custom fields (both regular and administrative) will be shown with their values (in the format 'key: value'​). However, you can get the value of a certain field if you specify its complete name in the brackets. In this case, the resulting notification text will contain the value of the specified field (only the value but not its name). | |%CUSTOM_FIELD(*)%| Unit custom fields. If you leave the asterisk sign in the brackets, all accessible custom fields (both regular and administrative) will be shown with their values (in the format 'key: value'​). However, you can get the value of a certain field if you specify its complete name in the brackets. 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 parameters which make sense only with certain types of notifications:​ There are also parameters which make sense only with certain types of notifications:​
  
-|%ZONE%| The name of the triggered geofence (used in notifications of geofence control). In the text of notifications of the //​[[user/​notify/​trigger?&#​geofence|Outside geofence]]//​ type in the %ZONE% parameter, the names of the geofences in which the unit was at the time of the previous message and is absent from at the current moment are displayed through a comma. If no previous positional message is found, or there are no geofences that satisfy the above condition, only the parameter (//​%ZONE%//​) is displayed in the notification text.| +|%ZONE%| The name of the triggered geofence (used in notifications of geofence control). In the text of notifications of the //​[[user/​notify/​trigger?&#​geofence|Outside geofence]]//​ type in the %ZONE% parameter, the names of the geofences in which the unit was at the time of the previous message and is absent from at the current moment are displayed through a comma. If no previous positional message is found, or there are no geofences that satisfy the above condition, only the parameter (//​%ZONE%//​) is displayed in the notification text. | 
-|%SENSOR_NAME%| Triggered sensor name (used in various notifications)| +|%ZONE_DESC%| The description of the geofence (for the //​Geofence//​ notification) taken from its [[user/​geo/​new#​set_geofence_properties|properties]]. | 
-|%SENSOR_VALUE%| Triggered sensor value| +|%SENSOR_NAME%| Triggered sensor name (used in various notifications)
-|%SERVICE_NAME%| Service interval name (used in notifications about maintenance)| +|%SENSOR_VALUE%| Triggered sensor value
-|%SERVICE_TERM%| Service interval state — left/​expired value (used in notifications about maintenance)| +|%SERVICE_NAME%| Service interval name (used in notifications about maintenance)
-|%TRIGGERED_SENSORS%| All triggered sensors and their values (used in notifications about maintenance) | +|%SERVICE_TERM%| Service interval state — left/​expired value (used in notifications about maintenance)
-|%LOSE_RESTORE%| Connection loss/​Connection restored (used in notifications about connection loss)| +|%TRIGGERED_SENSORS%| All triggered sensors and their values (used in notifications about maintenance)
-|%PARAM_NAME%| Parameter name (used in parameter control)| +|%LOSE_RESTORE%| Connection loss/​Connection restored (used in notifications about connection loss)
-|%PARAM_VALUE%| Parameter value (used in parameter control)| +|%PARAM_NAME%| Parameter name (used in parameter control)
-|%SMS_TEXT%| Text from SMS message (used in SMS control)| +|%PARAM_VALUE%| Parameter value (used in parameter control)
-|%DRIVER_ID%| Driver'​s code (used in notifications about drivers)| +|%SMS_TEXT%| Text from SMS message (used in SMS control)
-|%DRIVER_NAME%| Driver'​s name (used in notifications about drivers)| +|%DRIVER_ID%| Driver'​s code (used in notifications about drivers)
-|%TRAILER_ID%| Trailer'​s code (used in notifications about trailers)| +|%DRIVER_NAME%| Driver'​s name (used in notifications about drivers)
-|%TRAILER_NAME%| Trailer'​s name (used in notifications about trailers)| +|%TRAILER_ID%| Trailer'​s code (used in notifications about trailers)
-|%OTHER_UNIT%| Name of another unit (used in notifications about interposition of units)| +|%TRAILER_NAME%| Trailer'​s name (used in notifications about trailers)
-|%ROUTE_NAME%| Route name (used in notifications of route control)| +|%OTHER_UNIT%| Name of another unit (used in notifications about interposition of units)
-|%ROUTE_STATUS%| Round execution status (used in notifications of route control)| +|%ROUTE_NAME%| Route name (used in notifications of route control)
-|%ROUTE_POINT%| Check point name (used in notifications of route control)| +|%ROUTE_STATUS%| Round execution status (used in notifications of route control)
-|%ROUTE_SCHEDULE%| Schedule name (used in notifications of route control)| +|%ROUTE_POINT%| Check point name (used in notifications of route control)
-|%ROUND_NAME%| Round name (used in notifications of route control)| +|%ROUTE_SCHEDULE%| Schedule name (used in notifications of route control)
-|%COUNTRY%| Country| +|%ROUND_NAME%| Round name (used in notifications of route control)
-|%REGION%| Region (state, etc.)| +|%COUNTRY%| Country
-|%CITY%| City (town, etc.)| +|%REGION%| Region (state, etc.)
-|%STREET%| Street| +|%CITY%| City (town, etc.)
-|%HOUSE%| House|+|%STREET%| Street
 +|%HOUSE%| House|
  
 Note that a parameter must be marked by percent sign from both sides. Otherwise, it will be considered as plain text and will not be converted to real values. ​ Note that a parameter must be marked by percent sign from both sides. Otherwise, it will be considered as plain text and will not be converted to real values. ​
  
Follow us on Facebook Gurtam Wialon Twitter Gurtam Wialon info@gurtam.com   |   Copyright © 2002-2018 Gurtam