i4designer Knowledgebase

Alarming

Abstract

Here are the i4designer Alarming components for your new project created on the i4SCADA platform.

The i4designer Alarming category contains the Alarm viewer component designed to facilitate alarms monitoring tasks at run-time. More details can be found in the upcoming article.

Alarm viewer
Abstract

Check out this article to learn more details about the i4designer Alarm viewer component and its properties.

The i4designer Alarm viewer component is an event notification and management extension that allows the user to view and act upon i4SCADA alarms, providing complex capabilities like alarm acknowledgement, processing, commenting, filtering and offline alarm viewing.

The Alarm viewer table provides a detailed alarm status representation, using color codes and textual hints. The active alarms can be filtered for both display and processing using the complex filtering criteria available in the contextual menu.

Alarm_viewer.jpg

The Alarm viewer component

Category

Property

Description

Common

Name

The name of the component, visible in other Designer locations (such as Page explorer).

Name_pipe.jpg

Object ID

Sets the Object ID of the component. By defining an object ID for the control, it can be passed as SignalPrefix when using parameter passing in navigation. The value of the Object ID can be used via a placeholder [OID] in other properties of this extension. The placeholder is supported in all signal properties, symbolic text and states.

Example: Setpoint [OID]

Object_ID.jpg

Tooltip text

Optional tooltip text, that will be shown on mouseover at runtime.

Tooltip_text.jpg

Security

System authorization

The system authorization required to display the component. If the logged in user does not have this system authorization, the component will not be visible. If the property is left empty, the component will be visible to all users.

System_authorization.jpg

Project authorization

The project authorization required for displaying the component. If the logged in user does not have this project authorization, the component will not be visible. If the property is left empty, the component will be visible to all users.

Project_authorization.jpg

Security access behavior

Sets the behavior of the element when the logged in user doesn't belong to the project authorization indicated by the projectAuthorization property. In this case, the element can be either disabled or hidden.

Security_access_behavior.jpg

Layout

Layout mode

Sets the behaviour of the component related to the page placement. The user can select the component layout from the options available in the drop-down list: Default, Dock top, Dock bottom, Dock left, Dock right, Stretched, Pin top left, Pin top center, Pin top right, Pin right middle, Pin bottom right, Pin bottom center, Pin bottom left, Pin left middle and Pin center.

Layout_mode.jpg

Margin

Sets the margin of the component relative to the drawing board area. The supported values are the standard CSS values for the margin.

The top, bottom, left and right values can either be typed in the main property field or by using the Margin editor.

Margin_small.jpg

The Margin editor can be opened by clicking the Open button.

Margin_large.jpg

The components margins can be updated by setting the margin value and selecting the desired unit:

  • Ems (em) - The em is a scalable unit. One em is equal to the current font-size;

  • Pixels (px) - Pixels are are fixed-size units. One pixel is equal to one dot on the computer screen (the smallest division of a screen’s resolution).

  • Percent (%) - The percent unit is much like the “em” unit. When using the Percent unit the component remains fully scalable for mobile devices and accessibility.

Effects

Opacity

Sets the opacity of the component. The Opacity values should be numbers from 0 to 1 representing the opacity of the component. When the component has a value of 0 the element is completely invisible; a value of 1 is completely opaque (solid).

By default, the Component's opacity is set to value 1. Using the up / down arrows the user can control the opacity degree.

Opacity.jpg

By clicking the Open button the view is extended to display the Opacity slider.

Opacity_slider.jpg

Shadow color

Sets the opacity of the component. The Opacity values should be numbers from 0 to 1 representing the opacity of the component. When the component has a value of 0 the element is completely invisible; a value of 1 is completely opaque (solid).

Shadow_color.jpg

Shadow offset X

Sets the offset of the shadow on the horizontal axis. The default value can be increased or decreased, either by manually typing in the desired value, or by using the up and down arrows.

Shadow_offset_X.jpg

Shadow offset Y

