With Railgenius, you can be informed whenever an asset enters a geographical zone. But before you can receive an alert when an asset enters a certain zone, you first need to create a label category, labels, and set up the zone(s).

To create a rule in the Railgenius Rule Engine, you must be an administrator. If you're not, please contact an administrator within your company to set this up for you.

First of all, you have to create a new category of labels for the geographical zone alert. If you already have a label category for geographical zones and only need to add a new label, you can skip this step and move on to the next one.

To create a label category, go to the administration panel and scroll down to the “Labels” section.

Click on the "Add category" button on the top right of your screen, and fill out the form on the next page. Give the category a name (e.g. “Geographical zones”) and save the new category by clicking on the blue save button.

Now you can create different labels representing your geographical zones: head over to the “Label” configuration in the administration panel.

For our example, we will create the following labels: South of France, North of France, and Swiss border. First, enter the name of the new label, and then select the category the new label belongs to.

We are almost done! But before we can send out alerts by geographical zone, we first need to create the actual geographical zones on the Railnova platform. You can find out how to create geographical zones here. For our example, you can see that we have configured the "South of France" zone.

Almost there! You've now set up all the necessary items to create the alert that will notify you when an asset enters a certain zone, in our example the South of France.
​

Now it's time to set up the rule itself. 

To do so, navigate in the administration menu to the "Rule Engine" section and click on "Rules".

You'll see a list of the rules that have already been created, whether they are active or not. Click on "Add rule" on the top-right of your screen to open the alert creation page and start by giving a name to your rule.

Check the "Active" box to ensure your rule will start sending alerts when you save it.

As with the maintenance notifications, you can select specific assets for which you want to receive alerts, or if you leave it empty, you'll receive alerts for all your assets.

You can then define what triggers the alert and what closes it. Choose "position" from the first drop-down menu, then "position.poi.label" from the second menu, then "in", and finally, the zone you want to trigger the alert for.

Use the same parameters in the first two drop-down menus, then "not in" in the third one, and the geographical zone to close the alert.

You can then choose a priority, modify the open alert name, add a help URL and a description and check if you want to show the alert in the Live Monitoring.

The open alert name includes the rule and asset names by default.

Note that the live monitoring page and the email subject will show the "Open alert" text.

You can then select which email addresses should receive the alert.

By default, the email contains the following information:

If you wish to receive a second email when the alert closes, please check the "Send notification email when closing" box. Two new fields will open, "close alert" and "close email body".

The close alert name includes "Closed", the rule name and the asset name by default.

Please note that the live monitoring page and the email subject will show the "Close alert" text.

You can check this article if you wish to customise your alert titles and emails.

Once you're done, click on the blue "Save" button at the top-right of the page to save your new rule.

Do you still have questions? Go to the Railnova platform and click "Contact us" for help!