-

Data List - Toolbar, Context Menu

Note
In Data Lists, the selection in drop-down lists is done with a single-click, not with a double-click.

Note
Depending on the PLANT tree node where the Data List is opened, some (context menu) commands may be inactive or at a different position in the toolbar.

Toolbar buttonContext menu commandDescription

Move Up

Move Down
Moves the selected variable(s) or variable group up or down.

Collapse All Groups

Expand All Groups
Collapses/expands all variable groups. The arrow icon in front of the group name shows whether a variable group is expanded or collapsed.

 : Group expanded.

  : Group collapsed.
Create new Variable
(controller and Safety PLC)
Creates a new global variable in the respective Data List (controller or Safety PLC).

To insert a variable into a specific group, left-click any cell in the desired group and execute the command.
Create new Variable group
(controller and Safety PLC)
Creates a new variable group. The new group is created above the group containing the table line that you have selected previously.
Add Variable
(controller and Safety PLC)
This command is only available if a Safety PLC is included in the project.

This button is available in the Data List of the controller and in the Data List of the Safety PLC.
  • In the Data List of the Safety PLC, it is only available for variables of a standard (non-safety-related) data type which are not yet assigned to a controller variable.
  • In the Data List of the controller, it is only available for variables which are not yet assigned to a Safety PLC variable.
It creates a new controller or Safety PLC variable for the selected variable in both Data Lists and inserts it into the respective column 'Variables (PLC)' or 'Variables (Safety PLC)'.

Note
The resulting data type of a new Safety PLC variable created this way depends on the context in which it was created (i.e., on the leading role in the respective table row):
  • In case of an exchange variable which is assigned to a global controller variable (no process datum involved), the added Safety PLC variable has a standard (non-safety-related) data type.
  • If a safety-related process datum (signal) is assigned (i.e., controller reads safety signal), the Safety PLC variable has the data type of this process datum.

Delete Variable
(Controller and Safety PLC)
This command is only available if a Safety PLC is included in the project.

This button is available in the Data List of the controller and in the Data List of the Safety PLC.
  • In the Data List of the Safety PLC, it is only available for variables which are assigned to a variable of the controller (exchange variable).
  • In the Data List of the controller, it is only available for variables which are assigned to a variable of the Safety PLC (exchange variable).
It deletes the variable and its assignments from the current Data List.

If the exchange variable is not yet used in any POU of the respective other resource it is also deleted there. If, however, the exchange variable is already used in a POU, or if at least a related external variable is declared, it is not deleted. Instead, it becomes a usual global variable which is no longer assigned to a variable of the respective other resource (Safety PLC/controller).
Add HMI TagCreates a new HMI tag for the selected variable and inserts it into the 'HMI' column. The variable and the HMI tag are assigned at the same time. By default, the inserted tag name is identical to the variable name. For user-defined variables, the tag name can be edited.
The command is only available for variables which have no HMI tag assigned.

In the Safety PLC Data List, HMI tags can only be created for exchange variables.
Delete HMI TagRemoves the HMI tag from the variable. This way, the tag is deleted.

Note
When you remove an HMI tag in the 'Data List' table from a variable and the variable is connected to a dynamic property of an HMI object, a corresponding error message is reported in the message window. Double-clicking the message opens the HMI page with the respective HMI object in the editors area. To remove the error, either delete the linkage between variable and dynamic property or assign another variable to the property.

Connect selected entriesConnects the selected list entries.
The command is only available if two table entries are selected that can be connected to each other and while the debug mode is not active.
Disconnect Process DatumDeletes the assignment of process data item and variable in the selected table line.
Disconnect Variable (PLC)This command is only available in the Data List of the Safety PLC for variables which are assigned to a controller variable (exchange variables).

Deletes the assignment of the selected Safety PLC variable to the controller variable. The disconnected controller variable is not deleted.
Disconnect Variable (Safety PLC)This command is only available in the Data List of the controller for variables which are assigned to a Safety PLC variable (exchange variables).

Deletes the assignment of the selected controller variable to the Safety PLC variable. The disconnected Safety PLC variable is not deleted.
Disconnect AllThe command is available in all Data Lists for variables which are connected to at least one other role.

It is also useable for multiple mappings (e.g., threefold mapping between controller variable and Safety PLC variable and process datum).

Deletes all assignments in the selected table row. The disconnected variable is not deleted.
Remove all Unused Global Variables
(controller and Safety PLC)
Removes all unused global variable declarations of this resource (controller or Safety PLC) from the respective Data List. Unused means that the variable or instance is declared but not used in the code of any POU.

