Working in Table Editors for Content
Table editors for content enable the clear and convenient editing of elements of the types set in the respective table configuration within a selected structure element or other selections, e.g. in the result region.
Purpose
You can use the table editor for content to easily edit elements of types which you have assigned a table view to in the Manage Table Views dialog.
A table is write protected or opened for editing, depending on the Open Documents Read-Only option.
General Table Functions
Merging Table Columns
Properties from various element types are shown in the table. If a stereotype property, label or text is configured for a stereotype of one of these properties, then this property appears as a column in the table.
Equivalent columns for different element types are merged into one column in the table if the following conditions are met for the configured properties:
-
The logical name of the properties of the various element types is identical.
-
The properties belong to the same class (stereotype property, label, text).
-
The properties have the same data type (string, integer, date etc.).
The first name is shown if the names differ in the display language.
Table View
You can arrange and design the table in accordance with your needs:
-
You can group the table in the area above the header. Please drag the title into this area to group by columns.
To remove the grouping, drag the property back to the table.
-
Use drag-and-drop to change the order of columns by dragging the column headers. A user-defined order can be changed using the Reset Column Order context menu command.
-
The fixed column splitter to the left in the column header can be used to fix the columns to the left edge.
Fixed columns are not moved if you click on the horizontal scroll bar.
-
You can sort the rows according to the value of this column by clicking in the header.
Sorting is only temporary for viewing purposes. It is not stored in the repository.
-
You can select a table row by clicking on the row marker.
-
You can constrain what is shown using the
filter row below the header. The list is narrowed to rows which correspond to the filter entered. To filter Boolean values, enter t, r or u for "true", f, a, l or s for "false", and e to display both Boolean values.
-
In a dialog, you can define stereotypes as filters for the table entries.
A layout of this kind is called a table view.
A modified table view is valid only temporarily for the display of the active table. It is not saved automatically.
You can save a table view with a name and apply it to an active table later on. You can also open new tables with a saved table view.
Note
Entries in the filter row are not saved with the table view.
Loading Further Content
You can load further content to the table by using drag-and-drop to position a structure element or an element set in the window header. The table content then appears like when you open a table.
The table view is retained apart from entries in the filter row.
Labeling and Types of Fields
Labeling Fields
Labeling the table cells improves the clarity of the table. Labeling cannot be suppressed.
A distinction is made between the following labels:
-
Editable fields
-
Editable fields with incorrect input (red background, note tool tip)
-
Read-only fields (pale gray background)
-
Undefined table cells (dark gray background)
Field Types
There are the following types of editable and read-only fields:
-
Field for direct entry
Click in the field and enter the property.
Example: Name
The field is marked red if the input is rejected by the server, e.g. if the name is not unique. Please read the tool tip to see how to fix the problem.
A button appears for the input field for the value if the input field belongs to a property, stereotype property or label of the string type and is a URL value; you can then use this to jump to the URL.
The input field is write protected and has the
icon if the input field belongs to a property, stereotype property or label of the string type and has the multi-line value. Clicking on the icon opens an editing dialog for multi-line text.
-
Drop-down list field for selecting a predefined value from a list
Click on the drop-down list icon
and select the property from the list.
Example: Value lists (label, stereotype properties)
-
Check box for activating or deactivating an option
Click on the
check box icon and (de)activate the property.
Example: Boolean properties
-
Element selection field for selecting a linked model element
Click on the Select Element icon
and select a suitable element in the select dialog. If it is an optional element link, you can remove the link using the Clear value icon
.
Example: owner, type
How to Use the Keyboard
Function | Shortcut Key |
---|---|
Move the active table tab one position |
Ctrl+arrow key left or right |
Search in the Table | Ctrl+F |
Move the current cell one position |
Arrow Keys |
Open the editor for changeable cells | F2 |
Move the active cell one position and open the editor for editable cells |
Ctrl+arrow keys |
Move the active cell to the next cell which can be modified and open the editor |
Tab |
Move the active cell to the previous cell which can be modified and open the editor |
Shift+Tab |
Move one position in the cell editor |
Arrow keys |
Implement a Boolean value |
Space bar |
Adopt the entry |
Enter |
Discard the entry |
Esc |