State Changes Display

The State Changes Display can be used to view all state changes in the system. This display can be accessed by clicking on the State Changes Indicator in the footer panel of DataStudio.

State Changes Display
Figure 1. State Changes Display
Table 1. State Changes Display Menu Bar Items
Element Shortcut Action

pause icon

-

Start/stop display state changes

icon export

-

Export the current contents of the grid into a file (CSV, MS Excel, JSON) and opens the file automatically

icon play

-

Start/stop the log of state changes to file

state change display update interval

-

Time interval for the frequency in which data is collected

state change display change button

-

Change interval

state change display fetch data button

-

Retrieves the object Name and Path

The State Changes Display is split into two tables. The top table is the Data Grid which contains information about the state changes collected during the update interval. The bottom table is the Statistic Grid which is updated each time there is a state change in the system and records the number of state changes for each object whilst the display is open.

Data Grid

The Data Grid lists all of the state changes collected during the update interval.

State Change Display - Data Grid
Figure 2. State Change Display - Data Grid

The columns in the Data Grid are:

  • Name: Object name

  • Path: Object path

  • Object ID: Unique object identifier

  • Config Version: Object configuration version

  • Config version changed: Indicates if the configuration version was changed

  • Children changed: Indicates if the object’s children were changed

  • State changed: Indicates if the state of the object was changed

  • State: If the state was changed, this column contains the new state information. This information can also be found in the Header section of the Object Properties Panel

  • From DataStudio: Indicates if the change of state occurred in DataStudio

  • JSON: This column contains the state change as a JSON from the server.

The columns in this table can be changed by clicking the icon select column 32 icon in the menu bar. All of the columns listed above are displayed by default.

Selecting any row in this grid will display an eye icon icon certificate view 32 in the Name column of table. Click this icon to open the object in the Object Properties Panel.

Context Menu

Right-click on any entry in the Data Grid to open the context menu. This can be used to change the row order, add new rows and set entries to null.

State Change Display - Data Grid Context Menu
Figure 3. State Change Display - Data Grid Context Menu

The context menu can also be used to open the JSON Viewer for each entry. For more information, see the JSON Viewer section in the Properties Panels documentation.

Statistic Grid

The Statistic Grid contains a list of the objects that have been changed whilst the State Changes display is open. It also contains a count of the number of user state changes.

State Change Display - Statistic Grid
Figure 4. State Change Display - Statistic Grid

The columns in this grid are:

  • Name: Object name

  • Path: Object path

  • Object ID: Unique object identifier

  • Count: This is the number of state changes for each object whilst the display is open.

All of these columns are displayed by default and cannot be configured.

Selecting any row in this grid will display an eye icon icon certificate view 32 in the Name column of table. Click this icon to open the object in the Object Properties Panel.

Context Menu

Right-click on any entry in the Statistic Grid to open the context menu. The context menu can be used to load the object in the Object Properties Panel and navigate to the object in the model tree.

State Change Display - Statistic Grid Context Menu
Figure 5. State Change Display - Statistic Grid Context Menu