The number of removed variables is shown in the Message Window.
Import CSVImports data items from a .csv file (comma-separated values) to the Data List.

The progress of the import is displayed in the MESSAGES window.

The log entries provide, amongst other, information on the number of imported process data items, variables, HMI tags, etc.

Observe the following when importing data items:

  • Only variables and HMI tags are imported. Process data items assigned to variables are not imported.
  • The data items are imported into the pool of data items (contains the data items of all Data Lists). This means data items which do not belong to the active Data List are also imported and added to the respective Data List.

    Example: if the .csv file contains safety-related variables and you perform the import in the Data List of the controller node (contains only variables of the standard controller), the safety-related variables are imported into the Data List of the Safety PLC node.

  • Exisiting data items are not overwritten or modified. Only those data items are imported which are not yet contained in the Data List.
  • Data items with invalid properties, for example, invalid data types are imported but marked as errors in the Data List (a corresponding entry is also shown in the MESSAGES window).
  • Data items with invalid variable names are not imported and the process is aborted.
Export CSVExports all data items contained in the active Data List to a .csv file.

The progress of the export is displayed in the MESSAGES window. The log entries provide, amongst other, information on the number of data items exported.
Show Initial Value ConfigurationOpens the 'Init Value Configuration' editor below the Data List table where members of user-defined data types (ARRAYs and STRUCTs) can be initialized.
After selecting the declaration line of the user-defined data type in the variables table, its members can be edited in the grid of the 'Init Value Configuration' editor.
-Cross ReferencesThe context menu command is only active if the cross references are collected and up-to-date (  is shown in the CROSS REFERENCES window).

Displays the cross references of the current variable. The 'References' submenu shows all references of the current object except the currently selected occurrence. Selecting a submenu entry directly jumps into the corresponding editor or data list ("jump-to functionality" like in the CROSS REFERENCES window).
-Locate in Cross ReferencesThe command is only active if the cross references are collected and up-to-date (  is shown in the CROSS REFERENCES window).

Opens the CROSS REFERENCES window and marks the respective entry for this variable.
-Show all ReferencesThe command is only active if the cross references are collected and up-to-date (  is shown in the CROSS REFERENCES window).

Like 'Locate in Cross References' (prev. table row), this command opens the CROSS REFERENCES window and marks the respective entry for this variable. In addition, the cross reference list is automatically filtered for occurrences with the same 'Name', 'Type' and 'Kind'. For local variables, the POU name is used as filter criterion too.
For more details, refer to section "Showing cross references out of the code ..." in the "CROSS REFERENCES Window" topic.
-Move Up

Move Down
Moves the selected variable(s) or variable group up or down within the 'Variables' table.
-Select All

Cut, Copy, Paste, Delete
Operations are applied to the selected table lines. Default Windows shortcuts can be used for these commands.

Multi-selection can be done by pressing the <Ctrl> key or <Shift> key while clicking on the desired table lines. <Ctrl> + <A> selects all table lines.
-Remove all Unused HMI tagsRemoves all HMI tags from the table that are not used on any HMI page.
-Add to Watch WindowThe command is only available in debug mode.

Inserts the selected variable into the WATCHES window ‣ WATCHES: Monitoring/Debugging the Application
×‣ WATCHES: Monitoring/Debugging the Safety-Related Application
×
for monitoring/debugging purposes.
-Add to Logic Analyzer

Shortcut:
<Ctrl>+<Alt>+<6>
The command is only available in debug mode.

Inserts the selected variable into the LOGIC ANALYZER window for recording variable values from the running controller and visualizing them graphically as curves.
-Overwrite/ForceThe command is only available in debug mode.

Forces/overwrites the selected variable. Which command is available depends on the variable type. Refer to the topic "Debugging code: Forcing/Overwriting ‣ Debugging Code: Forcing/Overwriting
×‣ Debugging Safety-Related Code: Forcing/Overwriting
×
" for details.
-Confirm VerificationThis command is only available if a Safety PLC is included in the project and if a safety violation message has been reported for an entry in the Data List.
After inspecting the suspected declaration in the Data List and verifying its correctness, you can confirm the verification using this command. The safety violation message is then deleted and the project can be built again.

Refer to the topic "Safety Violation Messages and Data Integrity Errors" for details.
-RefactoringOpens the REFACTORING window in the Cross Function Area. The window shows all references of the object (variable, FB instance, etc.) for which the command was executed. Using the window, you can perform an automatic solution-wide replacement of object properties.

For more details, refer to the topic "Refactoring Variables".