Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Overview

The Alarm Namespace in .NET allows for Alarm management through properties and methods, enabling access to specific alarm attributes and settings. Use @Alarm to reference the Alarm Namespace, followed by attribute accessors like .Item, .Group, .Area, or .GlobalSettings for detailed control.

Methods such as .GetItemList or .GetChildrenAreas facilitate list retrieval and area categorization, while properties like .TagName or .Sound adjust individual alarm settings, enhancing real-time monitoring and condition evaluation capabilities

Introduction to Alarms module

The Alarms module is a powerful tool designed to monitor and manage alarm events within your solutions, providing alerts for critical events, and storing data for future analysis.

On this page:

Table of Contents
maxLevel3
stylenone


Advanced Configuration

Alarm Properties

The Alarms module can be customized to meet specific requirements. This section will cover the various configuration options available in the Alarms module.

The following are some of the settings that can be customized:

  • Alarm Notification: This setting allows the user to specify how alarms are notified to users.

  • Sound: This setting allows the user to specify the sound that should be played when an alarm is raised.

    Info

    For information on sound configuration, go to the Alarm Groups Sounds page.

  • Display: This setting allows the user to specify the display options for the alarms.

  • Audit-Trail: This setting allows the user to specify whether or not to log alarms and events.

  • Database: This setting allows the user to specify the database where alarm information is stored.

  • Security: This setting allows the user to specify the security settings for the Alarms module.

  • In addition to the global settings, the Alarms module can be customized further by creating AlarmGroup, AlarmArea, and AlarmItem. These can be used to group and organize alarms based on specific criteria.

    The next sections will cover how to create and manage AlarmGroup, AlarmArea, and AlarmItem.

    Using Pre-Defined Groups

    The Alarms module provides pre-defined AlarmGroup that you can use to quickly configure alarms for common applications. These pre-defined groups have pre-configured properties that make it easier to create and configure alarms for specific purposes.

    To use a pre-defined Alarm Group, you simply need to select it from the list of available groups and configure any additional properties as needed. The available pre-defined groups may vary depending on the version of the Alarms module that you are using and the features that have been installed.

    Some common AlarmGroup that may be available, include:

    1. High Priority Alarms
      This group is used to track critical alarms that require immediate attention. The alarms in this group will typically have a high priority and may be configured to generate notifications or take other actions automatically.

    2. Medium Priority Alarms
      This group is used to track alarms that are important, but not as critical as high priority alarms. The alarms in this group may have a lower priority than those in the high priority group, and may not require immediate attention.

    3. Low Priority Alarms
      This group is used to track alarms that are less critical than medium priority alarms. The alarms in this group may have a lower priority than those in the medium priority group and may not require immediate attention.

    4. Equipment Alarms
      This group is used to track alarms related to specific pieces of equipment or systems. The alarms in this group may be configured to generate notifications or take other actions specific to the equipment being monitored.

    5. Production Alarms
      This group is used to track alarms related to production processes or activities. The alarms in this group may be configured to generate notifications or take other actions related to the production process being monitored.

    Using pre-defined AlarmGroup can save time and effort in configuring the Alarms module, as the properties of the alarms in the group are already pre-configured. However, you can still customize these pre-defined groups or create new ones as needed to fit your specific requirements.

    Access Alarms Namespace to see the properties of the alarm server. You can also find two more objects and its properties, they are as follow:

    The tag properties are connected with the Alarms module. See the example below:

    Example

     Tag.Tagname.Hi.Limit

     Configuration and runtime status of the HI Limit condition for the tag. The naming of all tag properties follow this same method.

    To learn about the basic concepts of namespaces and objects, you can refer to Objects and Namespaces.


    Alarm Namespace

    The Alarm Namespace in .NET offers a structured approach to alarm management, leveraging dot notation for intuitive access to alarm properties and methods. Starting with @Alarm to specify the Alarm namespace context, dot notation enables navigation through alarm attributes such as .Item for individual alarms, .Group for categorized alarms, .Area for location-based alarms, and .GlobalSettings for module-wide configurations. This notation facilitates the retrieval of specific alarm details, manipulation of settings, and execution of methods like .GetItemList for monitoring and managing alarms in real-time applications. It exposes properties and methods from the .NET objects used by the Alarms runtime. You can use these properties and methods on your Displays or to create Scripts. 


    Code Block
    titleAlarm Item
    @Alarm.Item.ID0.TagName

    @Alarm refers to the Alarm Namespace.

    .Item accesses the specific item (or alarm point) attributes.

    .ID0 specifies the first item or a unique identifier for a specific alarm item in a list or collection of alarms.

    .TagName is the property that holds the name of the tag associated with the alarm item, such as a sensor name, a machine part, or any identifier used within the system.

    In code, this retrieves the tag name of the first alarm item, which is a string.


    Code Block
    titleAlarm Group
    @Alarm.Group.Warning.Sound

    @Alarm refers to the Alarm Namespace.

    .Group denotes a specific group of alarms or a categorization within the alarm system.

    .Warning is the selected group of alarms classified as warnings.

    .Sound refers to the sound property for Warning alarms, indicating what sound to play when a warning alarm is triggered.

    This line of code is used to retrieve or set the sound that should be played when a warning-level alarm occurs.


    Code Block
    titleAlarm Area
    @Alarm.Area.Brewery.GetChildrenAreas

    @Alarm refers to the Alarm Namespace.

    .Area represents a logical or physical area within the environment being monitored.

    .Brewery specifies a specific area named 'Brewery', in a facility that produces beer.

    .GetChildrenAreas is a method that returns a list of areas within the Brewery area.

    When executed, this code provides a collection of all the sub-areas or zones within the 'Brewery' area.


    Code Block
    titleAudit Trail
    @Alarm.GlobalSettings.AuditTrail.TagChanges

    @Alarm refers to the Alarm Namespace.

    .GlobalSettings accesses the global settings of the alarm module.

    .AuditTrail refers to a logging or history-tracking feature within the alarm system.

    .TagChanges indicates a specific setting or log that records all changes made to tag properties within the alarm system.

    This is used to review or activate the tracking of all changes made to alarm tags across the entire system for auditing purposes.


    Code Block
    titleAlarm GetItemList
    @Alarm.GetItemList

    @Alarm refers to the Alarm Namespace.

    .GetItemList is a method that returns a list of all the items (alarms, sensors, etc.) that are being monitored by the alarm module.

    Alarms Runtime Attributes

    The T.Modules.Alarm has the properties of the alarm server. The Alarm.Group object has the list of all defined groups and their properties.The Alarm.Item object has all AlarmItem and their properties.The tag properties are connected with the Alarms module.

    Example

     Tag.Tagname.Hi.Limit

     Configuration and runtime status of the HI Limit condition for the tag. The naming of all tag properties follow this same method.

    See the T.Modules.Alarm Namespace for the complete programming reference!


    In this section:

    Page Tree
    root@self
    spacesV10

    ...