Skip to main content

i4designer Knowledge Base

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 alarm monitoring tasks at run-time. More details can be found in the upcoming articles.

Tip

For a set of step-based tutorials describing the usage of the Alarming components, please visit the dedicated tutorials, here.

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 acknowledgment, 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.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.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 or enabled (depending on the set Security access behavior). If the property is left empty, the component will be visible and enabled for all users. Further on, the user can also add multiple System authorizations / Permissions, separated by comma (,).

system_authorizations.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 or enabled (depending on the set Security access behavior). If the property is left empty, the component will be visible and enabled to all users. Further on, the user can also add multiple Project authorizations / Roles, separated by comma (,).

project_authorization.jpg

Security access behavior

Sets the behavior of the element to either disabled (grayed out) or hidden, when the logged in user doesn't meet the conditions imposed by the Project authorization / Roles and System authorization / Permissions properties. In case both Project authorization / Roles and System authorization / Permissions properties are set, the logged user needs to meet both conditions to be able to see and utilize the component, at run-time.

security_access_behavior.jpg

Layout

Layout mode

Sets the behavior 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_1.jpg

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

margin_2.jpg

The component's 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 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_1.jpg

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

opacity_2.jpg

Shadow color

Sets the color of the component shadow, either by manually typing in the HEX color code or by using the color picker tool. As the component colors are injected by the default CSS, changing the color will overwrite the CSS.

start_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

Configuration

Configuration namespace

The namespace used by the chart predefined configuration should be applied at run time. By setting this property, the respective configuration will be, by default, applied.

configuration_namespace.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 is available in the "Year, month, and day tokens" chapter under https://momentjs.com/docs/#/parsing/string-format/.

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

datetime_format.jpg

Group name

Sets the name of the Alarms Group.

group_name.jpg

Initial configuration

Sets the name of the existing configuration, that will be initially loaded for the component when opening the run-time project visualization.

initial_configuration.jpg

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

Title text

Sets the text displayed by the component header.

title_text.jpg

Alarms

Acknowledged alarm sound

Sets the path of the sound to be played for acknowledged alarms. The sound can either be uploaded inside i4designer, or it can be an external link to a sound file. The sound upload accepts only files of type .mp3 and .wav, up to 1 MB in size.

The property takes effect only if Play Sound is set to True.

acknowledged_alarm_sound.jpg

Acknowledged and gone alarm sound

Sets the path of the sound to be played for acknowledged and gone alarms. The sound can either be uploaded inside i4designer, or it can be an external link to a sound file. The sound upload accepts only files of type .mp3 and .wav, up to 1 MB in size.

The property takes effect only if Play Sound is set to True.

acknowledged_and_gone_alarm_sound.jpg

Active alarm sound

Sets the path of the sound to be played for active alarms. The sound can either be uploaded inside i4designer, or it can be an external link to a sound file. The sound upload accepts only files of type .mp3 and .wav, up to 1 MB in size.

The property takes effect only if Play Sound is set to True.

active_alarm_sound.jpg

Alarm Types

The Alarm types filter that will be used as the 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

Furthermore, 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.

array_item.jpg

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

Alarm groups

The Alarm Group will be used as the 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_1.jpg

Furthermore, 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 the possibility to manually fill in the Alarm group name.

alarm_groups.jpg

Alarm status filter

Sets the alarm status that will be used as the 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: All, Gone, Active, NotAcknowledged, ActiveOrNotAcknowledged.

alarm_status_filter.jpg

Alarm sort order

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

alarms_sort_order.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: None, Text, SignalName, OpcItem, Name, HttpLink, HelpCause, HelpEffect, HelpRepair, GeneralCom, OccurrenceComment, AcknowledgeComment, NavigationSource, NavigationTarget, ExtendedProperty#.

column_filter.jpg

Column filter pattern

Defines the pattern for filtering the specified column. This field also supports the "*" wildcard, as a placeholder, when defining filter patterns.

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

Furthermore, 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 the possibility to select the name of the column.

column_name.jpg

Furthermore, the user can set the width of the column by manually filling in the desired value

column_width.jpg

Gone alarm sound

Sets the path of the sound to be played for gone alarms. The sound can either be uploaded inside i4designer, or it can be an external link to a sound file. The sound upload accepts only files of type .mp3 and .wav, up to 1 MB in size.

The property takes effect only if Play Sound is set to True.

gone_alarm_sound.jpg

Loop

Sets whether to loop the alarm sound for incoming alarms. Only has an effect if the Play Sound property is set to True.

loop.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 as a priority filter.

max_priority.jpg

Minimum priority

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

min_priority.jpg

