SMS/Text

AlertWorX allows you to configure SMS/Text notifications within the Workbench.

To Configure SMS/Text Notifications:

1. In Workbench, expand Project Explorer > Alarms and Notifications > AlertWorX, and then do one of the following:

   • Right-click SMS/Text Nodes, and then select Add SMS/Text Node.

   • Click SMS/Text Nodes, and on the Home ribbon, click Add SMS/Text Node.

2. In the NewSMS/TextNode dialog box, configure the new node configuration, as follows:

   1. In Name, enter the SMS/Text node configuration name.

   2. Click the desired tab, configuring each section:

      SMS Settings Tab

      • Enable the SMS node: To activate the node, select the checkbox.

      • Node: Enter the node name of the Alert SMS/Text Service.

      • Device: Enter the name of the modem.

      • Pin: Enter the personal identification number to securely access the service.

      • Baud Rate: In the drop-down list, select the modem communication rate.

      • Input String: Enter the modem initialization string sent to the modem.

      • Paging Debug File: Enter the paging debug destination file. To browse to the file, click .

      • Use UA Points: To load the Notification Message Fields as data points, select the checkbox.

        • Send: Enter the data source that will transition from False to True to cause a message to be sent. To open the Data Browser and select the data source, click .

        • Status: Enter the status of the Sent message. To open the Data Browser and select the data source, click .

      • Receive commands on this node: To receive commands from the client, select the checkbox.

      To test the SMS, click Test SMS. In Send a test message, verify the contents of Node, Subject, To, and Message, and then click Send Message.

      Message Settings Tab

      Alarm Filter Section

      Using alarm filters, you can limit the number of alarm messages sent based on specific alarm criteria, such as high-severity alarms or specific alarm areas.

      1. To activate alarm subscriptions, alarm messages and filtering, and message templates, select Enable alarm subscription and send a message for every incoming alarm.

      2. In Filter Expressions, click Click to edit expression, and then build the expression by doing the following:

         1. In the left panel, double-click the parameters.

         2. In the right panel, click the expression elements (Arithmetic, Relational, Logical, etc.).

            • Example 1: To only send alarm messages for severity equal to or greater than 800, enter x={{field:Severity}} >= 800.

            • Example 2: To only send alarm messages for alarms containing Tower3, enter x=rgmatch({{field:SourceName}},"Tower3").

         3. Type values or descriptions, as needed.

         4. To test the expression, click .

         5. Click OK.

      Notification Message Section

      You can build the alarm messages that you are sending, including the subject, the body, the sender, and the recipient. In addition, you can create templates of subject and message combinations that you can reuse for other node configurations.

      1. Template: In the drop-down list, select the desired message template. If you do not want to use a message template, select Do Not Use Templates. To manage the template list, do the following:

         • Refresh the list of message templates

         • Create/Edit message templates

           1. To create a new message template, click Click here to add new item.

              To edit an existing message template, select the desired message template.

           2. Click Apply & Close.

           Alternatively, expand Project Explorer > Alarms and Notifications > AlertWorX, and double-click Templates.

         If you enable Use UA Points above, AlertWorX interprets all template values starting with : or @ as data points. If you leave the template values empty, AlertWorX will use the base default values instead of a null value, which would generate an invalid point.

      2. In Subject, enter the subject of the alarm message. For assistance, click Click to edit expression, and then build the expression by doing the following:

         1. In the left panel, double-click the parameters.

         2. In the right panel, double click the expression elements (Arithmetic, Relational, Logical, etc.).

         3. Type values or descriptions, as needed.

         4. To test the expression, click .

         5. Click OK.

      3. In Message, enter the body of the alarm message. For assistance, click Click to edit expression, and then build the expression by doing the following:

         1. In the left panel, double-click the parameters.

         2. In the right panel, double click the expression elements (Arithmetic, Relational, Logical, etc.).

         3. Type values or descriptions, as needed.

         4. To test the expression, click .

         5. Click OK.

      4. In To, enter the name and/or address of the recipient. To open the Data Browser and select the recipient, click .

      Alarms Subscription Tab

      1. To add an alarm subscription, click Click here to add new item.

      2. In the Data Browser, select the desired tag, and then configure the settings, including Min. Severity, Max. Severity, Categories, and alarm source fields.

3. Click Apply & Close.

See Also:

About AlertWorX

Email

ATT Configurations

Twilio Configurations

Setting Up Twilio

Setting Up Vonage