Sets the offset of the shadow on the vertical axis. The default value can be increased or decreased, either by manually typing in the desired value, or by using the up and down arrows.

Shadow_offset_Y.jpg

Shadow size

Sets the width of the component shadow. The default value can be increased or decreased, either by manually typing in the desired value, or by using the up and down arrows.

Shadow_size.jpg

Miscellaneous

Group name

Sets the name of the Alarms Group.

Group_name.jpg

Configuration

Title text

Sets the text displayed by the component header.

Title_text.jpg

DateTime format

Selects the time and date format for the DateTime Signal values. Available tokens are - YYYY, YY, Y, Q, MM, MMM, MMMM, D, DD. Further information are available in the "Year, month, and day tokens" chapter under https://momentjs.com/docs/.

For example: DD.MM.YYYY hh:mm:ss

DateTime_format.jpg

Alarms

Alarm groups

The Alarm Group that will be used as initial alarm filter. This filter will be applied automatically when running the component in the web browser.

The Alarm groups filters are featured as an array list, accessible by clicking the Expand array list button.

Alarm_groups.jpg

Further more, the following actions are available for each array item:

  • Move up move_up.jpg

  • Move down move_down.jpg

  • Clone clone_state.jpg

  • Remove remove_state.jpg

In order to add a new Array item, to the list of Alarm Group filters, the user can click the Add button Add_button.jpg.

Each array item allows the user with possibility to manually fill in the Alarm group name.

alarm_group_name.jpg

Alarm status filter

Sets the alarm status that will be used as initial alarm filter. This filter will be applied automatically when running the extension in the web browser. The user can select the desired Alarm status filter from the drop-down list options.

Alarm_status_filter.jpg

Alarm types

The Alarm types filter that will be used as initial alarm filter. This filter will be applied automatically when running the component in the web browser.

The Alarm types filters are featured as an array list, accessible by clicking the Expand array list button.

Alarm_types.jpg

Further more, the following actions are available for each array item:

  • Move up move_up.jpg

  • Move down move_down.jpg

  • Clone clone_state.jpg

  • Remove remove_state.jpg

In order to add a new Array item, to the list of Alarm Group filters, the user can click the Add button Add_button.jpg.

Each array item allows the user with possibility to manually fill in the Alarm type name.

type_name.jpg

Column filter

Sets the columns that will be used as initial alarm filters. The user can select the desired column filter selecting from the drop-down list options.

Column_filter.jpg

Column filter pattern

Defines the pattern for filtering the specified column. The asterisk could be used as placeholder.

Column_filter_pattern.jpg

Columns

Sets the columns displayed by the alarm viewer table. By default, the following columns are defined: Priority, Status Text, Group, Type and Text.

The table columns are featured as an array list, accessible by clicking the Expand array list button.

Columns.jpg

Further more, the following actions are available for each array item:

  • Move up move_up.jpg

  • Move down move_down.jpg

  • Clone clone_state.jpg

  • Remove remove_state.jpg

In order to add a new Array item, to the list of Alarm Group filters, the user can click the button Add Add_button.jpg

Each array item allows the user with possibility to manually fill in the column name.

column_name.jpg

End offset

Selects the type of the end offset interval, allowing the user to chose between the drop-down list options: seconds, minutes, days, weeks, months and years.

End_offset.jpg

End offset interval

Sets the numeric value for the end offset property, by manually filling in the desired value or by using the up / down arrows to increase or decrease the value.

End_offset_interval.jpg

Online mode

Sets the alarm viewer component to display the online alarms, by setting the property to True.

Online_mode.jpg

Rolling time window

Boolean value that shows if the time window is rolling and it is not fixed, if the property is set to True.

Rollting_time_window.jpg

Max alarm count

Sets the maximum number of alarms to be retrieved.

Max_alarm_count.jpg

Maximum priority

Sets the maximum priority of the alarms to be displayed. This property acts like a priority filter.

Max_prio.jpg

Minimum priority

Sets the minimum priority of the alarms to be displayed. This property acts like a priority filter.

