Ansicht
Dokumentation

/DSCSAG/F4_VALUES_GET - Wrapper to call search help for field

/DSCSAG/F4_VALUES_GET - Wrapper to call search help for field

BAL Application Log Documentation   Fill RESBD Structure from EBP Component Structure  
This documentation is copyright by SAP AG.
SAP E-Book

Functionality

This module permits the implementation of the standard help for a screen field whose reference to the ABAP Dictionary is only known at runtime.

If the module is called at the time PROCESS ON VALUE REQUEST, it behaves just like the standard help.

The reference to the ABAP Dictionary is needed in the form of the table and field names as input.

The module then determines the search help defined directly or indirectly in the Dictionary (e.g. also domain fixed values). If several parameters of the search help are linked with the Dictionary table or structure, the additional fields are searched for on the screen, as for the standard help, and the parameters are given their contents. The standard F4 process is then started. Depending on the user settings, this can also be implemented with the input help Control.

In addition to specifying the table and field names, you have the following alternatives:

  • Parameter TABNAME is assigned a data element (type). FIELDNAME is empty.
  • The search help (SEARCHHELP) is specified directly. In this case you should also pass the search help parameter (SHLPPARAM), which is used as return parameter. (For reasons of compatibility, you can also define only SEARCHHELP. In this case the first parameter of the search help is used as default for SHLPPARAM.)

If the screen information DYNPPROG, DYNPNR, DYNPROFIELD and possibly STEPL is also specified, the selected value is automatically stored in the screen field. Further export parameters are also stored there if they are found as input fields on the screen.

If the user activated the ActiveX help, the help is started amodally under the following conditions:
1. The screen information DYNPROG, DYNPNR and DYNPROFIELD must be defined.
2. When the function module is called, the RETURN_TAB may not be specified. (If the call is amodal, the function module returns before the user has specified a value.)

Normally values are only returned in input fields. This behavior can be influenced with the parameter DISPLAY (see parameter documentation).

(At the moment it is not possible to determine if it is ready for input. Development or correction of the screen area is necessary).

Example

Notes

The input help key should only be activated in a screen field if there is actually an input help available. To find out if there is an input help for the Dictionary field, you can read the field information with module DDIF_NAMETAB_GET. Field F4AVAILABL in structure DFIES tells you if there is an input help available.

Previously you had to assign DYNPPROG and DYNNR the contents of SY-REPID and SY-DYNNR. However, for subscreens this information is not sufficient to uniquely define the screen. For reasons of compatibility the current screen is now determined internally as soon as DYNPPROG, DYNNR and DYNPROFIELD are passed and are not equal to SPACE. The actual contents are no longer important, but you are nevertheless advised to pass meaningful values to ensure the readability of the programs.

The value for STEPL is outside a step loop 0. The current row can be stored within a step loop at time POV with the function module DYNP_GET_STEPL.

If you do not want to return the selected value automatically, you should not define parameters DYNPROG and DYNNR. At the moment values are not returned if MULTIPLE_SELECTION is selected either, but this could change in the future.

Further information

Note that documentation about some of the parameters is also available.





Parameters

DISPLAY
ET_DESCRIPTION
ET_RETURN
EV_SEARCHHELP
FIELDNAME
IV_CLIENT_VERSION
IV_GET_VAL_DESCR
MULTIPLE_CHOICE
ONLY_ASKD_FIELD
RETURN
RUNTIME
SEARCHHELP
SHLPPARAM
SUPPRESS_RECORDLIST
TABNAME
VALUE
VALUES
VERSION_ID

Exceptions

Function Group

SAG/SAPLUTILS

ABAP Short Reference   General Data in Customer Master  
This documentation is copyright by SAP AG.

Length: 4653 Date: 20240329 Time: 012635     sap01-206 ( 120 ms )