Working with DataGrids (Reference):
DataGrids in FrameworX provide:
Table of Contents maxLevel 2 minLevel 2 indent 10px exclude Steps style none
Note: This documentation covers Configuration DataGrids in Designer. For DataGrid components in Operator Displays, see the Draw section.
A DataGrid is a tool for presenting, manipulating, and structuring data in a tabular format, accommodating large volumes and intricate data structures. It consists of rows and columns, with each cell representing a data item. Key functionalities include data filtering by certain criteria, sorting by column headers, direct cell content editing, and grouping and manipulating data as needed. Interactions generally involve selecting a cell and inputting new data.
In this context, we are referring to the Designer Configuration DataGrids, the tables that hold the Solution Configuration. The examples and shortcuts explained in this section are related to the Designer User Interface. When Creating Displays, it is possible to add a "DataGrid Component" to the Operators Displays. While some of the behavior of those grids is similar, it's a different context, and those grids are explained in the Draw section of the documentation.
On this page:
Table of Contents | ||||||
---|---|---|---|---|---|---|
|
Most Solution Configuration interfaces are presented in DataGrid tables, which offer various features to help manage and edit the contents of the configuration tables.
Most tabs display information in a table format, and all tables use the same methods to manipulate, copy, paste, and import data.
Most configurations, such as tags, alarms and users, are stored in tables. In most tables, you can add and edit information using the insertion row.
To add a new table item (row):
1.2. Once you click a column in the row, the
When editing a table, you can:
If the column is a text field, enter the information.
If the column is a selection field, click the same spot again and select items from the drop-down list or pop-up window that displays.
Press Tab to move through the columns in the row.
To edit an existing row, click the column in the row that you want to change and do one of the following:
If the column is a text field, enter the new information. The system overwrites the text that was in the field. To change part of the text, click again.
If the column is a selection field, click again and select items from the drop-down list or pop-up window that displays.
An easy way to create a tag is to click the Name column of the insertion row, then press Space and Enter. Each time you do this, the system will create the same type of tag that was last created. In the insertion row, select the Type, then click on the header or any other part of that grid. This will create a tag with a default name.
You can configure more than one row at a time by selecting the rows with the Shift button, then right-click and select "Edit Combined Rows". A new dialog will open with the information for the rows. The settings changed in this window will apply to all the selected rows. If a column has more than one configuration, the platform will indicate it.
Tables display a default set of columns. Every table has additional columns that you can display, and you can remove any of the default ones. You can also change their order.
To add or remove a column:
1. From any table, right-click the column heading area.
2. A list of all available columns for that table will be displayed. Columns with a check mark next to them are displayed in the table.
3. Select or deselect columns in the list.
4. Click outside the list to close it.
5. To change the order of the columns, drag a column heading to a new location.
6. To reset the columns to the default, click Reset Grid to Default Settings buttonat the top right of the table, next to the search bar.Click a column name to sort by that column and to change the order to ascending, descending, or none. When none is selected, the internal row ID is used: every DataGrid has an internal column named "ID".
Click the down arrow icon to select visible rows according to their content.
Drag and drop the column titles in the upper area to create a dynamic hierarchical grouping of the information.
Quick creation method:
Click Reset Grid to Default Settings button (top-right near search bar)
Drag column headers to new positions
Click column header to cycle through:
Click down arrow in column header to:
Column | Description |
---|---|
ID | Database ID | assigned to the object in the table. Numbers are assigned starting from 1 for the first object created and continue as needed. The IDs are unique only to a specific table.
Level | Select the level you want to associate with the tag on the Asset Tree. Learn more at UNS Asset Tree. |
Category | Select one or more categories for this attribute. See Solution Categories. |
DateModified | Date the object was last changed. |
DateCreated | Date the object was created. |
Description | Enter a description of the object |
You can copy and paste rows into and from tables on the software platform. The smart copy/paste functions allow you to copy rows from one table to another. For example, you can copy tags and paste them into the Historian tab or the Items tab under Alarms. You can also copy and paste to and from a spreadsheet. Additionally, you can import a comma-separated values (.csv) file into any table. Column headings must match the table you are importing into. The best way to ensure the headings match is to first copy rows into a spreadsheet, then edit the spreadsheet.
Copying and Pasting
To copy rows to another tab:
Copying and Pasting To or From a Spreadsheet
To copy rows to a spreadsheet:
To paste rows from a spreadsheet:
(unique per table, starting from 1) | |
Level | Asset Tree association level |
Category | Object categorization |
DateModified | Last change timestamp |
DateCreated | Creation timestamp |
Description | Object description text |
Smart paste automatically maps columns between different table types (e.g., Tags to Historian).
To Spreadsheet:
From Spreadsheet:
Key | Action |
---|---|
Tab | Next cell |
Shift+Tab | Previous cell |
Enter | Commit edit, move down |
Escape | Cancel edit |
F2 | Enter edit mode |
Space | Toggle checkbox/open dropdown |
Ctrl+C | Copy selected rows |
Ctrl+V | Paste rows |
Delete | Clear cell content |
Issue | Solution |
---|---|
Cannot edit cell | Check user permissions |
Paste not working | Verify column headers match |
Lost column layout | Use Reset to Default |
Slow performance | Apply filters, hide columns |
Changes not saving | Check multi-user conflicts |
Page Tree | ||
---|---|---|
|
In this section: