Alarm Tag Templates in AlarmWorX64 Server

A configuration in the AlarmWorX64 Server database exists for the purpose of holding alarms defined for OPC tags. These alarms are called alarm tags, and there can be hundreds or thousands for a configuration. Creating them one by one takes time as well as attention to detail. You can however, create templates that are typically or always used by certain types of OPC tags, then use those templates as the basis for creating multiple alarm tags one at a time. Not only does this save you time in creating alarm tags, it also makes it easier to maintain alarm tags as time passes. Why? Because after you use a template to create an alarm tag, when you change the template, the alarm tags continue to reference the template; changes that you then make to the template are also made to the alarm tags that reference the template.

 

The steps for defining a template are the same as for defining an individual alarm tag. The form for creating a template is nearly identical to the form for creating an alarm tag. One major difference is that the template form has one additional tab, the Alarms Assigned tab, where you can see the alarm tags that reference the template.

 

The remainder of this topic describes how to

Creating a Template for OPC Alarm Tags

Tip: When you are creating new templates for a new configuration, you can use the existing templates from an existing configuration if appropriate. To do this, you can use the Import and Export features that are available in AlarmWorX64 Server to export the existing configuration's Template folder and import it into the new configuration. For instructions, refer to Exporting and Importing AlarmWorX64 Server Components.

 

You create a template for an alarm tag by using AlarmWorX64 Server and following the steps below:

  1. In the Project Explorer, right-click Templates in the AlarmWorX64 Server navigation tree, then select the Template command from the context menu. The AlarmWorX64 Server Template form appears.

The new template appears at the bottom of the Templates configuration tree with the name New Item. Also, the AlarmWorX64 Server Template form opens; here you can set the characteristics of the alarms that will monitor incoming values from OPC tags.

  1. Enter the name of the template into the Name text box; this name replaces the default name of New Item. The box to the right of the Name box shows the date and time the template was last modified. Note that modifications to the template are made simultaneously to the alarm tags that reference the template.

  1. On the General tab, enter 1 into the Enabled text box to activate tags created from this template. Active alarm tags are monitored. Alternatively, you can click the ellipsis button [...] to create an expression that evaluates to True or 1. If you don't want to automatically enable alarm tags created using this template, set the value to 0.

Tip: You may prefer to enable and disable the alarm based on a condition. For example, you may not want to monitor water pressure when the valve is shut off because the drop in pressure would trigger the alarm. In this case, you can specify the tag for the valve’s reading in the Enabled field such that when the valve is open (1) the alarm is enabled, but when the valve is closed (0) the alarm is disabled.

  1. Enter the file to display in the Default Display by clicking the ellipsis button [...] and browsing for a file. This is the display to be used by default for all alarm tags created from the template. Changing the value in this field may change it on alarm tags that reference this template; for more information, refer to Maintaining  Alarm Tags from Their Template, below.

  2. Enter a description of the alarm's purpose in the Description text box. Although this field is optional, it may be a critical component later on for operators need to work with it but who are not familiar with its origins. Make the description complete so that the alarm's purpose is clear and can be understood by others who will need to work with it and maintain it. Changing the value in this field may change it on alarm tags that reference this template; for more information, refer to Maintaining  Alarm Tags from Their Template, below.

  3. Optionally, you can specify a delay in the Delay (seconds) field. A delay suppresses alarm reporting for a period of time after it is detected. If the alarm condition still exists after the delay, the alarm is reported. Using a delay is helpful for offsetting readings that fluctuate wildly or sensors that sometimes return faulty readings; you can also use it with equipment that typically returns to normal quickly. If you leave this field empty, the alarm is reported as soon as it is detected. Changing the value in this field may change it on alarm tags that reference this template; for more information, refer to Maintaining  Alarm Tags from Their Template, below.

  4. Specify the alarm's Base Text, which is the message that appears with the alarm when it is displayed. It is important to enter base text information for your users along with Help Instructions. The text and instructions should indicate the alarm's state, and can include informational text to runtime operators for responding to the state, such as providing phone numbers or contact information or listing steps for the operator to follow. Changing the value in these fields may change them on alarm tags that reference this template; for more information, refer to Maintaining  Alarm Tags from Their Template, below.

