Email

AlertWorX allows you to configure Email notifications within the Workbench.

 

To Configure Email Notifications:

  1. Start the Workbench, then expand your project. Next, expand the Alarms and Notifications node to show the AlertWorX node. Expand the AlertWorX node to show the Configurations node. Expand the Configurations node to show the Email node.

  2. Right-click the Email node in the navigation tree and select Add Email Node, as shown in the figure below.

Add Email Node from the Project Explorer

 

-OR-

 

Select the Email node in the Project Explorer, then click on the Add Email Node button, shown below, in the Edit section of the Home ribbon in the Workbench.

 

Add Email Node Button

  1. This opens the Email Node properties window, shown below, beneath the Project Details section in the Workbench. Enter a unique name in the Name text entry field.

Email Node Properties

Email Settings Tab

Email Node - Email Settings Tab

 

Hardware and Data

  1. In the Hardware and Data sections, you can enter the Node name of the Alert Email Service in the text entry field. Next, enter the Mail Server to connect to. Provide the Username and Password for the mail server, as well as a Port number. In the From Address field, enter an email address recognized by the mail server. Click the Enable SSL Security checkbox if the mail server requires an SSL/TLS security connection. Click the Use UA Points checkbox when Notification Message Fields are loaded as data points. Click on Only Use Targeted Alarms if flagged alarms are to be used. Alarms are flagged by adding flags to alarms in the alarm server. If the Receive commands on this node checkbox is checked, this node will receive commands from the client.

Notification Message

  1. In the Notification Message section, click on the Template pulldown menu to select from existing templates or Do Not Use Templates. You can also add (+) or delete (-) existing templates. Added templates will appear in the Project Explorer beneath the Email node. If you have created a template, you can give it a name in the Template Name text entry field.

NOTE: Any string/string block containing the colon character ':' or beginning with the @ character will be treated as a data point if the 'Use UA Points' option is enabled. To ensure correct AlertWorX template behavior:

In cases where:

...the system will use the base default value for that entry.

 

With the following configuration:

 

Use UA points = 1. Template Message:   @Some:BadPoint

 

...the Base Template string for Message will be used instead of the Template string.

  1. Enter a Subject in the text entry field or click on the button to open the Data Browser. You can then select a data source that can populate the Subject field.

  2. Enter a Message in the text entry field. Similar to the Subject field, you can click on the (Browse Tags) link to open the Data Browser and select a data source that can populate the Message field. Clicking on the (Add alarm field) link brings up the Select a Field dialog, where you can create subject and message configurations that will replace the field name with the value from the alarm that triggered the message. For instance, an example string can be:
    Alarm: {SourceNameBaseEventType} reported: {MessageBaseEventType}  

    You can also click on the
    (Send Test Message) link to test the hardware settings. Note that you must have the Node, Subject, Message and To Address fields set correctly in order for the test message to work.

  3. Enter your intended email address in the To Address text entry field or click on the button to open the Data Browser. You can then select a data source that can populate the To Address field.

  4. If you have checked the Use UA Points checkbox in the Hardware and Data section, the Send and Status fields will be activated. In the Send text entry field, you can enter a data source that will transition from False to True to cause a message to be sent or click on the button to open the Data Browser and select that data source.

  5. The Status field is also active only when the Use UA Points checkbox is checked. This field can be used to enter the status of the Sent message. You can also click on the button to open the Data Browser and select a data source to populate the Status field.

Alarms Subscription Tab

Email Node - Alarms Subscription Tab

  1. In the Alarm Subscriptions tab, click on + Click here to add new item. This allows you to enter a Tag name in the text entry field or click on the to open the Data Browser and navigate to your selected tag. You can then enter Min. Severity and Max. Severity in the next fields. Click on the field under the Alarm Type column and it will turn into a pulldown menu, where you can select from None, Simple, Tracking, Condition, Simple & Tracking, Simple & Condition, Tracking & Condition or All.

  2. Once you have completed setting the Email Node properties, click on the Apply button. The new Email Node will now appear in the Project Explorer.

  3. For the configuration changes to reflect, the ICONICS Alert Email Service needs to be restarted.

Using AlertWorX with Gmail

When using a Gmail email account with AlertWorX, be sure to use the following settings:

 

Mail Server: smtp.gmail.com

Username: Gmail address

Password: Gmail password

Port: 587

From Address: Gmail address

Enable SSL Security: checked

 

In addition, users will need to modify their Gmail account to enable the option "Allow less secure apps to access the account". For more information, visit https://support.google.com/accounts/answer/6010255?hl=en

 

See Also:

About AlertWorX

SMS/Text

ATT Configurations

Twilio Configurations

Setting Up Twilio