Custom Email Templates

In this example we will show you how to customize your email templates, so you can send custom data through email.

The first thing that we need to do is to setup outgoing email in Administration > System settings > Email settings.

email-settings-1.PNG

You can send a test email clicking on button Send Test Email and a email should be sent to the admin user's email address (you need to add an email address to admin user in Administration > Users).

Now, suppose we have a temperature data point and we need to know if it surpass a limit of 50 degrees by receiving and email. We will need to create and event detector first for the temperature data point.

event-detector-configuration-1.png

Once we have created an event detector, we navigate to Event handler section and select HIGH TEMPERATURE event detector.

Here, we select Email type and set an Alias. We can also add Email Recipients where we can select a mailing list or specific users. Then, we can select the data points to be shown in the email. In this case we will use the next configuration:

event-handler-configuration-2.png

Finally in the Custom Template field we can set our own custom email:

custom-template-1.png

To code custom email templates, we use FreeMaker which is a template engine. With this, we can create great HTML emails templates like this one:

email-template-1.PNG

Check FreeMaker for more information.

You have this variables available to use in templates:

  • point: this variable contains general information related to data point

  • renderedHtmlPointValues: this is an array of the last values of data points.