OAS DoublePopupBinding

With this binding you are able to add a Popup Dialog on PX Widgets which enables you to override the two given component like Numeric-, Boolean- or EnumWritable (StringWritable Components are not supported!) in every combination. Its main purpose is to provide a simple and easy way to override the two given component with some extra information.

Below you find some examples of the three different popups.

Notice that the top part is the same for all three of the popups. This makes it easy to see whats going on. The out line shows the current value of the bound data

NOTE: When binding a BNumericWritable you can define a facet called step of type BDouble This facet controls the step attribute of the slider input.

Slots

Name	Type	Default
ord	Ord	`null`
degradeBehavior	DegradeBehavior	`None`
feedback	Ord	`null`
title	Format	`%name%`
popupMode	OasPopupMode	`override`
ord2	Ord	`null`
feedback2	Ord	`null`
title2	Format	`%name%`
popupMode2	OasPopupMode	`override`
modal	boolean	`true`
headTitle	String	`operation`

ord / ord2

ORD (Object Resolution Descriptor) of the Component that is used to determine the type of the popup (Numeric, Boolean or Enum) and will be overridden. The Popup will use %out.value% to show the datapoint’s value on the popup “out”-field. Also the facets of the component will be analyzed to configure the preselection of the popup.

The top part of the popup takes the ord property and the bottom part takes the ord2 property.

NumericWritable: Uses Unit, Min and Max Facet.
BooleanWritable: Uses trueText and FalseText Facet
NumericWritable: Uses range Facet.

degradeBehavior

This property is inherited by the BBinding Class of Niagara and won’t be used currently.

feedback / feedback2

The Feedback ord defines a component that is used display either real feedback of an real aggregate coming over a hardware input or a virtual feedback coming from an IO Driver or else.

The top part of the popup takes the feedback property and the bottom part takes the feedback2 property.

title / title2

Utilizing Niagara’s BFormat to customize the popups sub title either by giving a concrete text or using information of the bound component itself.

The top part of the popup takes the title property applies it to the ord property and the bottom part takes the title2 property applies it to the ord2 property.

popupMode / popupMode2

Work in Progress: Will change the behavior of the top and bottom part in the Popup. Currently only the Override mode is fully supported. This mode will only shown the Override- and Auto-Action.

This is turned on as default and will prevent the user form reaching other elements in the background. Turned off the background isn’t blocked and other element can be reached.

headTitle

Defines the text shown in the header of the popup. This property is just an plain text and does not utilize the BFormat and one of the ord properties. The default is operation to provide a generic title.

Common / Intended use

The OAS PopupBinding provides a simple method to enable a Popup Dialog on PX Widgets, allowing users to override specific component values. This feature supports Numeric, Boolean, and EnumWritable components, though it does not currently support StringWritable components. The primary use case is to allow easy adjustments of process parameters directly on the widget, giving operators added flexibility to modify component settings with relevant contextual feedback. Each combination of Popups (Numeric, Boolean, and Enum) shares a consistent interface layout, with the current value of the bound component displayed prominently at the top of the dialog, ensuring a clear overview of the current state before any adjustments. Numeric popups, for example, allow users to control values within a specified range, including a “step” setting for finer control via a slider input. For Boolean components, the popup displays true and false text labels, while Enum popups provide a dropdown list of available values.

Key properties to configure include:

ORD / ORD2: Specifies the component to be overridden, automatically adjusting the popup based on component type.
Feedback / Feedback2: Allows users to link the popup to feedback from hardware inputs or virtual sources, enhancing real-time data reflection.
Title / Title2: Uses a dynamic format to display the component name or other identifying information as the popup title.
Popup Mode / Popup Mode2: Currently supports the “Override” mode, which includes options for Override and Auto actions.

In typical usage, this PopupBinding is ideal for environments requiring controlled, real-time adjustments to specific values on an as-needed basis, improving operational ease and accuracy. This feature ensures that all modifications are transparent and easily reversible through the override functionality.