Table Control Layout in Variants

This section contains information on the following topics:

  • The Administrator Function and Table Controls in Screen Variants
  • Adopting Table Control Layout in Screen Variants
  • Setting and Resetting Table Control Layout in Screen Variants
  • Inserting Additional Columns in Table Controls

The Administrator Function and Table Controls in Screen Variants

You can adopt layout guidelines for table controls in a screen variant.

The same functions are available here as found in the administrator function in a table control:

  • Determining column sequence
  • Determining column width
  • Hiding columns

In addition, you can also:

  • Revoke the ready for input status of individual columns
  • Define default values for table controls in certain circumstances

Since screen variants can be transported, their corresponding table control layouts can also be transported as well.

If table control administrator settings exist and the layout has been defined using a screen variant, the screen variant's layout takes precedence (screen variant layout is set after PBO and thus overwrites the administrator settings).
A table control's user settings are not overwritten by screen variant settings except in the following cases:

  • Hidden columns remain invisible
  • Columns not ready for input remain locked
  • Screen variant default values are adopted

The first two points are important, otherwise columns could be seen or changed by user groups that they should not be available to.

Adopting Table Control Layout in Screen Variants

You can define specific table control options when creating or changing a screen variant just as you can with other screen elements.

Table controls are displayed in the following manner: Those attributes that are valid for the entire table control are displayed first-- set off from the others by underscores. They are:

  • Adopt column sequence
  • Adopt column width
  • Invisible (that is, hide entire table control)

If Adopt column sequence or Adopt column width is selected, the column sequence or column width that was just set is saved to your screen variant.

After all of the attributes for the table control as a whole are displayed, all of the columns appear in the sequence in which they were defined in the Screen Painter (NOT in the sequence set at runtime).

All fields containing a value are displayed; in addition to the field names, the row number is shown as well.

Since the system cannot always tell when display masks are initial, their fields are sometimes displayed as well, even though they are initial.

You can adopt values in your variant for all table control rows except the selection field (certain restrictions apply).

The first field of each column is always displayed so that the output attributes for the column (Invisible, No entry) can be set.
Output attributes can be set only once per column and apply to the whole column.

Setting and Resetting Table Control Layout in Screen Variants

When calling screen variants that contain table controls, the layout of the table control is adopted automatically.

The layout settings are changed directly in the application program. These changes retain validity until they are overwritten, either by another screen variant or by the application program itself.

Layout settings remain active, even after screen variants have be explicitly reset and are no longer active.

You can alter the table control layout by calling a new screen variant containing the original table control layout settings.

Inserting Additional Columns in Table Controls

Whenever you attach additional columns to a table control for which screen variants have already been created, the screen variants can no longer determine the column sequence since this could lead to multiple column indexes (all other options remain unchanged).

In this case all of the screen variants belonging to your table control must be adjusted. All new columns should be inserted at the beginning of the screen variant.

If you do not adjust these variants, the message Column sequence could not be set is displayed at runtime.