Support Document

0 mins to read

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:

  1. Active Fault: Measured as on or off (active faults only)
  2. Any Fault: Measured as on or off (active and inactive faults)
  3. Measurement or Data, which is measured by the reported value or diagnostic

Zone or zone type

Includes the following events:

    1. Entering zone: Identifies when an asset is entering a zone (e.g. arriving at a delivery location)
    2. Exiting zone: Identifies when an asset is exiting a zone (e.g. leaving a delivery location)
    3. Outside zone: Identifies when an asset is outside a zone (e.g. company vehicle isn’t parked at the yard)
    4. Inside zone: Identifies when an asset is inside a zone (e.g. company vehicle is parked at the yard)
    5. Inside Any zone: Used for public works applications only, see Public Works documentation for details.
    6. Stopped inside zone: Identifies when an asset has stopped inside a zone (e.g. asset making stops at delivery locations within a delivery zone)
    7. 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.

    1. From the Conditions tab, select a condition.
    2. EXAMPLE: Speed.

      Review the Conditions examples section for more.

  • document Image

  • Select the specifications for the condition.
  • EXAMPLE:

    1. Over
    2. 25 mph.

    Review the Conditions examples section for more.

  • document Image

  • Click Add.
  • document Image

  • Review your conditions.
  • NOTE: Use the Advanced Conditions Editor to further customize your condition.

    document Image

    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.

    1. Once you’ve added the first condition (Speed), select the second condition (Zone or zone type).
  • document Image

  • Select the specifications for the condition:
    1. Type
    2. Zone
    3. Event
  • document Image

  • Click Add.
  • document Image

  • To add the driver, click More…
  • document Image

  • Select either Asset, Driver or Group (in this case, Driver).
  • document Image

  • Search for and select the specific Asset, Driver or Group (in this case, Joe Day).
  • document Image

  • Click Add.
  • document Image

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

    document Image


    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.

    1. Once you’ve added the first condition (Speed), click More…
  • document Image

  • Scroll down the dropdown menu and select the Or logic condition.
  • document Image

  • Select your second condition (Speed Limit).
  • document Image

  • Select the specifications for the condition:
    1. Truck speed limit
    2. Over the limit by
    3. Exclude estimated speed limits
    4. Road speed provider
  • document Image

  • Click Add.
  • document Image

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

    document Image

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

    1. Speed > 105 km/h
    2. > 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:

    1. (Speed compared to Speed Limit Excluding Estimates data) > 10 km/h
    2. > 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:

    1. (Roads with speed limit) > 105 km/h
    2. > 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(

    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:

    1. Duration Between GPS Logs < 3m and Speed < 5 km/h and Ignition is true
    2. > 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]

    )

    )


    scroll-up