Naar de hoofdinhoud
Alle collectiesRailgenius - Gegevens & inzichtenRailgenius voor administrators
De titels en e-mails van Rule Engine alerts aanpassen
De titels en e-mails van Rule Engine alerts aanpassen

Een korte handleiding voor het aanpassen van de titels en de inhoud van de e-mail alerts die worden verzonden door de Rule Engine.

Meer dan een week geleden bijgewerkt

Met de Railgenius Rule Engine kunt je aangepaste e-mails sturen die gekoppeld zijn aan een alert die door een regel wordt getriggerd. Je ontvangt een e-mail als de alert wordt geopend en je kunt ervoor kiezen een tweede te ontvangen als de alert wordt gesloten.

Introductie

Als Railnova beheerder binnen je bedrijf kunt je dynamische content voor de titel van de alert, het onderwerp en de body van de e-mail instellen.

Je kunt ook een andere titel en e-mailtekst voor de afsluiting van de alert en notificatie instellen.

Editor

Om het bewerken te vereenvoudigen, zie je dat de dynamische teksten kleurgecodeerd zijn en dat de regels genummerd zijn:

Aangepaste tekst voor de titel van de afsluitende alert, dynamische tekst voor de hoofdtekst van de e-mail

Let op: als er een syntaxfout in de blauwe dynamische tekst staat, wordt deze rood zodat je precies kunt zien wat je moet corrigeren.

De titel van een open alert en het onderwerp van de e-mail

De standaardtekst voor de titel van een alert is de naam van de regel gevolgd door de naam van de asset:

De standaard alert titel is dynamisch!

Als je beslist om notificatiemails te sturen, zal dit standaard ook de onderwerpregel van de e-mail zijn.

Het is ook mogelijk om andere beschikbare velden te gebruiken, bijvoorbeeld een inside_workshop bericht:

Deze alert gebruikt een veld uit het inside_workshop bericht

Houd er rekening mee dat je de titel van een Open Alert op meerdere regels kunt schrijven, maar zodra je je nieuwe alert opslaat, worden alle regeleinden vervangen door spaties en wordt de tekst op één regel weergegeven.

Inhoud van de Open Alert E-mail

Het is ook mogelijk om een dynamische tekst aan de body van de e-mail toe te voegen die wordt verstuurd bij het openen van een alert.

Standaard bevat de e-mailtekst de volgende informatie:

Standaard tekstsjabloon

Je kunt de tekst natuurlijk naar wens aanpassen en zoveel informatie als je wilt toevoegen.

Dit is een voorbeeld van een aangepaste e-mail in het Duits met een langere tekst en dynamische inhoud:

Aangepaste sjabloon in het Duits over het bericht battery_warning_level

Let op: onderaan elke e-mailmelding wordt altijd een voettekst in de taal van de ontvanger van de e-mail weergegeven.

Deze voettekst bevat informatie over de naam en ID van de regel en kan niet worden gewijzigd.

Onderwerp en inhoud van de afsluitende e-mail

Als je een e-mail wilt ontvangen wanneer de alert wordt gesloten, vink dan het vakje "E-mailbericht verzenden bij sluiten" aan. Je hebt dan de mogelijkheid om de titel van de alert en de e-mail met de melding aan te passen.

Standaard zijn het onderwerp en de inhoud van de e-mail als volgt ingesteld:

Wordt alleen weergegeven als "E-mailbericht verzenden bij sluiten" is aangevinkt

Net als bij de open alert e-mail kunt je het onderwerp en de body van de e-mail aanpassen en zoveel tekst en dynamische inhoud toevoegen als je nodig hebt:

Aangepaste sjabloon in het Frans over het bericht battery_warning_level

Om te testen of een symbool bestaat (en zo ja, de waarde ervan te tonen), kunt je de {% if %} en {% endif %} tags gebruiken.

Bijvoorbeeld, als het locatieveld in het laatste battery_critical_level bericht bestaat en deze locatie bekend is, dan zal de e-mail het laatste batterijniveau en de laatste locatie van het onderdeel weergeven.

De locatie kan eenvoudig op deze manier worden toegevoegd:

Of verwerk het in een zin als deze:

Variabelen

Je kunt een set variabelen in de titel van de alert en/of in de hoofdtekst van de e-mail gebruiken.

Bericht

