The Advanced Alarms Topics section explain how to leverage all potential of the Alarm module within the software platform, maximizing its capabilities for applications demanding precise control over advanced alarm customizations. The Alarms Namespace in .NET allows for precise alarm management through properties and methods, enabling access to specific alarm attributes and settings. Use @Alarm to reference the alarm context, 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.
On this page:
Advanced Configuration
The Alarms Module allows the user to specify the sound that should be played when an alarm is raised. For information on sound configuration, access the Alarm Groups Sounds page.
Alarms Runtime Attributes
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. The Alarms Runtime Attributes page lists all options available.
Examples
Check some example about Alarm Runtime Attributes:
@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.
@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 a subgroup or category 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.
@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.
@Alarm.GlobalSettings.AuditTrail.TagChanges
@Alarm refers to the Alarm Namespace.
.GlobalSettings accesses the global settings of the alarm system.
.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.
@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 system.
In this section: