Object Properties Panel
The Object Properties Panel is by default shown on the right hand side of DataStudio. It shows all properties of the currently selected object. Objects can be selected in any panel in DataStudio and will be shown in the Object Properties Panel.
Alternatively, objects can be selected to be displayed in the Object Properties panel from the available DataStudio Displays by clicking the icon, or
selecting _Load in Property Panel from the context menu (shortcut: Ctrl+Shift+L).
This section describes the different sections of the panel.

The content of the Object Properties Panel heavily depends on the selected object type. This chapter describes the principles behind the object properties panel, not a description of each object type. For a detailed description of each object, please refer to the system documentation. |
Header
The header of the Object Properties panel always shows the object name, type (read only) and icon representation. In addition it contains a Refresh button which when pressed, will require all properties of the object currently shown in the panel from the Core server.

When the cursor is hovered over the header panel, a "+" appears beside the object icon. Clicking on this will open the advanced header properties.

The Advanced Header contains information about the object to give the user more detailed information about the history of the object and it’s current status. The table below explains the different fields.
The advanced header fields are populated by the system and are non-configurable by the user. They are accessible to read using the Lua Object Methods described in the Lua API section of the documentation. |
Header Field | Description |
---|---|
Object ID |
The unique Object ID used by the system internally to identify the object. This is particularly useful for Lua API and Web API developers. |
Item Path |
The path to the object in the respective Model Panel where it has been created. This is particularly useful Lua API and Web API developers. |
Config Version |
The Config version for the object indicates how many configuration changes the object has undergone since creation. The Config version incrementally rises each time object properties are changed and applied to the server. |
Class Version |
The class version of the object. The object is an instance of a particular class in the system. The classes are |
Created |
The timestamp for the creation of the object. The following field contains the name of the profile that created the object. |
Modified |
The timestamp for the last modification of the object. The following field contains the name of the profile that made the modification. |
State |
The user state flag group (or bitmask) for the object describing the state of the object. A more detailed explanation of the user state flag group and the different section meanings can be found in the System Documentation). |
Faceplate
The Faceplate section of the Object Properties panel is available only, when the selected object’s type
has a dynamic value property. The type of Faceplate displayed depends on the type of object
selected. The Faceplate can be collapsed using the expand/collapse icon next to its section name.
The available faceplate display options can be configured by clicking on the settings icon ().
The available display options will depend on the type of object selected, the
types of faceplate display are described below.
Faceplate (for normal I/O Items)
.png)
The Faceplate gives a quick glance at the state of values coming from an I/O item. It contains many different elements that are each described in the following table.
Element | View | Meaning |
---|---|---|
Description |
Object description property |
|
Display Properties |
Open Display Properties window |
|
Read/Write Info |
Signals if the object can be read from ® and/or written to (W). Allowed functions are highlighted white |
|
Low EU Range |
Signals if the object’s value violates the configured low EU range |
|
High EU Range |
Signals if the object’s value violates the configured high EU range |
|
Low Limit |
Signals if the object’s value violates the configured low limit |
|
High Limit |
Signals if the object’s value violates the configured high limit |
|
OPC Quality |
The current simple OPC quality in words and colors (good = green, uncertain = yellow, bad = red). The detailed quality can be read from the tooltip of this element. |
|
Configured Limits |
Visualization of EU Range and limit properties. |
|
Value |
The current value of the object, formatted according to number format configuration. Double clicking on the value opens the Write Value dialog |
|
EU |
Engineering unit |
|
Timestamp |
Timestamp of current value, formatted according to format configuration |
|
Age Gauge |
The age of the current value. Scale of the gauge depends on the acquisition rate. Blue bar is positive age, yellow bar is negative age. The latter can only be seen when there is time synchronization issue between Connector, Core and DataStudio client. |
Faceplate (AE)
The alarms and events Faceplate is displayed when an event visualization object such as an Event Stream, Internal Event Stream or Script Events object is selected. Hovering the cursor over the Faceplate will bring up the full details of the alarm or event currently displayed in the Faceplate. Double clicking in the center portion of the faceplate will open an EventView display which will then be populated with events from the selected event object.

