Show TOC

Hierarchical List (Tree) ComponentLocate this document in the navigation structure

Definition

A generic design template for displaying data in a hierarchical list (also known as a Tree). A hierarchical list is a list of items arranged on interdependent successive levels. Certain items in a hierarchical list are associated with nodes that may be expanded to display further lists below them. Each item in a lower level list has a parent/child relationship with the item in the higher level list whose node was expanded.

It is implemented using the Web Dynpro component FPM_TREE_UIBB.

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

Note

From SAP NetWeaver 7.3 EHP1 SP4 onwards, this component uses the Web Dynpro ABAP C-Table (Client Table) for displaying the data in a list (which the List ATS component also uses). The main advantages include better client-side rendering, and smooth horizontal and vertical scrolling. It also features an integrated personalization dialogue box, and new configuration features in the General Settings panel. All new configurations of this component automatically use the C-Table. Previously made configurations are not updated with the C-Table. New component configurations still use the same feeder classes as were previously used for this component.

Use

You use this design template when you want to display data in a hierarchical list format. You can determine the concrete display of the data in a Hierarchical List component when configuring the Web Dynpro component FPM_TREE_UIBB.

Structure at Runtime

A Hierarchical List component is displayed as a table of rows and columns at runtime. Each item in a list is displayed in a separate row. Items are grouped together under nodes. 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.

The following figures illustrates what a Hierarchical (Tree) component might look like at runtime:

FPM Hierarchical List (Tree) GUIBB
Figure 1: Hierarchical List Component at Runtime

If the application has enabled sorting, a small arrow appears in the bottom-right corner of the column heading at runtime allowing you to perform this function.

Hierarchical 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 the FPM configuration editor, FLUID.

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

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

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

A Hierarchical List has the following properties:
  • Master Column

    The master column displays all the items in a list. When the system first displays the list, each top-level, parent item in the master column is preceded by an Expand or Collapse icon, which allows you to see the child (sub) items contained within it. A top-level item in the master column with no child items has no Expand or Collapse icon preceding it.

    The master column is always visible and is always displayed as the first column in a table.

  • Incremental Loading

    The Hierarchical List component permits incremental loading of data, meaning that data relating to sub-lists can be loaded into the application only when the node is expanded.

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