Minimum_priority.jpg

Start offset

Selects the type of the start offset interval, allowing the user to chose between the drop-down list options: seconds, minutes, days, weeks, months and years.

Start_offset.jpg

Start offset interval

Sets the numeric value for the start offset property, by manually filling in the desired value or by using the up / down arrows to increase or decrease the value.

Start_offset_interval.jpg

Update rate

Sets the update rate in mliseconds. This property will be taken into consideration only if the Online Mode is enabled.

Update_rate.jpg

Alarm sort order

Sets the order in which the alarms are displayed, selecting from the drop-down list options.

Alarms_sort_order.jpg

Palette

Acknowledged alarm background

Sets the background color of the alarms after they were acknowledged. The user can either manually type in the HEX color code or use the color picker tool. Applying this property will overwrite the default css class.

Ack_background.jpg

Acknowledged alarm foreground

Sets the foreground color of the alarms after they were acknowledged. The user can either manually type in the HEX color code or use the color picker tool. Applying this property will overwrite the default css class.

Ack_foreground.jpg

Acknowledged and gone alarm background

Sets the background color of the alarms after they were acknowledged and gone. The user can either manually type in the HEX color code or use the color picker tool. Applying this property will overwrite the default css class.

Ack_and_gone_background.jpg

Acknowledged and gone alarm foreground

Sets the foreground color of the alarms after they were acknowledged and gone. The user can either manually type in the HEX color code or use the color picker tool. Applying this property will overwrite the default css class.

Ack_and_gone_foreground.jpg

Active alarm background

Sets the background color of the alarms after they were active. The user can either manually type in the HEX color code or use the color picker tool. Applying this property will overwrite the default css class.

Active_alarm_background.jpg

Active alarm foreground

Sets the foreground color of the alarms after they were active. The user can either manually type in the HEX color code or use the color picker tool. Applying this property will overwrite the default css class.

Active_alarm_foreground.jpg

Inactive alarm background

Sets the background color of the alarms after they were inactive. The user can either manually type in the HEX color code or use the color picker tool. Applying this property will overwrite the default css class.

Inactive_alarm_background.jpg

Inactive alarm foreground

Sets the foreground color of the alarms after they were inactive. The user can either manually type in the HEX color code or use the color picker tool. Applying this property will overwrite the default css class.

Inactive_alarm_foreground.jpg

Appearance

Page size

Sets the number of visible alarms on a single page, by manually filling in the desired value or by using the up / down arrows to increase or decrease the value.

Page_size.jpg

Show footer

Enables possibility to switch between showing and hiding the Alarm table footer. If property is set to True, the footer will be visible.

Show_footer.jpg

Show header

Enables possibility to switch between showing and hiding the Alarm table header. If property is set to True, the header will be visible.

Show_header.jpg

Show index column

Enables display of the index column, as the first table column, if the property is set to true.

Show_index_column.jpg

Transform

Width

Sets the width of the component using the up and down arrows to increase and decrease, or by manually typing the desired pixels value.

The component width can also be adjusted directly on the design surface by means of mouse manipulation.

Control_width.jpg

Height

Sets the height of the component using the up and down arrows to increase and decrease, or by manually typing the desired pixels value.

The component height can also be adjusted directly on the design surface by means of mouse manipulation.

Control_height.jpg

Angle

Sets the rotation angle using the up and down arrows to increase and decrease, or by manually typing the desired degree value.

The component angle can also be adjusted directly on the design surface by means of mouse manipulation.

Angle.jpg

Left

Specifies the X (horizontal) coordinate of the component, on the grid, using the up and down arrows to increase and decrease, or by manually typing the desired value.

The component X coordinate can also be adjusted directly on the design surface by means of mouse manipulation.

Left.jpg

Top

Specifies the Y (vertical) coordinate of the component, on the grid, using the up and down arrows to increase and decrease, or by manually typing the desired value.

The component Y coordinate can also be adjusted directly on the design surface by means of mouse manipulation.

Top.jpg