Show TOC

Defining Field HelpLocate this document in the navigation structure

Use

If the data type of an input field declared in an executable program is defined in the ABAP Dictionary, the documentation of the underlying data element is automatically displayed if the user positions the cursor in that field and presses F1. To create help for input fields that have no Dictionary reference, or to override the help normally linked to the field, you can create an event block for the event

AT SELECTION-SCREEN ON HELP-REQUEST FOR field

The event is triggered when the user calls the F1 help for the field field . If no corresponding event block has been defined, the help from the ABAP Dictionary is displayed, or none at all if the field has no Dictionary reference. If a corresponding event block exists, it takes precedence over the default help mechanism. It is then up to the programmer to ensure in the event block that appropriate help is displayed to the user.

No event block AT SELECTION-SCREEN ON HELP-REQUEST can be created for input fields of the selection screen that are declared within the logical database used. You cannot override the help mechanism of the logical database within the executable program. You can define separate help within the logical database program using the HELP-REQUEST option in the PARAMETERS and SELECT-OPTIONS statements.

        
REPORT demo_selection_screen_f1.
        
PARAMETERS: p_carr_1 TYPE s_carr_id,
        
p_carr_2 TYPE spfli-carrid.
        
AT SELECTION-SCREEN ON HELP-REQUEST FOR p_carr_2.
        
CALL SCREEN 100 STARTING AT 10 5
        
ENDING AT 60 10.

This program declares a selection screen with two parameters that both refer to the data element S_CARR_ID in the ABAP Dictionary. The documentation from the Dictionary is used for p_carr_1 , and a help screen 100 is called for P p_carr_2 . The help screen is defined in the Screen Painter as a modal dialog box with next screen 0. It contains the help text defined as help texts. The screen does not require any flow logic.