Event Rules wizard - step by step

This guide shows how the Event Rule wizard works and which are its different options. Step by step.

Read event rules introduction here.

Creating a new rule

To create a new rule, go to Admin > Event Rules > + Event Rule

mceclip1.png

Step 1 - Name your rule

The first step is to name your rule. We recommend using a name that describes what the rule will do, in short.

mceclip0.png

  • Enabled: Yes/No - This option sets the event rule to active or inactive for live events, more info about live or buffered data here.

Step 2 - Who this rule applies to

Select which user tags you want this rule to work for. If you don't select any tags in this step, the event rule will apply to all your units in the application.

mceclip2.png

Step 3 - Schedule rule activity

If you select Activate on schedule, you can set this event rule to be triggered only under the specified dates/time. Otherwise, the rule is active at all times.

mceclip3.png

Step 4 - Expressions

The expressions define which conditions trigger the event rule. There are many different conditions to be used and you can add more than one at the same time.

mceclip4.png

Expression Description More info
Analog Suitable for evaluating analog signals (e.g. Speed, Temperature) -
Digital Suitable for evaluating digital signals (e.g. SOS, Door open) link
Driver ID in Tag Suitable for evaluating if a Driver ID is included in a specific tag link
Driver ID Login Suitable for evaluating Driver ID events link
Geofence Suitable for evaluating geofence-related activity link
Http Suitable for generating HTTP events to an external system link
Interval Suitable for evaluating signals under an interval -
Offline Suitable for evaluating when a unit goes offline link
Points Of Interest Suitable for evaluating POI-related activity link
Rendezvous Suitable for evaluating if a vehicle is near another deprecated
Script Suitable for evaluating complex scenarios using scripting link
Speeding Suitable for evaluating over-speeding link
String compare Suitable for evaluating strings upon received messages -
Time Interval Suitable for evaluating time intervals -
Visit All Suitable for evaluating if a unit has visited all POIs or Geofences deprecated

 

mceclip2.png

  • Show advanced options: sets a value that will end the initial expression. This is meant when you want to use a different ending condition than the initial expression that triggers the rule.
  • Delayed event: you can specify a number of minutes before an event triggers. This is useful for avoiding to have many notifications at once if an expression is met repeatedly in a short period of time.
  • Automatically trigger event after the delay specified above: as the events are triggered on incoming data only, this option forces triggering the alert after a specific number of minutes despite not receiving new data. For instance, if you have three minutes delay set, and the messages from the device are sent with five minutes intervals, it will take up to five minutes before the condition is fulfilled and get the notification. Use this option only if strictly necessary. 

Step 5 - Notifications

Notifications define how you want to get notified when the expression/s in step 4, had been met. You can add more than one notification method for each event rule.

mceclip1.png

Notification Description More info
Driver ID Generates a notification when a Driver ID event is detected link
Argument Generates a notification of the type argument. Argument could be used to visualize variables in certain areas of the workspace and some panels in the application. -
Command Generates a notification of the type command to be sent to devices link
Email Generates a notification via email link
Email Self Generates a notification to the associated email of the user that generated it. -
Flag Generates a notification of the type flag deprecated
SMS Generates a notification of the type SMS link
SMS Self Generates a notification to the associated email of the vehicle that generated the event -
Icon Generates a notification as icon on the vehicle tracker interface link
Text Generates a notification as text on the vehicle tracker interface link
Report Argument Generates a notification as a report argument to be used in reports link
Maintenance Reminder Alert Generates a notification when a vehicle maintenance is about to be due. To be used with Maintenace plugin. link
Asset Protection Reminder Generates a notification for Asset Protection plugin deprecated
Tag Notifier Generates a notification as a Tag notifier link
Template Command Notifier Generates a notification as a command to be sent to a device link
RabbitMQ Generates a notification to be used with RabbitMQ plugin link
Variable Generates a notification of the type variable link
Fleet app Generates a push notification to be used with the mobile Fleet app link

 

Step 6 - Presentation

In this part, you can configure how to make visible the alert either on the map or in the Events panel.

mceclip1.png

  • Show in map view: enables the presentation feature on the map and the rest of the options that follows:
  • Close behavior: allows deciding if you want to close the alert manually or automatically in the event panel. The alert closes automatically when the 4. Expression is no longer true.
  • Comment on close: allows deciding if you have to add a comment before manually closing the event in the event panel. More info about comments here.
  • Sound: enables generating a sound when the alert is triggered. This option requires the Sound plugin. More info about sound alert here.

mceclip0.png