List ATS Component

Definition

A generic design template for displaying data in a list.

It is implemented using the Web Dynpro component FPM_LIST_UIBB_ATS.

The information displayed in a list at runtime is determined by the feeder class assigned to the configuration of the Web Dynpro component FPM_LIST_UIBB_ATS.

Note

This List component supersedes the original List component implemented by the Web Dynpro component FPM_LIST_UIBB. The List ATS (ABAP Table Services) component provides you with an extended range of features, including personalization features, and advanced sorting and filtering functions.

Use

You use this design template when you want to display data using a list. You can determine the concrete display of the data in a list when configuring the Web Dynpro component FPM_LIST_UIBB_ATS.

Structure at Runtime

A list is displayed as a table of rows and columns at runtime. Each item in a list is displayed in a separate row. A list has its own toolbar.

Each column of the list has a column header. If the application has enabled list functions such as sorting, filtering, and grouping, an arrow appears in the bottom-right corner of the column header when you hover the mouse over the heading at runtime. The available menu options are determined by the relevant feeder class.

List components may contain an action column containing several one-click action controls.

Editing the Structure at Design Time (FLUID)

You configure this component using FLUID, the FPM configuration editor.

At design time, the Preview panel in FLUID displays the List ATS component in a WYSIWYG style.

In the General Settings panel, you can specify settings applicable to the list as a whole.

In the List UIBB Schema, you can specify attributes for the individual elements of the list, and add or remove columns.

For more information on the attributes of this component in FLUID, choose Field Help from the context menu in the system.

Changes to Elements of Previous List Component (FPM_LIST_UIBB)

Note the following changes regarding elements that were available in the previous version of the List component:

Data changes in feeder class method FLUSH
Method FLUSH contains the parameter IT_DATA. This parameter holds a reference to the internal table which contains the table data. Therefore, it is theoretically possible to change the table data using this parameter, though it was never the intention to allow the feeder class to do so. The correct place to change the data is in feeder method GET_DATA. The List ATS component no longer allows you to change data in FLUSH.
Style of rendering
The original List component can be adjusted to render itself in the following styles:
- Normal list rendering
- Row-repeater rendering
- ALV rendering
This feature no longer exists in the List ATS component (the features in ALV rendering are already included in the List ATS, for example, personalization, extended sorting, and filtering).
Text wrapping for column headers is now possible using the Header attribute of the column in FLUID; use the ENTER key to start a new line in a header. Previously, it was also possible to control text wrapping in the feeder class (method GET_DEFINITION, parameter ET_FIELD_DESCRIPTION, attribute HEADER_TEXT_WRAPPING). This is no longer possible in the List ATS UIBB.