Configuring the Substation Alarm Overview
The Substation Alarm Overview is a Flex Operations tool that presents SCADA alarm and measurement data for a selected substation as a generated graphical layout.
Use the standard Flex configuration override mechanism described in NMS Flex Operations Configuration. The overview map render configuration should be placed in client/tools/overviewConfig.jsonc. Use the corresponding product configuration files as the reference when creating customer-specific overrides.
Overview Layout Templates
The overview layout is generated from reusable templates. A template can define a map feature, a container, a device or measurement match, a row or column arrangement, a table, or an instance of another named template.
The layout generator evaluates the configured root layouts against the selected substation. Each root can include a match condition so that different layouts are used for different substations or substation classes. The matching roots are copied and evaluated recursively. Device and measurement entries use their match definitions to select the applicable data, and row, column, and table entries arrange the generated content. The generated features are then positioned on the overview map.
Named templates allow common display components to be reused. Template instances can provide arguments, such as labels, values, colors, and display options. Expressions can use the current substation, matched device, matched measurement, template arguments, overview data, map configuration, and configured values.
When a device or measurement does not match, the matchNotFoundVisibility option controls the result:
• none: Do not generate the unmatched item.
• show: Generate the item so its template can handle the missing device or measurement.
• invisible: Do not display the item, but preserve its layout space.
Overview Configuration Options
The following top-level options in SubstationAlarmOverviewConfig control default overview behavior:
• generalAlarmsGroup: Identifies the alarm group treated as general alarms. Set this option to null to disable the separate general-alarm behavior and related display choices.
• defaultSettings: Defines default overview preferences, including whether general alarms are initially shown in the overview or banner and the default map settings.
• yAxisDirection: Controls whether template Y coordinates increase upward or downward. The default is down. Changing this option changes the interpretation of stored layout positions.
• defaultBorderFont and borderLabelInset: Define the default font and spacing for template borders with labels.
• defaultMatchNotFoundVisibility: Defines the default behavior when a configured device or measurement match is not found.
• isTripMeasure and isLimitBreachedMeasure: Define expressions used to derive device trip and limit-breach state from measurement data. These derived states can be referenced by templates and styles.
The base product layout includes reusable templates and an automatic root layout. Customer configurations can override these definitions to add, remove, reorder, or restyle generated overview content. Test all template changes with representative substations and measurements before deploying them.