Element | View | Meaning |
---|---|---|
Display Properties |
Open Display Properties Panel. |
|
Alarming Enabled |
If highlighted, indicates that alarming is enabled. |
|
Alarm Active |
If highlighted, indicates that the alarm is active. |
|
Alarm Acknowledged |
If highlighted, indicates that the alarm has been acknowledged. |
|
Severity |
Visualization of the severity of the alarm (1 - lowest, 1000 - highest). |
|
Source and Timestamp |
The source of the alarm and the timestamp are displayed here. |
|
Event Count |
Indicates the number of event notifications available to be viewed in the faceplate, use the arrow buttons to scroll through the events. |
|
Event Count Interval |
Indicates the time period over which events will be stacked in the Faceplate to be available for viewing. The lightning icon fills up as it get towards the time indicated. Once full, the Faceplate events stack is emptied and the count starts again. Click to toggle between different stack times. |
|
Open Filtered Event View |
Different event Source (top row) or Category Names (bottom row) will appear here in the Faceplate. Clicking on these wil open an event view display, filtered to display only that source or category name. |
Faceplate (KPI)
The KPI faceplate is displayed when a generic KPI item is selected in the KPI model. The KPI faceplate displays the name and current value of the selected KPI object alongside a trend line for the KPI. The faceplate is essentially identical to the Visual KPI display of KPI items, with the color changing in accordance with the limit settings and target values. The arrows and tick marks also give an indication of the value in relation to the limit settings.
.png)
Information Tabs
The different tabs on the Object Properties panel are only enabled when their function is active and their content applies to the currently selected object.

From left to right the following tabs are available:
-
Properties Tab Always enabled
-
Security Tab Enabled only when security profile was assigned to object
-
Object References Tab Enabled only when the selected object has a reference to or is referenced by some other object
-
Performance Counter Tab Enabled only when the selected object exposes information by performance counters
-
Instance Class Diagram Tab Always enabled
The functions and capabilities of these tabs are discussed in the following sections*.*
Properties Tab
This tab shows the properties of the object currently selected. Since different object types have different properties, the content of this tab changes depending on the object type. Hovering the mouse cursor over different elements in the tab will display a tooltip giving a detailed description of the element.

Changing one of the available properties (for example changing a limit value) will cause blue highlighting to appear around that property to indicate that it has been changed. To confirm the property change and update the information with the Core server press the Apply button at the bottom of the Object Properties panel.

If changes are made to a property value and the changes were not confirmed by pressing the Apply button before moving to another object, the following warning message will be displayed.

Click Yes to discard the changes of the object currently loaded in the panel and to load the newly selected object. In this case all changes will be lost. Click No to keep the changes, keeping the current object in the panel and not load an other object into the panel.
Security Tab
If the currently selected object has explicitly applied security references then the Security tab will be enabled and will show the list of profiles that were assigned.

The security permissions are indicated by the checkboxes which are List, Read, Write, Modify, Execute and Inheritable (please see here for more information about permissions).
Security permissions and references cannot edited, added or deleted in the Security Tab. To do this it is necessary to open a Security Config display and make the changes there. To open a Security Config display from the Security Tab, either click on the icon or right click on one of the Profile names and select "Open in Security Config" from the context menu.

Please read the Working with System Security Jumpstart for more information about configuring system security and the Security Config page for information on changing permissions and references for existing Profiles.
Object References Tab
If the currently selected object has references to other objects or is itself referenced by other objects, then the Object References tab will be enabled. The references to other objects will be displayed in the Object References table. Here the Name of the reference, the Type of reference and the Item Path of the object being referenced will be indicated in the respective columns.

In the Object References tab of the object that is being referenced this will appear as a Referenced By table, indicating the path of the referencing object.

Right-clicking on any of the references in the Object References table will display a context menu (shown below). From here the referenced object can be added to a display (Add item to…), or a value written to the reference object (Write Values, this action is possible if the user has write privileges over the referenced object). The reference can also be removed from the Object References table (Remove reference), renamed (Rename) or the referenced object can be found and highlight in the model tree panel (Find reference). The name and the path of the referenced object can also be copied to the clipboard (Copy name, Copy path).

Performance Tab
If the currently selected object supports performance counters, this tab will be enabled and show a list of performance counter trends. Different objects display different performance counters related to the object’s function. An object’s performance counters are grouped into different categories. To only view counters from a particular category, select from the drop down menu in the top left of the tab.

