Support Document
11 mins to read
Rule Conditions User Guide
Support Document
11 mins to read
This guide can be used by any user to add and edit custom rules in the Fleet Management Application. The purpose of this document is to explain what Rule Conditions are and how to configure them in the Fleet Management Application.
User Guide
May 2024
The purpose of this document is to explain what Rule Conditions are and how to configure them in the Fleet Management Application.
This guide can be used by any user to add and edit custom rules in the Fleet Management Application.
Rules are used to measure, monitor and improve driver behavior. You can leverage the built-in rules or create custom rules.
Conditions are the parameters of a rule, and they trigger when an exception occurs.
Exceptions occur when a rule is broken. After setting up rules, exception reporting can provide valuable insights into driver behavior.
Conditions | Function |
Engine data | Includes any of the following events:
|
Zone or zone type | Includes the following events:
These can be based on an individual zone or zone type (customer, home, office). |
Roads with speed limit | Sets a threshold for Over or Under a defined road speed limit. |
Speed | Sets a threshold for Over or Under the defined speed. |
Speed Limit | Defines speed allowed over the posted limit. You can choose to include or exclude estimated speed limits, and specify the road speed provider (Commercial, Community, All). |
Duration | Defines the time at which a rule must be broken before a notification is triggered. |
Distance | Defines the distance at which a rule is broken before a notification is triggered. |
Device Ignition | Specifies whether ignition on or off. |
Device | Used to define that the rule only applies to a specific device. |
Driver | Used to define that the rule only applies to a specific driver. |
Driving | Used to define that the asset must be driving to meet this condition. |
Stop | Used to define that the asset must be stopped to meet this condition. |
Trip distance | Sets a trip distance threshold above, below or equal to a specific value. |
Trip duration | Sets a trip duration threshold above, below or equal to a specific value. |
Auxiliaries | Monitor on/off sensors or other external input devices connected to the telematics device. |
After work hours rule | Used to indicate that the event must occur after the specified set of work hours. |
Work hours rules | Used to indicate that the event must occur during the specified set of work hours. |
After work hours device | Used to indicate that the event must occur after an asset’s work hours. |
Device work hours | Used to indicate that the event must occur during an asset’s work hours. |
Wrappers | Add the Is value more than/less than/equal to conditions that don’t already require these values, and Invert result inverts all conditions. |
Logic | And is automatically added. It is used when using multiple conditions that must all occur to trigger an exception. Or is used when you want any single event to trigger an exception. It must be added manually. ! IMPORTANT: There is no Then logic. See the examples of how to use logic in this guide. |
! IMPORTANT: A good custom rule contains two or three conditions — a rule with a single condition may trigger too many exceptions, while a rule with five or six conditions may never trigger any exceptions.
* NOTE: To learn how to create a rule, see the How to add a rule job aid.
✱ EXAMPLE: Speed. Review the Conditions examples section for more. | |
✱ EXAMPLE:
Review the Conditions examples section for more. | |
✱ NOTE: Use the Advanced Conditions Editor to further customize your condition. |
* EXAMPLE: You want to refine your rule to be triggered when a specific driver, Joe Day, enters the Customer yard zone at a specific speed.
| |
| |
✱ NOTE: Use the Advanced Conditions Editor to further customize your condition. The rule that you create will be shown using specially formatted syntax. |
* EXAMPLE: You want to refine your rule to be triggered when the driver is speeding over a specific speed or over the speed limit.
| |
| |
✱ NOTE: Use the Advanced Conditions Editor to further customize your condition. The rule that you create will be shown using specially formatted syntax. |
! IMPORTANT: If you require more information on conditions, or have a specific need, please reach out to your PAM.
This condition will trigger an exception when the seatbelt is unbuckled and a driver is going faster than 10km/h.
Condition | Advanced Conditions Editor |
Status Data Diagnostic "Driver seat belt (1 = unbuckled)" > 0 and Speed > 10 km/h | And( IsValueMoreThan[value=0]( FilterStatusDataByDiagnostic[diagnostic=DiagnosticDriverSeatbeltId] ), IsValueMoreThan[value=10km/h]( Speed ) ) |
This condition will trigger an exception when a driver is driving faster than 105 km/h for more than 5 seconds.
Condition | Advanced Conditions Editor |
Duration of:
> 5s | DurationLongerThan[time=5s]( IsValueMoreThan[value=105km/h]( Speed ) ) |
This condition will trigger an exception when driving 10 km/h over the speed limit for more than 10 seconds.
Condition | Advanced Conditions Editor |
Duration of:
> 10s | DurationLongerThan[time=10s]( IsValueMoreThan[value=10km/h]( Speed, SpeedLimitExcludingEstimates ) ) |
This condition will trigger an exception when driving 10 km/h over any road with the speed limit of 105 km/h for more than 5 seconds.
Condition | Advanced Conditions Editor |
Duration of:
> 5s | DurationLongerThan[time=5s]( IsValueMoreThan[value=105km/h]( Roads with speed limit, SpeedLimitAsMeasurement ) ) |
This condition will trigger an exception when a driver accelerates too quickly (0.35G in this example).
Condition | Advanced Conditions Editor |
Status Data Diagnostic "Acceleration forward or braking" > 0.35 G | IsValueMoreThan[value=0.35G]( FilterStatusDataByDiagnostic[diagnostic=DiagnosticAccelerationForwardBrakingId] ) |
This condition will trigger an exception when the driver brakes too quickly (-0.4G in this example).
Condition | Advanced Conditions Editor |
Status Data Diagnostic "Acceleration forward or braking" < -0.4 G | IsValueLessThan[value=-0.4G]( FilterStatusDataByDiagnostic[diagnostic=DiagnosticAccelerationForwardBrakingId] ) |
This condition will trigger an exception when a driver corners too quickly (0.45G for this example).
Condition | Advanced Conditions Editor |
Status Data Diagnostic "Acceleration side to side" > 0.45 G or Status Data Diagnostic "Acceleration side to side" < -0.45 G | Or( IsValueMoreThan[value=0.45G]( FilterStatusDataByDiagnostic[diagnostic=DiagnosticAccelerationSideToSideId] ), IsValueLessThan[value=-0.45G]( FilterStatusDataByDiagnostic[diagnostic=DiagnosticAccelerationSideToSideId] ) ) |
This condition will trigger an exception when a possible collision is detected.
! IMPORTANT: Accelerometer data is available for Asset Plan customers.
Condition | Advanced Conditions Editor |
Status Data Diagnostic "Possible collision detected (AI Model: 2)" > 49 | IsValueMoreThan[value=49]( FilterStatusDataByDiagnostic[diagnostic=DiagnosticPossibleCollisionDetectedId] ) |
This condition will trigger an exception when a driver enters or exits a zone.
Condition | Advanced Conditions Editor |
Entering Area "Office" or Exiting Area "Office" | Or( EnteringArea[zoneType=b3], ExitingArea[zoneType=b3] ) |
This condition will trigger an exception when the asset is parked outside of company zones for more than 1 day.
Condition | Advanced Conditions Editor |
Duration of: • Stop > 1d and Outside Area "Company yard" and Outside Area "Office" and Outside Area "Yard Move" | And( And( DurationLongerThan[time=1d]( IsValueLessThan[value=0]( IsDriving ) ), OutsideArea[zone=b30], OutsideArea[zoneType=ZoneTypeOfficeId] ), OutsideArea[zoneType=b8], ) |
This condition will trigger an exception when the Vehicle Warning light turns on after a distance of 1000m.
Condition | Advanced Conditions Editor |
Distance of Active Fault "General vehicle warning light is on" > 1000 m | DistanceLongerThan[distance=1000m]( Fault[diagnostic=DiagnosticGeneralVehicleWarningLightId] ) |
This condition will trigger an exception when the battery is below 9V.
Condition | Advanced Conditions Editor |
Status Data Diagnostic "Telematics device voltage" < 9 V | IsValueLessThan[value=9V]( FilterStatusDataByDiagnostic[diagnostic=DiagnosticGoDeviceVoltageId] )
|
This condition will trigger an exception when the fuel level is below 20L or below 20%.
Condition | Advanced Conditions Editor |
Status Data Diagnostic "Fuel level (volume)" < 20 L or Status Data Diagnostic "Fuel level (percentage)" < 20 % | Or( IsValueLessThan[value=20L]( FilterStatusDataByDiagnostic[diagnostic=DiagnosticFuelUnitsId] ), IsValueLessThan[value=20%]( FilterStatusDataByDiagnostic[diagnostic=DiagnosticFuelLevelId] ) ) |
This condition will trigger an exception when a vehicle is left idling for more than 3 minutes.
Condition | Advanced Conditions Editor |
Duration of:
> 5m | DurationLongerThan[time=5m]( And( IsValueLessThan[time=3m]( DurationBetweenGps ), And( IsValueLessThan[value=5km/h]( Speed ), Ignition[true] ) ) ) |
This condition will trigger an exception when a vehicle’s charge is less than 20%.
Condition | Advanced Conditions Editor |
Status Data Diagnostic "Generic state of charge" < 20 % | IsValueLessThan[value=20%]( FilterStatusDataByDiagnostic[diagnostic=DiagnosticStateOfChargeId] ) |
This condition will trigger an exception when a vehicle’s tire pressure is outside of the recommended Pa.
Condition | Advanced Conditions Editor |
Status Data Diagnostic "Tire pressure - front left" > 351000 Pa or Status Data Diagnostic "Tire pressure - front left" < 340000 Pa or Status Data Diagnostic "Tire pressure - front right" > 351000 Pa or Status Data Diagnostic "Tire pressure - front right" < 340000 Pa or Status Data Diagnostic "Tire pressure - rear left / rear left outer" > 351000 Pa or Status Data Diagnostic "Tire pressure - rear left / rear left outer" < 373000 Pa or Status Data Diagnostic "Tire pressure - rear right / rear right outer" > 351000 Pa or Status Data Diagnostic "Tire pressure - rear right / rear right outer" < 373000 Pa | Or( IsValueMoreThan[value=351000Pa]( FilterStatusDataByDiagnostic[diagnostic=DiagnosticTirePressureFrontLeftId] ), IsValueLessThan[value=340000Pa]( FilterStatusDataByDiagnostic[diagnostic=DiagnosticTirePressureFrontLeftId] ), IsValueMoreThan[value=351000Pa]( FilterStatusDataByDiagnostic[diagnostic=DiagnosticTirePressureFrontRightId] ), IsValueLessThan[value=340000Pa]( FilterStatusDataByDiagnostic[diagnostic=DiagnosticTirePressureFrontRightId] ), IsValueMoreThan[value=351000Pa]( FilterStatusDataByDiagnostic[diagnostic=DiagnosticTirePressureRearLeftId] ), IsValueLessThan[value=373000Pa]( FilterStatusDataByDiagnostic[diagnostic=DiagnosticTirePressureRearLeftId] ), IsValueMoreThan[value=351000Pa]( FilterStatusDataByDiagnostic[diagnostic=DiagnosticTirePressureRearRightId] ), IsValueLessThan[value=373000Pa]( FilterStatusDataByDiagnostic[diagnostic=DiagnosticTirePressureRearRightId] ) ) |