Combo Boxes in the Shuffler (SAP Library - ALV Grid Control (BC-SRV-ALV))

Combo Boxes in the Shuffler

Use

You can display a shuffler above the list output of the MiniALV which you can use to output combo boxes that allow users to choose from different list variants.

Two shuffler modes are available:

A mode to choose a saved selection variant or a saved layout. In this case, the service parameter seltype is set to V (default setting).

A mode to restrict the available selection variants or layouts or to fill the combo boxes displayed with application-specific entries. In this case, the service parameter seltype is set to P .

Integration

If you want to allow the user to choose freely from saved selection variants or layouts, no further steps are required.

Caution

If you want to display the report with a default variant in the MiniALV, read the section Proxy Report Variants.

In order to restrict the selection variants available (you cannot restrict layouts) or to freely define the shuffler, set the service parameter selectiontype to P and assign the name of a function module to the service parameter userfb . This function module is a callback function module to restrict the values of the shuffler or completely redefine it.

Activities

Copy the function module WWW_USER_SETTINGS_FB_TEMPLATE which you can use as a template for your callback function module. Basically, the function module uses two tables and a structure to define the shuffler:

Caution

Web add-on applications must use the function module WWW_USER_SETTINGS_FB_TEMPL_WAO as a template.

Interface parameter	Meaning
Table Selection_Catalog	Definition of a combo box in the shuffler
Table Selection_Data	Definition of entries for a combo box in the shuffler based on the input fields on the selection screen
Structure Shuffler_info	Information about texts in the shuffler

To set up the shuffler, proceed as follows:

Define a loop over your application table to get the value set that you want to display in a combo box.

Fill the table Selection_Data with these entries. The field EINDEX determines the position of the entry in the combo box.

Fill the table Selection_Catalog and refer to the entries in Selection_Data . To do this, use the field ID . You can use the field NAME to define the reference to the input field on the selection screen. Any value for NAME must be in upper case, have the same name as the screen field and exist in the report. In case of unknown input fields, the shuffler may not be displayed at all. If you set the field TYPE to 'H' , you can hide combo boxes to preassign values to specific input fields.

Note

If you define multiple combo boxes in the shuffler, the values of the ID field for each combo box in Selection_catalog must be sorted in ascending order and be without gaps.

Fill the structure Shuffler_info .

Note

If you want to restrict only the selection variants available, you must only adjust the values in Selection_Data .

See also the report SALWP_ADD_MONITOR_SELECTION which is an example of a callback function module for the service CCMS_ALVIEWER (only in the standard).