Online mode

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

online_mode.jpg

Play sound

Enables or disables sounds for incoming Alarms. If this property is set to True, incoming Alarms will also play a sound.

play_sound.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.

rolling_time_window.jpg

Update rate

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

update_rate.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.

acknowledged_alarm_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.

acknowledged_alarm_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.

acknowledged_and_gone_alarm_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.

acknowledged_and_gone_alarm_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

Alarm colors

This feature allows the user to add advanced filtering for different combinations of Alarm groups, priority, status, and type, using custom colors. The user can set a specific color for all the alarms belonging to a particular Alarm group, Alarm type, and Alarm priority, when these are in a particular status.

The specific criteria can be accessed by clicking the Expand array list button. The list features the possibility to manage the:

  • Active alarm

  • Inactive (gone) alarm

  • Acknowledged alarm

  • Acknowledged and gone alarm

alarm_colors.jpg

The component can have multiple Alarm colors, each carrying its own set of properties. The user can add Alarm colors, by clicking the Add new item button.

Furthermore, the following actions are available for each property:

  • Move upMove_up.jpg

  • Move downMove_down.jpg

  • Clone itemClone.jpg

  • Remove itemRemove.jpg

The user can individually manage the listed buttons, by setting the desired values, for the available properties: Display name, Alarm group, Alarm priority, Alarm status, Alarm type, Background color, and Foreground color.

The logic behind this function also considers the order of the Alarm color filters at design time. For example, two objects that refer to different priorities, but belong to the same group, status, and type, will be shown in a different order at run-time, based on the order they have at design-time. As in the below example, the expectation is that purple Alarms are shown first and the blue Alarms come second.

alarm_color.jpg

Border color

Sets the border color of the component. 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.

border_color.jpg

Buttons foreground

Sets the foreground color of the component's buttons. 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.

buttons_foreground.jpg

Buttons background

Sets the background color of the component's buttons. 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.

buttons_background.jpg

Header background

Sets the background color of the component's header. 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.

header_background.jpg

Header foreground

Sets the foreground color of the component's header. 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.

header_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

Time Range

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

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.

end_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

Appearance

Show buttons icons

Toggles the visibility of the button icons.

show_buttons_icons.jpg

Show buttons label

Toggles the visibility of the text of the button.

show_buttons_label.jpg

Show footer

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

show_footer.jpg

Show header

Enables the possibility to switch between showing and hiding the Alarm table header. If the 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

Typography

Header font family

Sets the font family of the component header, selecting from web-safe fonts available in the drop-down list.

header_font_family.jpg

Header font size

Sets the size of the component's header font, using the up and down arrows to increase and decrease, or by manually typing the desired value.

header_font_size.jpg

Header font-weight

Sets the weight of the component's header font, selecting from the drop-down list options: 900 (fat), 800 (extra-bold), 700 (bold), 600 (semi-bold), 500 (medium), 400 (normal), 300 (light), 200 (extra-light) and 100 (thin).

header_font_weight.jpg

Style

Border width

Sets the width of the component's container. The value is specified in pixels.

border_width_1.jpg

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

The Border width editor can be opened by clicking the Open button.

border_width.jpg

The components border width can be updated by setting the desired value and selecting the unit:

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

  • Pixels (px) - Pixels 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.

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.

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.

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

Disable flip

Disables any flip transformation for this component. This keeps the component in the default position even when its container is flipped.

disable_flip.jpg

Horizontal flip

Flips the selected component horizontally.

horizontal_flip.jpg

Vertical flip

Flips the selected component vertically.

vertical_flip.jpg
Alarm State Manager
Abstract

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

The i4designer Alarm State Manager is a component that allows the users the possibility to change the processing state of alarms. Having an integrated security feature only the logged-in users having the appropriate set of permissions will be allowed to actually interact with the Alarm States.

The Alarm State Manager extension provides a straightforward filtering system, at run-time.

alarm_state_manager.jpg

The Alarm State Manager component

Category

Property

Description

Common

Name

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

Name.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.jpg

Security

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 or enabled (depending on the set Security access behavior). If the property is left empty, the component will be visible and enabled to all users. Further on, the user can also add multiple Project authorizations / Roles, separated by comma (,).

project_authorization.jpg

Security access behavior

Sets the behavior of the element to either disabled (grayed out) or hidden, when the logged in user doesn't meet the conditions imposed by the Project authorization / Roles and System authorization / Permissions properties. In case both Project authorization / Roles and System authorization / Permissions properties are set, the logged user needs to meet both conditions to be able to see and utilize the component, at run-time.

