HP Long Horizontal Connector

• Display a horizontal connector line between two diagram elements.
• Show or hide an optional directional arrow based on HMI Device state.
• Show or hide an animated fluid flow stripe based on HMI Device state.
• Control the flow direction (forward or reverse) from live HMI Device data.
• Control the flow animation speed from live HMI Device data.
• Receive state data from HMI Device attributes, time series, alarm status, or dashboard state.

1. Open the dashboard and switch to edit mode.
2. Click Add widget at the top, or the Add new widget icon in the center of the screen.
3. Open the General high-performance SCADA symbols widget bundle.
4. Select HP Long horizontal connector.
5. Configure the widget settings, then click Add.

The widget connects to a single data source: either a Device or an Entity alias that resolves to a HMI Device. This HMI Device provides the attribute or telemetry values used to drive the widget’s visual state.

The SCADA symbol defines the visual shape of the widget. The HP Long horizontal connector widget has a pre-selected symbol from the General high-performance SCADA symbols bundle. To use a different symbol, click Browse SCADA symbol from gallery and choose one from the library, or upload your own.

Behavior parameters define what the widget displays, driven by real-time data from the connected HMI Device.

Parameter	Default	Description
Arrow presence	Present	Whether the directional arrow is displayed on the connector. See Presence and direction configuration.
Flow presence	Absent	Whether the animated fluid flow stripe is shown on the connector. See Presence and direction configuration.
Flow direction	Forward	Direction of the animated flow: Forward moves along the connector from start to end; Reverse moves in the opposite direction. See Presence and direction configuration.
Flow animation speed	1	Speed of the flow animation. 1 is normal speed; 0 disables animation; values above 1 slow the animation; values below 1 speed it up. See Flow animation speed configuration.

Applies to Arrow presence, Flow presence, and Flow direction. Click the edit icon next to a parameter to open its configuration dialog. When Action is set to Do nothing, select a fixed value:

Parameter	Value
Arrow presence	Present or Absent
Flow presence	Present or Absent
Flow direction	Forward or Reverse

For all other actions, the configuration dialog includes these options:

• Get attribute

  Read the parameter value from a HMI Device attribute.

  Parameter	Description
  Attribute scope	Where the attribute is stored: Any, Client, Server, or Shared.
  Attribute key	Attribute name to read, like flowPresent or flowDirection.
  Action result converter	None — parameter is activated when the attribute equals the value you specify; Function — parameter is activated when your f(data) returns true.
  ‘Present’/‘Forward’ when result is	The value or condition that activates the present or forward state.

• Get time series

  Read the parameter value from the latest telemetry reading.

  Parameter	Description
  Time series key	Telemetry key to monitor, like flowPresent.
  Action result converter	None — parameter is activated when the telemetry value equals what you specify; Function — parameter is activated when your f(data) returns true.
  ‘Present’/‘Forward’ when result is	The value or condition that activates the present or forward state.

• Get alarm status

  Activate the present or forward state when a specific alarm is active on the HMI Device.

  Parameter	Description
  Alarm severity	Which severity levels trigger the active state: Critical, Major, Minor, Warning, or Indeterminate.
  Alarm types	Any alarm, or a specific alarm type.

• Get dashboard state id

  Activate the present or forward state based on which dashboard state is currently open.

  Parameter	Description
  Action result converter	None — parameter is activated when the state name matches the text you enter; Function — parameter is activated when your f(data) returns true.
  ‘Present’/‘Forward’ when result is	The state name or condition that activates the present or forward state.

• Get dashboard state object

  Activate the present or forward state using the full dashboard state context; use this when you need to evaluate multiple state parameters at once.

  Parameter	Description
  Parse value function	A f(data) function that receives the current dashboard state object. Use data.id to read the active state name, or data.params to inspect state parameters.
  ‘Present’/‘Forward’ when result is	The expected type and value that activates the present or forward state. Choose String, Integer, Double, Boolean (then select True or False), or JSON.

Applies to Flow animation speed. Click the edit icon next to the parameter to open its configuration dialog. When Action is set to Do nothing, enter a fixed numeric speed value.

For all other actions, the configuration dialog works the same way:

• Get attribute

  Read the speed value from a HMI Device attribute.

  Parameter	Description
  Attribute scope	Where the attribute is stored: Any, Client, Server, or Shared.
  Attribute key	Attribute name to read, like flowSpeed.
  Action result converter	None — uses the attribute value directly; Function — returns the value from your f(data) function.

• Get time series

  Read the speed value from the latest telemetry reading.

  Parameter	Description
  Time series key	Telemetry key to monitor, like flowSpeed.
  Action result converter	None — uses the telemetry value directly; Function — returns the value from your f(data) function.

• Get alarm status

  Set the speed value based on alarm activity on the HMI Device.

  Parameter	Description
  Alarm severity	Which severity levels trigger the active state: Critical, Major, Minor, Warning, or Indeterminate.
  Alarm types	Any alarm, or a specific alarm type.

• Get dashboard state id

  Set the speed value based on which dashboard state is currently open.

  Parameter	Description
  Action result converter	None — uses the state name directly; Function — returns the value from your f(data) function.

• Get dashboard state object

  Set the speed value using the full dashboard state context; use this when you need to evaluate multiple state parameters at once.

  Parameter	Description
  Parse value function	A f(data) function that receives the current dashboard state object. Use data.id to read the active state name, or data.params to inspect state parameters.

The Appearance section controls the widget title, the connector line style, and the flow animation stripe style.

Setting	Default	Description
Title	HP Long horizontal connector	Widget title displayed in the header. Supports entityName and entityLabel variables.
Card icon	—	Icon shown in the widget header. Configure its size and color.
Line	6 px, black	Thickness and color of the main connector line.

Flow subsection — controls the appearance of the animated fluid flow stripe:

Setting	Default	Description
Line	4 px, light blue	Thickness and color of the flow animation stripe.
Line style	Dash 10 px, Gap 10 px	Dash and gap lengths of the flow stripe. For smooth looping, use values that divide evenly into 100.
Dash cap	Butt	End cap style for each dash segment: Butt (flat), Round (rounded ends), or Square (flat with half-width extension).

The Card appearance section controls the widget container style.

Setting	Default	Description
Background	Transparent	Card background color.
Show card buttons	Fullscreen	Buttons shown on the card when hovered.
Card border radius	0px	Rounding of card corners.
Card padding	12px	Inner spacing between the card edge and widget content.

Arrow does not appear on the connector

Cause	Solution
Arrow presence is Do nothing with value set to Absent	Open the Arrow presence edit dialog and set the value to Present, or configure it to read from a HMI Device attribute or time series key.
Device is not sending data	Confirm the HMI Device is online and publishing the expected attribute or telemetry key.

Flow animation does not run

Cause	Solution
Flow presence is Do nothing with value set to Absent	Open the Flow presence edit dialog and set the value to Present, or configure it to read from a HMI Device attribute or time series key.
Flow animation speed is 0	Open the Flow animation speed edit dialog and set a non-zero value.

Flow animation runs in the wrong direction

Cause	Solution
Flow direction is set to the opposite value	Open the Flow direction edit dialog and switch between Forward and Reverse, or configure it to read the direction from a HMI Device attribute or time series key.