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