security_access_behavior.jpg

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 or enabled (depending on the set Security access behavior). If the property is left empty, the component will be visible and enabled for all users. Further on, the user can also add multiple System authorizations / Permissions, separated by comma (,).

system_authorizations.jpg

Layout

Layout mode

Sets the behavior 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_1.jpg

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

margin_2.jpg

The component's 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 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_1.jpg

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

opacity_2.jpg

Shadow color

Sets the color of the component shadow, either by manually typing in the HEX color code or by using the color picker tool. As the component colors are injected by the default CSS, changing the color will overwrite the CSS.

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

Configuration

Title text

Sets the text displayed by the component header.

title_text.jpg

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

Alarms

Alarm tag

Sets a predefined tag used for filtering the alarms. The Alarm tag can be changed at run-time.

alarm_tag.jpg

Columns

Sets the columns displayed by the alarm state manager table. By default, the following columns are set: AlarmTag, SignalName, Text, Process, Display, and Action.

To view and manage the table columns, the user can click on the Expand array list button.

columns.jpg

Furthermore, the following actions are available for each state:

  • Move up move_up.jpg

  • Move down move_down.jpg

  • Remove state remove_state.jpg

Appearance

Header visibility

Enables or disables the visibility of the component's header.

header_visibility.jpg

Palette

Background color

Sets the background color of the component. 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.

background_color.jpg

Border color

Sets the border color of the component. 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.

border_color.jpg

Buttons background

Sets the background color of the component's buttons. 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.

buttons_background.jpg

Buttons foreground

Sets the foreground color of the component's buttons. 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.

buttons_foreground.jpg

Foreground color

Sets the foreground color of the component. 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.

foreground_color.jpg

Header background

Sets the background color of the component's header. 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.

header_background.jpg

Header foreground

Sets the foreground color of the component's header. 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.

header_foreground.jpg

Transform

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

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.

height.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

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.

width.jpg

Disable flip

Disables any flip transformation for this component. This keeps the component in the default position even when its container is flipped.

disable_flip.jpg

Horizontal flip

Flips the selected component horizontally.

horizontal_flip.jpg

Vertical flip

Flips the selected component vertically.

vertical_flip.jpg
Logbook
Abstract

Check out this article and learn more details about the Logbook component and how to configure its design-time components.

The Logbook component is a real-time multi-user communication environment for i4designer web applications. It allows chat-like communications in real-time while logging all the messages for later reading.

logbook.jpg

The Logbook component

Category

Property

Description

Common

Name

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

Name.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.jpg

Security

Project authorization

Project authorization is required for displaying the component. If the logged-in user does not have this project authorization, the component will not be visible or enabled (depending on the set Security access behavior). If the property is left empty, the component will be visible and enabled to all users. Further on, the user can also add multiple Project authorizations / Roles, separated by comma (,).

project_authorization.jpg

Security access behavior

Sets the behavior of the element to either be disabled (grayed out) or hidden, when the logged-in user doesn't meet the conditions imposed by the Project authorization / Roles and System authorization / Permissions properties. In case both Project authorization / Roles and System authorization / Permissions properties are set, the logged user needs to meet both conditions to be able to see and utilize the component, at run-time.

security_access_behavior.jpg

System authorization

System authorization is required to display the component. If the logged-in user does not have this system authorization, the component will not be visible or enabled (depending on the set Security access behavior). If the property is left empty, the component will be visible and enabled for all users. Further on, the user can also add multiple System authorizations / Permissions, separated by comma (,).

system_authorizations.jpg

Layout

Layout mode

Sets the behavior 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_1.jpg

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

margin_2.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 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_1.jpg

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

opacity_2.jpg

Shadow color

Sets the color of the component shadow, either by manually typing in the HEX color code or by using the color picker tool. As the component colors are injected by the default CSS, changing the color will overwrite the CSS.

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

Configuration

Client side configuration

Specifies whether the configurations are saved locally.

By default, the property is set to false, hence, all configurations are safely stored on the target server, and can be loaded to the component, regardless of the used browser.

If the property is set to true, all configurations are saved on the browser's local storage. When loading configurations saved locally, the system will initially load the configuration that is saved in the local storage, if one exists. If it doesn't exist it will fall back to the Initial configuration field. Further on, configurations saved locally can be lost, if the browser application is uninstalled, or if the user decides to change browser settings and return to factory defaults.

client_side_configuration.jpg

Configuration namespace

The namespace used by the chart predefined configuration should be applied at run time. By setting this property, the respective configuration will be, by default, applied.

configuration_namespace.jpg

Initial configuration

Sets the name of the existing configuration, that will be initially loaded for the component when opening the run-time project visualization.

