AddToList
(Alarm Manager module)
| Description: | Adds an alarm to the specified list in an Alarm Database, usually a custom list. |
| Returns: | Nothing |
Usage: ![]() |
Script Only. |
| Function Groups: | Alarm Functions |
| Related to: | Commission | EvaluateAlarm | RemoveFromList |
Format: ![]() |
\AlarmManager.AddToList(AlarmName, ListName, Action[, Timestamp, AccountID, Device, HookName, MachineID, Custom, FromPLC, Description, Config]) |
| Parameters: |
| AlarmName |
| Required text. A unique name for the alarm. Typically, the unique ID obtained using GetAlarmName. If there are multiple built-in alarms in a tag, the convention is to concatenate the UniqueID with a separator and a unique integer or string per alarm. For example, Concat(Root\UniqueID, \AlarmSeparatorString, 0). |
| ListName |
| Required. The name of the list to add to, e.g. “Active”. |
| Action |
|
A string or PhraseID that identifies the reason for the transaction. For default options, see Alarm Action Codes in Alarm API Structure Definitions |
| Timestamp |
| Optional. UTC timestamp of the value. Defaults to the current time. |
| AccountID |
| Optional. AccountID of operator |
| Device |
| Optional. Name of client device. |
| HookName |
| Advanced Option. Name of the hook module to call before logging this transaction. |
| MachineID |
| Optional. Workstation MachineID. Defaults to local. |
| Custom |
| Optional. Structure of custom fields to be logged with the event. |
| FromPLC |
| Advanced Option. Set to FALSE. |
| Description |
| Optional. Customized description, used if it differs from the description given to Commission. |
| Config |
| An Alarm Configuration Structure. Not required if the alarm has been commissioned via a Commission() call. |
| Comments: |
Advanced users only. AddToList can be used to add an alarm to a custom list. The custom list can be displayed by specifying it in a <ListFormats><Format> section of AlarmListsFormats.XML as defined in Customize Columns in Alarm Displays To add an alarm to the Active of Unacked lists based on an evaluation of a tag's Value compared to the alarm Setpoint, consider using EvaluateAlarm instead. (Although, AddToList can, technically, do this too.) |
Example:
To add an alarm to a custom "Deferred" list:
\AlarmManager.AddToList(AlarmName, “Deferred”, “DeferLabel”);
