FPM Events and the Hierarchical List Component

These events are raised from the following sources:

• Cell events
  The columns may contain fields with a display type that is capable of raising an event (for example, a Button display type). All cell-based events have the FPM event ID IF_FPM_GUIBB_TREE=>GC_GUIBB_TREE_ON_CELL_ACTION. The corresponding row and column values are added as event parameters to this FPM event as follows:

  • IF_FPM_GUIBB_TREE=>GC_EVENT_PAR_ROW
  • IF_FPM_GUIBB_TREE=>GC_EVENT_PAR_COLUMN_NAME
• Toolbar events
  Almost each toolbar element may raise an FPM event. In this case, the event ID is the action ID (which is defined by the feeder class in method GET_DEFINITION). To get user input values from elements such as a toggle button, input field, or dropdown list box, you can use the following FPM event parameters:

  • IF_FPM_GUIBB_TREE=>GC_EVENT_PAR_TOGGLE_STATE
  • IF_FPM_GUIBB_TREE>GC_EVENT_PAR_INPUT_VALUE
  • IF_FPM_GUIBB_TREE=>GC_EVENT_PAR_DROP_DOWN_KEY
  Note There is a default button set in the toolbar for applications. This button set contains two buttons, Expand All and Collapse All, which control the display content of the tree nodes. Once the default button set is configured, the application itself must handle the event IDs of these buttons in the feeder class.
• Selection events

  A row selection may also raise an FPM event. It is possible to choose whether only a lead selection, or a normal selection raises an FPM event. For more information, see the system documentation in FLUID).

• Sorting Event:

  It is possible sort the Tree UIBB. However, the FPM framework provides only the handle for the sort event triggered on the UI by a user. As a result, an FPM event is triggered which can then be handled in the respective feeder class. Information such as the feeder class, the direction of the sort, and the column which is sorted are available as event parameters. The actual sorting of the data must be handled in the feeder class itself. Note that the master column of the Tree UIBB is not available for sorting. Sorting can be activated only for the other columns in the Tree. Additionally, sorting needs to be activated by the feeder class ( in the GET_DEFINITION method). The FPM event ID which is raised for sorting is FPM_SORT_TREE_COLUMN.

• Sorting with the New C-Table:

  The feeder class, using method GET_DEFINITION, parameter FIELD_DESCRIPTION, and attribute ALLOW_SORT, determines which columns are available for sorting.

  There are two attributes in method GET_DEFINITION, parameter ES_OPTIONS:

  • ALLOW_MULTI_COL_SORT

    When this attribute is set to TRUE, the personalization dialog box enables the user to sort according to more than one column. It is recommended to set this attribute to TRUE although the default is FALSE (for compatibility reasons).

  • ALLOW_SORT_PERSONALIZATION

    When this attribute is set to TRUE, the Personalization dialog box displays a Sorting tab. The recommended value is also TRUE.

    Whether the sort feature is available or not is also determined by the configuration (General Settings panel in FLUID). Sorting is available only when the feeder class, and the configuration, allow it.

    At runtime, when a user triggers sorting, the following FPM event is raised: IF_FPM_GUIBB_TREE=>GC_EVENT_APPLY_RULES. The feeder class retrieves the current sort rule in the feeder class method GET_DATA. The parameter, IO_SERVICE_INFO, of type IF_FPM_TREE_SERVICE_INFO. Note that sort rules can be persisted by using the Personalization dialog box. That means that, even at startup, it is possible that sort rules already exist; this makes it necessary to use parameter IO_SERVICE_INFO to check for this first.

• One-Click Actions

  One-click actions are available in this component. For more information on one-click actions, see the section on the List ATS Component.

• Personalization Dialog Box

  This is available only to components that are created in SAP NetWeaver 7.0 EHP3/7.31 SP4 onwards (which use the WD ABAP C-Table). For more information, see the documentation under this heading under the List ATS Component. However, note that this dialog box contains a restricted set of features for the Hierarchical List Component.