-
This guide shows how the Event Rule wizard works and which are its different options. Step by step.
Creating a new rule
To create a new rule, go to Admin > Event Rules
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.
- 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.
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.
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.
| 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 |
- 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.
| 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 | |
| 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.
- 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.
