6.4. Defining the Email Message

Cascade DataHub™ : Version 6.4
	Chapter 6. Email and SMS

To send an email you need to determine the type of email message, its recipients, title, and message body. This is done from the Email/SMS Events window, which you can access in this way:

In the Cascade DataHub Properties window, select Email/SMS .
In the Configure Email section press the Configure button.
Select the 1. Email tab and configure your email as explained below.

Message Type

Plain Text Message sends the text of the message as written in the source file or entered in this interface. Data point values will be assigned at the time the message is sent.

HTML Message sends the source file or entry in this interface as an HTML file. Data point values will be assigned at the time the message is sent.

Recipients

This can be a single email address, or a list of email addresses where each address is separated by a comma. Addresses can be in either of these two forms:

username@datadomain.com

User Name <username@datadomain.com>

Message Content

Subject Enter the subject of the message.

Body You can use a message from a file, or compose one in the editing box.

Use this file: lets you insert the name of a file that you want to send as the text of your email. This is not an attachment, but rather the body of your message. Press the ... button to browse for the file you need. To see some HTML file examples, please refer to Section 6.8, “HTML Message Examples”.

Use the following text: lets you write and edit the body of your message. To insert the name, value, timestamp, or quality of the point in the point-picker list, select Name, Value, Time, or Quality button as desired. Then click the Insert Point button. The DataHub will insert into your text the point name with the proper syntax for the desired output in the email.

If you want to send a message from a file, you can still use the text editor with its convenient interface to create it. Write up the message in the editor, then copy and save it to a file.

The value, time, and quality attributes of the DataHub points are accessed by using a special syntax. This is applied automatically in the text editor when you press the Insert button. For your reference, the syntax is as follows:

Button	Syntax	Example
Name	`domainname:pointname`	`DataSim:Sine`
Value	`<%= $domainname:pointname %>`	`<%= $DataSim:Sine %>`
Time	`<%= PointTimeString (#$domainname:pointname) %>`	`<%= PointTimeString (#$DataSim:Sine) %>`
Quality	`<%= PointQualityString (#$domainname:pointname) %>`	`<%= PointQualityString (#$DataSim:Sine) %>`

In this syntax, the special characters are used as follows:

Character	Use
`<% ... %>`	The enclosed expression will be evaluated by Gamma, the DataHub scripting language.
`$`	Indicates to Gamma that this is a DataHub point name.
`PointTimeString()`	A Gamma function that returns the timestamp of a DataHub point in an easily readable format.
`PointQualityString()`	A Gamma function that returns the quality of a DataHub point, as a text string.
`#`	Protects the DataHub point from being evaluated by Gamma until the function is called.


6.3. Sending a Test Message		6.5. Assigning a Trigger