Skip to content

ABAP Keyword Documentation →  ABAP − Reference →  SAP GUI User Dialogs →  General Dynpros →  Field Help, Input Help, and Dropdown List Boxes 

Field Help

There are three ways of displaying field help for screen elements on dynpros:

Other versions: 7.31 | 7.40 | 7.54

Displaying the Documentation of the Data Element

If a screen element in Screen Painter was defined by taking a field from ABAP Dictionary, the documentation of the associated data element is displayed automatically when the F1 help is selected for this field (unless this step is overridden in the dynpro flow logic).

Displaying the Supplement Documentation of the Data Element

The documentation of some data elements has additional supplement documentation. Supplement documentation for a dynpro field is created in Screen Painter and not in ABAP Dictionary in ABAP Workbench. Here, the supplement documentation is defined for the data element using a number.

Supplement documentation of this type is specific to a program and to a dynpro. Any supplement documentation with the same number defined in ABAP Dictionary is overridden by any dynpro-specific supplement documentation. Supplement documentation defined in ABAP Dictionary can still be associated with a dynpro field in table THLPF. This requires a new row in table THLPF containing the program name, dynpro number, field name, and the number of the supplement documentation.

To be able to display the supplement documentation, the dynpro flow logic must respond to the POH event as follows:

PROCESS ON HELP-REQUEST.
...
  FIELD field [MODULE mod] WITH hlp.
  ...

Only FIELD statements are allowed after PROCESS ON HELP-REQUEST. If the flow logic of a dynpro does not contain the event keyword PROCESS ON HELP-REQUEST, F1 displays either the data element documentation of the field with the cursor or no help documentation is displayed. In other cases, the following FIELD statement is executed whose field field has the cursor.

If dynpro-specific supplement documentation exists for the field field, this is displayed by its number hlp being specified. A variable hlp can be filled before the help is displayed, for example, by calling the dialog module mod. At the event PROCESS ON HELP-REQUEST, the FIELD statement does not, however, transport the content of the dynpro field field to the ABAP program.

Calling Help Texts in Dialog Modules

Any help text can be displayed by calling dialog modules at POH:

PROCESS ON HELP-REQUEST.
  ...
  FIELD field MODULE mod.
  ...

After PROCESS ON HELP-REQUEST, the MODULE statement can only be used in combination with the FIELD statement. When F1 is selected, the dialog module mod of the FIELD statement whose field field has the cursor. If multiple FIELD statements are specified for the same field field, only the first statement is executed. The dialog module mod does not provide the content of the dynpro field field, since this content is not transported by the FIELD statement at PROCESS ON HELP-REQUEST time.

The dialog module mod is defined like a regular PAI module in the ABAP program. The processing logic of the module must ensure that adequate help is displayed for the field in question. Function modules such as HELP_OBJECT_SHOW_FOR_FIELD or HELP_OBJECT_SHOW can be used to do this.

Executable Example

Field Help