De bericht variabele is het bericht dat aanleiding gaf tot het openen of sluiten van de alert. Het heeft vele eigenschappen, zoals type, inhoud of tijdstempel.

Om bijvoorbeeld het type van het triggerende bericht weer te geven:

{{ message.type }}

Hier is een lijst van de verschillende berichtvariabelen:

  • message.type: het type van het bericht

  • message.content: JSON-inhoud

  • message.client: de identifier van het bedrijf waar dit bericht vandaan komt (indien aanwezig)

  • message.locomotive: de identifier van de locomotief waarvan dit bericht afkomstig is (indien aanwezig)

  • message.asset: de identificatiecode van de asset

  • message.device: de identificatiecode van het apparaat

  • message.timestamp: de datum en tijd waarop het bericht werd verzonden

  • message.recv_time: de datum en tijd waarop het bericht werd ontvangen

  • message.processed_time: de datum en tijd waarop het bericht werd verwerkt

  • message.is_open: de status van het bericht, als alert (True of False)

  • message.close_time: de sluitingstijd van het bericht

Asset

De asset variabel staat voor de asset waarvoor de alert is getriggerd. Het heeft eigenschappen zoals naam, type, enz. Als je de naam van de asset in de alert wilt weergeven, kunt je de volgende dynamische inhoud opnemen:

{{ asset.name }}

Hier is een lijst van de verschillende asset-variabelen:

  • asset.rid: is identificator

  • asset.name: zijn naam

  • asset.class_name: de naam van de asset type

  • asset.ecm_id: de ECM identifier

Regel

Op vergelijkbare wijze representeert de regel variabele de regel die het openen of sluiten van de alert heeft getriggerd. Het heeft eigenschappen zoals naam, beschrijving, enz.

Als je de regelnaam in de alert wilt weergeven, kunt je de volgende variabele opnemen:

{{ rule.name }}

Hier is een lijst van de verschillende regelvariabelen:

  • rule.name: de naam van de regel

  • rule.description: de beschrijvingstekst van de regel

  • rule.help_url: de URL die linkt naar hulp over deze regel

  • rule.priority_label: het prioriteitslabel van de regel, in de taal van de ontvanger

Velden per berichttype

Tot slot is er een variabele voor elk type bericht beschikbaar dat wordt gebruikt in de voorwaarden van de regel.

Als je regel een voorwaarde voor foutcodes event_cat_data_link_3500b heeft, kunt je de volgende dynamische inhoud opnemen om de beschrijving van de foutcode weer te geven die de alert heeft getriggerd:

{{ event_cat_data_link_3500b.description }}

Noteer dat alle variabelen van het standaard positie berichttype ook beschikbaar zijn, zelfs als het niet wordt gebruikt in de voorwaarden van de regel.

Dus als je de locatie wilt weergeven waar aan de voorwaarde van de regel is voldaan, kunt je dit toevoegen:

{{ position.location }}

Tags

We hebben ook een aantal tags toegevoegd om deze nieuwe functie te ondersteunen. Deze tags zijn een manier om specifieke inhoud weer te geven.

Hier is de lijst met tags die je naar behoefte aan de body van je e-mail kunt toevoegen.

Geef de datum en tijd in de lokale tijdzone van de ontvanger weer:

{% display_date message.timestamp %}

De momentopname van waarden voor alle berichtsymbolen weergeven die data configuratie hebben (dat wil zeggen: wat er standaard in de hoofdtekst van de e-mail staat):

{% snapshot_text %}

Link naar de pagina Data Inspector en de relevante gegevens (let op: de Data Inspector toont de gegevens met een tijdvenster van 5 minuten voor en na de alert):

{% data_inspector_url %}

Link naar de pagina Telematicagegevens en de relevante gegevens ( let op: de pagina Telematicagegevens geeft de gegevens met een tijdsvenster van 5 minuten voor en na de alert weer):

{% telematics_url %}

Link naar de Historiek-pagina en de relevante gegevens:

{% map_history_url %}

Om voorwaardelijke inhoud weer te geven als een symbool aanwezig is, gebruik de if / endif tags:

{% if battery_critical_level.location %}Location: {{ battery_critical_level.location }}{% endif %}

Support

Heb je nog vragen? Ga naar het Railnova-platform en klik op "Contact" voor hulp.

Was dit een antwoord op uw vraag?