OAS PopupBinding

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

When added multiple times, to one widget multiple distinct popups will open.

NOTE: When using multiple popup bindings in uxMedia the close of one will also close all other popups.

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, then ypu can control 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`
modal	boolean	`true`

ord

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 the %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.

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

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.

title

Uses the BFormat Type to dynamically define a String used to be shown as the Popup’s title when open. Due to the BFormat you can use the hole context of the component defined in the ord property.

popupMode

Change the behavior of the Popup. The off mode will only show the value of the ord and feedback property alongside the override status of the ord component. When choosing the set mode the popup only shows the set-Action of the ord component, if the permission is granted by the system. In the override mode only the override- and auto-Action, if the permission is granted by the system. When enabling the permission mode only those actions will be shown that the user has permission io invoke. That has to be carefully setup by the creator of the station.

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.

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 Popup (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: Specifies the component to be overridden, automatically adjusting the popup based on component type.
Feedback: Allows users to link the popup to feedback from hardware inputs or virtual sources, enhancing real-time data reflection.
Title: Uses a dynamic format to display the component name or other identifying information as the popup title.
Popup Mode: Let the user choose to only show the information, only show the set or override and auto action or eval the given permission to decide which actions to show.

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.