Fonction SAP BKK_PA_DISP_SHLP_EXIT_SERVER - Example of a Search Help Exit for a Search Help

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
CALLCONTROL DDSHF4CTRL u 108 Control of F4 Process
SHLP SHLP_DESCR_T 0 Individual (Current) Search Help

Paramètre Reférence Long. Facultatif Description
RECORD_TAB SEAHLPRES 1016 Hit List
SHLP_TAB SHLP_DESCR_TAB_T 0 Table of Elementary Search Helps

Functionality
This function module is used only as an example for the interface andthe layout of search help exits insearch helps.
All the interface parameters defined here are required for a functionmodule that is to be used as a search help exit. This is because themodule caller does not know which parameters are used internally.
A search help exit is called up for multipleeventsduring the process flow of the F4. Each flow step is specified inthe CALLCONTROL-STEP. If the function module wants to make only a fewmodifications before the step, the CALLCONTROL-STEP must not be changed.
If, however, the step is completely transferred by the module, thefollowing step must be returned in CALLCONTROL-STEP.
See the comprehensive documentation on the concept of the search helpexit for more information.
The module must respond to all steps that it does not know, or that itdoes not want to process with an immediate EXIT.

Description
Current search help typeSHLP_DESCR_T.
For event SELONE, the search help assigneddirectly to the field is transferred. This may entail a collectivesearch help. The associated elementary search helps are located inSHLP_TAB. For all other timepoints, the elementary search help istransferred that was either selected in the dialog or that was directlyassigned to the field at the beginning.

Description
When the data selection is transferred by the search help exit (stepSELECT), the hit list must be returned in this table in the internaldisplay.
When the data display is transferred by the search help exit (stepDISP), the hit list is transferred to this table in the internaldisplay.

Description
This table is of particular relevance to the SELONEevent (selection of an elementary searchhelp with multiple options).
It contains the complete description of an elementary search help ineach line (line category isSHLP_DESCR_T). You can restrict thenumber of elementary search helps by adapting SHLP_TAB. You can normallyretain SELONE as the next step. The user is then offered the restrictedquantity of elementary search helps for selection.
The corresponding collective search help is provided for the SELONE evenin the SHLP parameter.
Only if the SELONE event has more than one entry in SHLP_TAB, and theselection dialog box is not to be displayed, should you change the nextstep to PRESEL1. The search help to be used then needs to be transferredfrom SHLP_TAB to SHLP in advance.