Alarm Journal
The append-only history of every alarm lifecycle event — raised, acknowledged, returned to normal, shelved, suppressed, restored — searchable and filterable, and fast over months of data.
Reach for it when you need:
- Shift handover: what happened, and what is still outstanding
- Incident investigation: the exact order of events and who acknowledged what
Component name: AlarmJournal · Category: Alarm
In the palette: Append-only alarm history — searchable and paged, fast over months of data
Properties
Any property can be bound to a tag, another component's property, or a query.
| Property | Type | Default | Description |
|---|---|---|---|
pagination | object | {"rowsPerPage":100,"rowsPerPageOptions":"50, 100, 250, 500",… (truncated) | — |
↳ pagination.rowsPerPage | number | 100 | — |
↳ pagination.rowsPerPageOptions | string | 50, 100, 250, 500 | Comma-separated page-size choices. |
↳ pagination.virtualize | boolean | true | — |
zebra | object | {"enabled":true} | Zebra-stripe alternate rows. |
↳ zebra.enabled | boolean | true | — |
columns | object | {"event":true,"tag":true,"priority":true,"value":false,"desc… (truncated) | Show / hide columns. |
↳ columns.event | boolean | true | — |
↳ columns.tag | boolean | true | — |
↳ columns.priority | boolean | true | — |
↳ columns.value | boolean | false | — |
↳ columns.description | boolean | false | — |
↳ columns.by | boolean | true | — |
table | object | {"reorder":true,"resize":true,"sort":true} | Column interactions: reorder, resize, and sort (click a header to sort the page). |
↳ table.reorder | boolean | true | — |
↳ table.resize | boolean | true | — |
↳ table.sort | boolean | true | — |
filters | object | {"enabled":true,"search":"","priority":"","event":""} | enabled = show the search/filter bar. The values (bindable) override the controls; blank = user-controlled. |
↳ filters.enabled | boolean | true | — |
↳ filters.search | string | "" | — |
↳ filters.priority | enum | "" | Options: `` · critical · high · medium · low. |
↳ filters.event | enum | "" | Options: `` · raised · ack · rtn · clear · shelve · suppress · oos · restore. |
priorityColors | object | {"critical":"#d32f2f","high":"#f57c00","medium":"#fbc02d","l… (truncated) | Per-priority colours (ISA-18.2 default: red/orange/yellow/blue). Shared live across all alarm widgets — change once, applies everywhere. |
↳ priorityColors.critical | color | #d32f2f | — |
↳ priorityColors.high | color | #f57c00 | — |
↳ priorityColors.medium | color | #fbc02d | — |
↳ priorityColors.low | color | #1976d2 | — |
dateFormat | string | dd MMM yyyy HH:mm:ss | date-fns pattern, e.g. dd MMM yyyy HH:mm:ss, dd/MM/yy HH:mm, yyyy-MM-dd. |
style | style | {} | Custom CSS properties |
Events
Attach event actions to these in the Event Manager.
| Event | Label | Group | Payload |
|---|---|---|---|
click | Click | Mouse | The DOM event. |
dblclick | Double click | Mouse | The DOM event. |
contextmenu | Right click | Mouse | The DOM event. |
mouseenter | Mouse enter | Mouse | The DOM event. |
mouseleave | Mouse leave | Mouse | The DOM event. |
contextmenu fires your configured actions at runtime only — in LiveView and in preview. On the Designer canvas the right-click is captured to open the Event Manager, so testing it there will not run your actions. Test right-click in preview.
Notes
The journal is the alarm record, not the security audit journal. Use the audit journal for "who changed the setpoint"; use this one for "when did it trip".
A toolbar that fits narrow spaces Changed in 1.0.8
When the widget is narrow — in a small grid cell, a sidebar or on a phone — its toolbar shrinks to fit rather than spilling over. It goes by the widget's own width, not the screen's, so a small widget on a large monitor shrinks too. First the filter selects narrow. Then they fold into one Filters menu, with a badge counting the filters in force, and the pager drops its labels. Nothing is taken away: every control is still there, and a shortened control keeps its full name for screen readers.