Alarm table

About 4 min read

TwAlarmTable · Category: Operations

Settings

These settings are in the properties panel on the right while the widget is selected, mostly in the Alarm Table Settings section. The default value is the value the widget has when it is first added to a page.

Alarms

Setting	Type	Default	Description
Alarms shown stateFilter	Selection	active	Active: every alarm that is not locked. Unacknowledged: new alarms and cleared alarms that are not acknowledged yet. All: locked alarms too. Known limitation: after a reconnect or page reload, an alarm that cleared before it was acknowledged appears again only at its next state change. Options: active Active, unacknowledged Unacknowledged, all All (including locked)
Maximum rows maxVisibleRows	Number (1–1000)	200	Newest alarms first. When more alarms match, the table shows how many of them are shown. 1 to 1000.
Device filter deviceFilterMode	Selection	all	All devices: every alarm the user may see. Device in the page tag prefix: only alarms of the device named by the page tag prefix (Internal.Demo shows the Demo device), so pages created from a template follow their own prefix; a page without a tag prefix shows no alarms and a note. Device list: only alarms of the devices in Device names. Names are compared without regard to case; while a device filter is on, alarms without a device are not shown. The page tag prefix must end at the device (Channel.Device, for example Internal.Demo). Options: all All devices, pagePrefix Device in the page tag prefix, list Device list
Device names deviceNames	Multi-line text	—	Used only with the Device list filter. One device name per line or separated by commas, as shown in the Device column. At most 20 names of up to 100 characters each; longer and repeated names are ignored. Without a name the table shows no alarms.
Rows per page pageSize	Number (0–1000)	25	0 shows one scrolling list without pages.

Columns

Setting	Type	Default	Description
Time column showTimeColumn	Checkbox	On	Shows when the alarm state last changed.
State column showStateColumn	Checkbox	On	Shows the alarm state as text and icon.
Task center column showTaskCenterColumn	Checkbox	Off	Shows the task center of the alarm device.
Acknowledged by column showAcknowledgedByColumn	Checkbox	On	Shows who acknowledged the alarm. Often empty after a reconnect; a dash is shown then.
Message column showDescriptionColumn	Checkbox	On	Shows the alarm message.
Data group column showDataGroupColumn	Checkbox	On	Shows the data group of the alarm.
Device column showDeviceColumn	Checkbox	On	Shows the device of the alarm.

Actions

Setting	Type	Default	Description
Acknowledge button per alarm showAckAction	Checkbox	Off	Adds an Acknowledge button to every unacknowledged alarm row. The button shows only on a live page, while the server is connected and when the user has an alarm acknowledge role; the server checks the permission again. An acknowledge counts as confirmed only when the server sends a state change for that alarm.
Confirmation wait (s) ackConfirmTimeoutSeconds	Number (3–60)	10	When no alarm state change comes from the server within this time, the row shows Not confirmed and can be tried again. 3 to 60 seconds.

Other settings

Setting	Type	Default	Description
Enable Flashing enableFlashing	Checkbox	Off	Makes the widget blink (an opacity pulse every second). Usually bound to an alarm condition.
Log Button logButton	Checkbox	Off	At runtime shows a chart icon when hovering the widget; clicking it adds the Tags bound to the widget to the log Tag list.

Bindings

In the Bindings (Rules) section of the properties panel, a Tag can be bound to the following properties of this widget with a Direct binding. The binding types (Direct, IntRange, FloatRange, Boolean, Bit) are the same for all widgets; they are described on the Widget Reference page.

title, visible, authorization, x, y, width, height, rotation, class, foregroundColor, backgroundColor, borderColor, borderStyle, borderWidth, borderRadius, borderTopLeftRadius, borderTopRightRadius, enableFlashing, logButton, alarmTableSchemaVersion, stateFilter, maxVisibleRows, pageSize, showTimeColumn, showDescriptionColumn, showStateColumn, showDataGroupColumn, showTaskCenterColumn, showDeviceColumn, showAcknowledgedByColumn, showAckAction, ackConfirmTimeoutSeconds, deviceFilterMode, deviceNames

Common sections

While this widget is selected, the properties panel also shows these common sections: General, Layout, Appearance, Bindings (Rules). These sections are described on the Page Editor page.