Support Document

•

0 mins to read

Rule Conditions User Guide

Support Document

•

0 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

Purpose

The purpose of this document is to explain what Rule Conditions are and how to configure them in the Fleet Management Application.

Scope

This guide can be used by any user to add and edit custom rules in the Fleet Management Application.

Rules, conditions and exceptions

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.

Available conditions

Conditions	Function
Engine data	Includes any of the following events: Active Fault: Measured as on or off (active faults only) Any Fault: Measured as on or off (active and inactive faults) Measurement or Data, which is measured by the reported value or diagnostic
Zone or zone type	Includes the following events: Entering zone: Identifies when an asset is entering a zone (e.g. arriving at a delivery location) Exiting zone: Identifies when an asset is exiting a zone (e.g. leaving a delivery location) Outside zone: Identifies when an asset is outside a zone (e.g. company vehicle isn’t parked at the yard) Inside zone: Identifies when an asset is inside a zone (e.g. company vehicle is parked at the yard) Inside Any zone: Used for public works applications only, see Public Works documentation for details. Stopped inside zone: Identifies when an asset has stopped inside a zone (e.g. asset making stops at delivery locations within a delivery zone) 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.

How to add conditions

! 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.

From the Conditions tab, select a condition. ✱ EXAMPLE: Speed. Review the Conditions examples section for more.
Select the specifications for the condition. ✱ EXAMPLE: Over 25 mph. Review the Conditions examples section for more.
Click Add.
Review your conditions. ✱ NOTE: Use the Advanced Conditions Editor to further customize your condition.

And example

* 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.

Once you’ve added the first condition (Speed), select the second condition (Zone or zone type).
Select the specifications for the condition: Type Zone Event
Click Add.
To add the driver, click More…
Select either Asset, Driver or Group (in this case, Driver).
Search for and select the specific Asset, Driver or Group (in this case, Joe Day).
Click Add.
Review your conditions. ✱ NOTE: Use the Advanced Conditions Editor to further customize your condition. The rule that you create will be shown using specially formatted syntax.

Or example

* EXAMPLE: You want to refine your rule to be triggered when the driver is speeding over a specific speed or over the speed limit.

Once you’ve added the first condition (Speed), click More…
Scroll down the dropdown menu and select the Or logic condition.
Select your second condition (Speed Limit).
Select the specifications for the condition: Truck speed limit Over the limit by Exclude estimated speed limits Road speed provider
Click Add.
Review your conditions. ✱ 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.

Conditions examples

Safety conditions

Seat belt and speeding

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

)

Speed limiter

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:

Speed > 105 km/h

> 5s

DurationLongerThan[time=5s](

IsValueMoreThan[value=105km/h](

Speed

)

Speeding violations

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:

(Speed compared to Speed Limit Excluding Estimates data) > 10 km/h

> 10s

DurationLongerThan[time=10s](

IsValueMoreThan[value=10km/h](

Speed,

SpeedLimitExcludingEstimates

)

Speeding violations (roads with speed limit)

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:

(Roads with speed limit) > 105 km/h

> 5s

DurationLongerThan[time=5s](

IsValueMoreThan[value=105km/h](

Roads with speed limit,

SpeedLimitAsMeasurement

)

Acceleration

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]

)

Braking

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]

)

Cornering

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]

)

Possible collision

This condition will trigger an exception when a possible collision is detected.

! IMPORTANT: Accelerometer data is available for Base plan customers.

Condition

Advanced Conditions Editor

Status Data Diagnostic "Possible collision detected (AI Model: 2)" > 49

IsValueMoreThan[value=49](

FilterStatusDataByDiagnostic[diagnostic=DiagnosticPossibleCollisionDetectedId]

)

Location conditions

Entering or exiting a zone

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]

)

Outside zones parking

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(

DurationLongerThan[time=1d](

IsValueLessThan[value=0](

IsDriving

)

OutsideArea[zone=b30],

OutsideArea[zoneType=ZoneTypeOfficeId]

OutsideArea[zoneType=b8],

)

Vehicle performance conditions

Vehicle warning light on

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]

)

Battery Drain

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]

)

Fuel level

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]

)

Idling

This condition will trigger an exception when a vehicle is left idling for more than 3 minutes.

Condition

Advanced Conditions Editor

Duration of:

Duration Between GPS Logs < 3m and Speed < 5 km/h and Ignition is true

> 5m

DurationLongerThan[time=5m](

And(

IsValueLessThan[time=3m](

DurationBetweenGps

And(

IsValueLessThan[value=5km/h](

Speed

Ignition[true]

)

State of Charge <20% (EV)

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]

)

Tire pressure out of recommended area

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]

)