Note: The Base Text field automatically adds a single space at the beginning of the text string, so you should be aware of this when filtering alarms.

  1. Now you must use the following tabs to create one or more alarm conditions for the alarm tags that will be created using the template: Alarms Limit/ Digital tab, Alarms Deviation / Rate of Change tab, Alarms Rate Limit / Trigger Limit tab. The alarm conditions that you can configure using these tabs are described below. You can define the following types of alarms. Click on the hyperlink to see how to configure the alarm condition.

  1. On the Related Values tab, specify up to 20 OPC tag values to be collected when an alarm occurs. Collect this information when you need to troubleshoot the circumstances that caused an abnormal condition. For more about this tab, refer to Related Values.

  2. When you are done, click Apply to create your alarm tag.

You can edit an existing template by double-clicking on the template in the tree control or by right-clicking the name and selecting the Edit or Edit on New Tab command in the context menu. You can also use the Copy and Paste commands to create copies of a template, or Cut and Paste to move a template from one database configuration to another. The context menu also is where can delete a template.

 

Return to Top

Using a Template to Create Multiple Alarm Tags

Once you have created a template, you can use it to create alarm tags. For information about how to do this, refer to:

Return to Top

 

Viewing the Alarms that Use a Template

  1. In the Project Explorer, right-click the template in the AlarmWorX64 Server navigation tree, then select Edit or Edit on New Tab. The AlarmWorX64 Server Template form appears.

  2. Go to the Alarms Assigned tab.

Return to Top

 

Maintaining OPC Alarm Tags from Their Template

If OPC alarm tags were created using a template, the alarms still reference the template. Instead of modifying each OPC alarm tag individually, you can maintain the alarms uniformly from the template. When you change a value on the template, the value is essentially "pushed" to the alarms that reference the template, allowing you to maintain a uniformity and making it easy to update alarm tags.

 

The fields that can be maintained from the template are identified in the table below.

 

Fields on an Alarm Tag that the Tag's Template Can Maintain

 

Alarm Tag Field:

Controlled by the Template:

 

Tab or Alarm:

Name

No

 

OPC Input

No

 

Enabled

Yes

General tab

Default Display

Yes

General tab

Description

Yes

General tab

Delay

Yes

General tab

Base Text

Yes

General tab

Help Instructions

Yes

General tab

OPC Override Input

Yes

Limit alarm

Digital alarm

Rate of Change alarm

Rate Limit alarm

Trigger Limit alarm

OPC Input 2

Yes

Deviation alarm

Deadband

Yes

 

LoLo, Lo, Hi, and HiHi values

Yes

 

Message Text

Yes

 

Severity

Yes

 

Req Ack

Yes

 

Alarm State Value

Yes

Digital alarm

ROC Limit/Sec

Yes

Rate of Change alarm

Enable

Yes

Trigger Limit alarm

Return to Normal

Yes

Digital alarm

Rate of Change alarm

Related Values

Yes

Related Values tab

 

When maintaining a template's values, keep in mind the following:

To push changes to alarm tags from their shared template, follow these steps:

  1. In AlarmWorX64 Server's Project Explorer, expand the navigation tree to expose the Templates node and its template.

  2. Right-click the template you want to modify and select Edit on New Tab. The AlarmWorX64 Server Template form opens on its own tab.

  3. Make the changes you want to push to the alarm tags that reference the template, noting the limitations listed above.

  4. When you are done, click Apply.

  5. To confirm that the change has been applied, go to the template's Alarms Assigned tab to see the list of alarm tags that reference the template. Choose the alarm tag you want to review. Note the tag's configuration and name. Then:

Return to Top

 

See also:

Database Configurations

Alarm Tags