initial_configuration.jpg

Time range

Contains a set of time range configurations. By clicking the Expand array list button, a list of modular time range properties is exposed. Based on the selection made for the Date range property, the view is updated accordingly, as follows:

  • Date range Offset - allows the user to pick the current filter, on a specified date, using the design-time properties Start offset and End offset, by choosing the type (seconds, minutes, hours, days). The time frame is by default calculated and set.

    • Start offset interval - Allows the user to specify the start length offset measured in seconds, minutes, days, weeks, months, or years.

    • Start offset - Allows the user to set the start offset interval.

    • End offset interval - Allows the user to set the end offset interval.

    • End offset - Allows the user to specify the end length offset measured in seconds, minutes, days, weeks, months, or years.

    time_range_1.jpg
  • Date range Specific - allows the user to pick the desired time interval, using the Start date / End date calendar selectors.

    • Start date - sets the start date of the component measurement.

    • End date - sets the end date of the component measurement.

    time_range_2.jpg
  • Date range Day - allows the user to select the desired Day as time range, from the calendar view.

    • Date - sets the date range, to a specific day.

    time_range_3.jpg
  • Date range Week - allows the user to select the desired Week as time range, from the calendar view.

    • Date - sets the date range, to a specific week.

    time_range_4.jpg
  • Date range Month - allows the user to select the desired Month as time range, from the calendar view.

    • Date - sets the date range, to a specific month.

    time_range_date.jpg
  • Date range Year - allows the user to select the desired Year as time range, from the calendar view.

    • Date - sets the date range, to a specific year.

    time_range_year.jpg
  • Date range:

    • Current day - allows the user to select the current day, as time range. The time frame of 24 hours is by default calculated and set.

      time_range_current_day.jpg
    • Current week - allows the user to select the current week, as a time range. The time frame of 7 days is by default calculated and set.

      time_range_current_week.jpg
    • Current month - allows the user to select the current month, as a time range. The time frame is by default calculated and set.

      time_range_current_month.jpg
    • Current year - allows the user to select the current year, as a time range. The time frame is by default calculated and set.

      time_range_current_year.jpg
  • Date range Last day / Last week / Last month / Last year

    • Last day - allows the user to select the day before the current one. The time frame of 24 hours is by default calculated and set.

      time_range_last_day.jpg
    • Last week - allows the user to select the week before the current one. The time frame of 7 days is by default calculated and set.

      time_range_last_week.jpg
    • Last month - allows the user to select the month before the current one. The time frame is by default calculated and set.

      time_range_last_month.jpg
    • Last year - allows the user to select the year before the current one, as time range. The time frame is by default calculated and set.

      time_range_last_year.jpg

Title text

Sets the text displayed by the component header.

title_text.jpg

Update rate

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

update_rate.jpg

Miscellaneous

Default subject

Defines the default subject used when creating new logbooks.

default_subject.jpg

Default topic

Defines the default topic selected when creating new logbooks.

default_topic.jpg

Logbook foreground

Defines the default text color applied for new logbooks.

logbook_foreground.jpg

Max entries

Defines the default maximum number of logbooks selection.

max_entries.jpg

Selected topic

Defines the default selected topic when filtering logbooks.

selected_topic.jpg

Topic background

Defines the default background color of the logbook's topic.

topic_background.jpg

Topic font size

Defines the default font size of the logbook's topic.

topic_font_size.jpg

Palette

Buttons background

Sets the background color of the component's buttons. 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.

buttons_background.jpg

Buttons foreground

Sets the foreground color of the component's buttons. 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.

buttons_foreground.jpg

Header background

Sets the background color of the component's header. 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.

header_background.jpg

Header foreground

Sets the foreground color of the component's header. 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.

header_foreground.jpg

Typography

Header font family

Sets the font family of the component header, selecting from web-safe fonts available in the drop-down list.

header_font_family.jpg

Header font size

Sets the size of the component's header font, using the up and down arrows to increase and decrease, or by manually typing the desired value.

header_font_size.jpg

Header font weight

Sets the weight of the component's header font, selecting from the drop-down list options: normal, 900 (fat), 800 (extra-bold), 700 (bold), 600 (semi-bold), 500 (medium), 400 (regular), 300 (light), 200 (extra-light) and 100 (thin).

header_font_weight.jpg

Transform

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

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.

height.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

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.

width.jpg

Disable flip

Disables any flip transformation for this component. This keeps the component in the default position even when its container is flipped.

disable_flip.jpg

Horizontal flip

Flips the selected component horizontally.

horizontal_flip.jpg

Vertical flip

Flips the selected component vertically.

vertical_flip.jpg