Class Instance Set Widget Usecases
A Class Instance Set Widget is a user interface component that displays, manages, and interacts with a collection (set) of instances belonging to a specific class or object type
Features
-
Mask from Context: Using this feature, users can filter the Incoming Context with different filter parameters as shown in the screenshot below

-
Query Mask Update: After applying the Mask from Context, users can see the Query Mask gets updated as shown in the screenshot below.

-
Separate Properties to Context: This feature is part of the Data Context Out section in the widget properties. It is a select type property that, when enabled, activates a new property called 'Historized', which is a checkbox option.
-
Enabling this option filters the results to display only Historized Equipment properties. Additionally, the Properties to Context property becomes available with a dialog box where users can select the required Equipment Properties from the Source Class configured in this widget. All selected properties are bundled into a context array and sent to the receiving widget.

Use Cases
Use Case 1 : Process Level MV Uptime property Visualization.
Description: The dashboard provides a process-level view of Manipulated Variable (MV) Uptime across all Model Predictive Controllers (MPCs) within a selected process. Users can select a process from a drop-down widget, and the system automatically discovers all MPCs and their associated MVs under that process and displays the MV Uptime equipment property on a chart.
Business Objective : Operators and engineers require a consolidated view of MV performance across an entire process without manually navigating through individual MPCs and MVs. This feature enables users to analyze uptime trends and compare MV availability across multiple MPCs from a single dashboard.
User Interaction Flow
Step 1: Process Selection
A Select Widget is displayed on the dashboard containing all available Process instances from the equipment model.
This can be achieved by adding a select widget to filter the Processes for a line and also apply a mask for it as show in screenshot below.
Set the Mask as : Parent LIKE '*.Line2', this will filter all the Processes available in Line 2

Step 2: Equipment Discovery
Add a Class Instance set with required MV Equipment type as source as shown in the screenshot below. And let the Class Instance Set widget listens to to the Select widget added in step1

In the Class Instance Set widget add a Data Context In to create Mask from Context as shown in the screenshot below. This will

In the Class Instance Set widget in Data Context Out section click on 'Separate Properties to Context' to filter out only the required properties, select Historized as True as you are going to shown them in Chart Widget. And also select the property as 'MV Up Time' (you can select additional properties too if needed) as shown in screenshot below.
Upon process selection in the Select Widget, the system identifies the selected Process and traverses all child MPC instances under the selected Process. Under each MPC, the system discovers all child MV instances and system retrieves the MV Uptime equipment property.
Step 3: Chart Population
The Chart Widget is automatically populated with all MV Uptime trends discovered under the selected Process. Each MV Uptime appears as a separate trend/series item.
To achieve this, add a listen to context in Chart widget to Class Instance Set configured in the step 2
Updated 4 days ago

