E-mail Messages

Logic Flows can be used to send e-mails when conditions exist in your system that require attention. For example, it is common to send e-mails to the station’s engineers when silence is detected at a transmitter site.

To send e-mails, you must first configure the e‑mail host settings under the System navigation section. If you have not configured these settings, please review the Email Settings section of the System chapter.

Once the e-mail host has been configured and test e-mails can be sent successfully, click the Email Messages link in the Navigation bar. This is where you can create e-mail messages that can be sent when specific actions take place in the system.

Reference

Notes

1

The unique name of the e-mail message.

2

The SendTo e-mail addresses to which the message will be sent.

3

The Subject line to be used by the e-mail message.

4

Displays the last time the message was sent.

5

Displays information about whether the last send attempt was successful or failed.

6

Click edit to modify the associated e-mail message’s properties.

7

Click the minus icon to remove the associated e-mail message.

8

Click the plus icon to add a new e-mail message.

Adding a New Email Message

  • Click the plus icon to create a new email message

  • Complete the fields on the Email Message Editor

Field

Notes

Message Name

Type a Name for this email message. This name will be used when this message is accessed via Logic Flows or the API.

Recipient Email Address(s)

Type a comma-delineated list of e-mail addresses to which this message will be sent.

Subject

Type a Subject line for generated emails.

Auto send on body change

When checked, you have the option to define new body content in your e-mail via a Logic Flow, and have it send automatically without having to set the Send property.

Body

Type the text of the e-mail message. You can embed the date and time the message was sent into the subject or body of the email using the variable <%DateTime%>. In the example above, when the email is created, the Subject like would include the current date and time like this:

Hello YYY – 2017-12-14T13:51:28.033-05:00

While the Body of the message would look like this:

Audio failure? YYY? - 2017-12-14T13:51:28.033-05:00

  • When all fields are complete, click Apply to save your changes

Using E-mail Messages in Logic Flows

Once created, e-mail messages become available for use in Logic Flows. In the following example, we will send the AudioFailure email message whenever MyAlarm’s AlarmState becomes Silent. We accomplish this by setting the write-only property Send to the value True.

You can also change the body of the e-mail message as a Logic Flow end point. This becomes especially useful if you have several conditions that could cause an e-mail alert. For example, we could create a generic e-mail message making sure that the AutoSend on body change checkbox is engaged. Then we could create multiple Logic Flows, each of which alters the body of the message depending on the start point. For example:

Here we use two Logic Flows to send four different messages to the same e-mail recipients.

  • First Flow

    • If “AlarmA” is Silent -> Set the body of the “AudioFailure” message to be “My Alarm is Silent.”

    • If “AlarmA” has audio -> Set the body of the “AudioFailure” message to be “My Alarm is fine.”

  • Second Flow

    • If “AlarmB” is Silent -> Set the body of the “AudioFailure” message to be “AirChain Silent.”

    • If “AlarmB” has audio -> Set the body of the “AudioFailure” message to be “AirChain OK.”

Since we engaged the option to send the e-mail each time the body property of the e-mail changes, this is all that we need to do to handle four alarm conditions using one defined e-mail message.