GPS Event Rules wizard - step by step GPS Event Rules wizard - step by step

GPS Event Rules wizard - step by step

Marko Tomic Marko Tomic

Creating a new rule

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

mceclip0__1_.png

then select + Event Rule button

 

Now follow the Event Rule wizard:

1. Rule name and description

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.

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

 

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

 

4. Expressions

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

mceclip0__2_.png

Expression Description  
Analog Expression Suitable for evaluating analog signals (e.g. Speed, Temperature, etc.)  
Digital Expression Suitable for evaluating digital signals (e.g. SOS, Ignition, Door open, etc.)  
Driver ID in Tag Suitable for evaluating if a Driver ID is included in a specific tag  
Driver ID Login Suitable for evaluating Driver ID events  
Geofence Expression Suitable for evaluating geofence related activity  
Http Expression Suitable for generating HTTP events to an external system  
Offline expression Suitable for evaluating when a unit goes offline  
Points Of Interest Suitable for evaluating POI-related activity  
Rendezvous Suitable for evaluating if a vehicle is near another  
Script Expression Suitable for evaluating complex scenarios using scripting  
Speeding Expression Suitable for evaluating over-speeding  
String compare Suitable for evaluating strings upon received messages  

mceclip2__1_.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 the 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. 

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  
Driver ID Generates a notification when a Driver ID event is detected  
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  
Email Generates a notification via email  
Email Self Generates a notification to the associated email of the user that generated it.  
Flag Generates a notification of the type flag  
SMS Generates a notification of the type SMS  
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  
Text Generates a notification as text on the vehicle tracker interface  
Report Argument Generates a notification as a report argument to be used in reports  
Maintenance Reminder Alert Generates a notification when a vehicle maintenance is about to be due. To be used with Maintenace plugin.  
Tag Notifier Generates a notification as a Tag notifier  
RabbitMQ Generates a notification to be used with RabbitMQ plugin  
Variable Generates a notification of the type variable  
Fleet app Generates a push notification to be used with the mobile Fleet app  

6. Presentation

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

mceclip1__1_.png

  • Show in map view: enable to display the event rule on the map and in panels (e.g. Events, Tracks, etc.)
  • 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. 
  • Sound: enables generating a sound when the alert is triggered. This option requires the Sound plugin.

mceclip0__3_.png

Was this article helpful?

0 out of 0 found this helpful

Add comment

Article is closed for comments.