Each performance counter trend shows 60 seconds of performance data. For each performance counter, the name and the current value are displayed on the top left and the currently shown performance range and unit on the right.
The range of a performance counter trend changes automatically based on the currently shown values. |
An object’s performance counters are grouped into different categories to make browsing easier. To only view counters from a particular category, select from the drop down menu in the top left of the tab.

The size of the performance counters in the object properties panel can be adjusted by selecting from the drop down menu in the middle, at the top of the tab.

The performance counters, by default, show the real-time performance data and update every second. However the display can be configured to show different time period aggregates by selecting from the drop-down menu on the right, at the top of the tab.

Selecting the 'Minute' configuration for example, shows the performance data aggregated every minute for the last 60 minutes. The Max, Min and Average values for each minute are shown in the trend part of the display (the blue trend line indicates the Count number of values at each minute time point). Hovering the mouse over the performance counter will also display this data for the chosen time point.

The available performance counters for each object (including a description of their meaning) are listed in the Class page. Performance data for objects can be also archived by selecting the object, right-clicking and selecting from the context menu.

A series of objects are created in the I/O tree, archiving the performance data for each performance counter.

Instance Class Diagram Tab
The Instance Class Diagram tab shows a hierarchical representation of the structure of the currently selected object in terms of its properties and sub-properties. The diagrams can be large and complex so the settings can be altered to assist with viewing the diagram.

The icons in the top right of the Instance Class Diagram tab can be used to copy, refresh and configure the diagram.
Element | View | Meaning |
---|---|---|
Copy Mode |
Toggles the copy mode for right mouse click to on or off. When on, holding down the right mouse button and dragging over a desired area of the instance class diagram will copy said area to the clipboard |
|
Refresh |
Enforces a refreshing of the diagram |
|
Options |
Toggles to show or hide the display settings and options for the instance class diagram |
Writing Values in the Object Properties Panel
Values can be written to I/O panel objects that have a dynamic value property (for example, I/O items, Data Holders, GenItems and Action Items) using the Faceplate in the Object Properties panel. To do this, first select the item in the I/O panel to display the Faceplate for the Item (including its current value) in the Object Properties panel.

Double-clicking anywhere within the Faceplate will open the Write Value dialog for the selected object.

The Write Value dialog opens and highlights the value field (containing the current item value). To write a new value to the object, chose the data type of the new value from the drop-down menu, then enter the new value into the Value field and click Write.

You cannot enter a null value in the Write Values dialog box, however null values can be written to objects using the SCI or Lua scripting. See the SCI and Lua scripting Chapters for more details about writing values to objects using these interfaces. |
When entering a "String" data type, click on the Editor button to open the text editor box. Here you can enter larger blocks of text including line breaks (use Ctrl+Alt+Enter to enter carriage returns in the editor).

Writing Array Values
Tick the "Array" checkbox to write values as an array. The Value field contains a guide for how array values should be entered, in square brackets, with each element of the array separated by a "|" character.

Null values can be written to elements in the array by either entering "|" twice (the null value being between the "|" characters) or by entering <null> as one of the elements.

An empty array of the type "[]" cannot be written as a value, however an array with two null elements can be written. For example "[|]" or [<null>|<null>].

Writing null values to arrays is only available in v1.20 and above. |
Generator Options
Clicking on the arrow next to "Generator" expands the options for generating a number using the sawtooth or sinewave functions. Press the "Play" arrow to start the generation then "Pause" to stop. Closing the Write Values dialog will then write that value to the object.

Parameter - OPC Write Options
If writing to an I/O item in an OPC server namespace, the "Parameter" options allow you to choose the OPC Write options. Clicking the arrow next to "Parameter" expands the options.

Different OPC write modes can be selected and the delay between collecting writes configured. There is also the option to create an audit for the writes in the Session Log. Further information describing these configuration options in more detail can be found here.
JSON Viewer
Right-clicking on the faceplate will display the context menu from where you can copy the current value (shortcut Ctrl+C), copy the selected object’s property ID or display the current object value in the JSON viewer (shortcut Ctrl+Alt+J). The JSON viewer allows the user to visualize the structure of a JSON string as a tree structure, as displayed in the left hand panel of the Viewer window. The different fields of the JSON document can be selected here and viewed in the main window.

There is also the option to display JSON string as a formated document in a script editor by clicking on the {} icon in the menu bar to display the raw JSON.

If the faceplate value changes while the JSON viewer is open, the viewer can be refreshed by clicking on the "refresh" icon in the menu bar.
