Ansicht
Dokumentation

F4UT_DOMAHLP_EXECUTE - Standard search help exit for simulating the input help of a domain

RFUMSV00 - Advance Return for Tax on Sales/Purchases   BAL_S_LOG - Application Log: Log header data  
This documentation is copyright by SAP AG.

Functionality

This module can be used as a search help exit of an elementary search help that describes the input help process described by a domain. This process can be modified by the attributes of the search help. To implement more complex modifications, you might have to create your own search help exit that calls this module.

The input help process of a domain is defined by its fixed values and data type. If a domain has fixed values, these are displayed by the input help together with any short descriptions. Otherwise the domain is only assigned an input help if it has data type DATS or TIMS. There are standardized input helps for these data types.

To control the input help process, the elementary search help can have up to 3 parameters that must be named DOMNAME, VALUE and TEXT. At least one of the two parameters VALUE and TEXT must exist and also be an EXPORT parameter.

Parameter DOMNAME can be used to define the name of the domain. If this module is called in a search help exit, the name of the domain can also be passed in its IMPORTING parameter DOMNAME. If neither mechanism is used, the domain of the data element assigned to parameter VALUE is automatically used. If parameter VALUE was not defined either or if the domain does not have an input help, the exception NO_F4_HLP is triggered together with a message.

Parameter VALUE contains the values actually defined by the domain. Parameter TEXT contains the fixed value texts for these values. This parameter is threfore meaningless for the standardized input helps for data types DATS and TIMS.

If you want to modify the list of fixed values (including their texts), call this module in a separate search help exit twice, specifying DD07V_TAB in the call. You can change the fixed value list between the calls by modifying DD07V_TAB. Otherwise you should leave DD07V_TAB undefined in the call.

Example

You want to display the fixed value help of domain S_CLASS for a field in which flight classes can be entered, but the first class (fixed value 'F') should not be offered. You can implement the required input help with an elementary search help. This search help should have two EXPORT parameters with the names VALAUE and TEXT. A data element pointing to domain S_CLASS (preferably also defining the type of the field in the input template) must be assigned to parameter VALUE. You should assign data element VAL_TEXT to parameter TEXT. Assign positions 1 and 2 to parameters VALUE and TEXT in the hit list. Also assign the search help a search help exit containing the following source text:

DATA DD07V_tab TYPE STANDARD TABLE OF DD07V.
CHECK CALLCONTROL-STEP = 'SELECT'.
CALL FUNCTION 'F4UT_DOMAHLP_EXECUTE'
TABLES
SHLP_TAB = SHLP_TAB
RECORD_TAB = RECORD_TAB
DD07V_TAB = DD07V_tab
CHANGING
SHLP = SHLP
CALLCONTROL = CALLCONTROL
DELETE DD07V_tab WHERE DOMVALUE_L = 'F'
CALL FUNCTION 'F4UT_DOMAHLP_EXECUTE'
TABLES
SHLP_TAB = SHLP_TAB
RECORD_TAB = RECORD_TAB
DD07V_TAB = DD07V_tab
CHANGING
SHLP = SHLP
CALLCONTROL = CALLCONTROL.

You still have to link the search help defined in this way to the screen field, whereby you should assign parameter VALUE to the screen field (it should therefore also be IMPORT parameter).

Notes

1. The definitions made in the above example do not ensure that value 'F' is rejected by the input check of the corresponding field. You have to store such a check yourself in the flow logic of the corresponding screen. If the input field in the template is represented as a list box, the user can automatically only select one of the values offered by the input help.
2. You can enhance the above example so that the fixed values are only limited if another field (e.g. 'Carrier') has certain contents (e.g. 'LH'). In this case the search help must be enhanced with another IMPORT parameter 'Carrier' that you have to link with the corresponding screen.
   With the function module F4UT_PARAMETER_VALUE_GET you can define the carrier entered by the user in the search help exit. In this way you can make the above deletion from DD07V_tab dependent on the value determined.
3. You can also use this module to display only the fixed value texts for a field in an input help and to suppress the actual fixed values. In general, however, it will be better to represent the corresponding input field as a list box.

Further information

Parameters

CALLCONTROL
DD07V_TAB
DOMNAME
RECORD_TAB
SHLP
SHLP_TAB

Exceptions

NO_F4_HLP

Function Group

SF4U

ABAP Short Reference   BAL Application Log Documentation  
This documentation is copyright by SAP AG.

Length: 5618 Date: 20240604 Time: 062924     sap01-206 ( 133 ms )