Kontakt

Ansicht
Dokumentation

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

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

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

Functionality

This module can be used as a search help exit of an elementary search help, which describes the input help process, described by a domain. This process can also be modified by the attributes of search help. You must create an individual search-help exit in order to realize the more complex modifications, where this module is called.

The input help process of a domain is defined by its fixed values and its data type. In case the domain has fixed values, these are displayed by the input help along with its possibly available brief descriptions. Otherwise, only one input help is assigned to the domain if it is of data type DATS or TIMS. There are standardized input helps for these data types.For controlling the input help process, elementary search help can have up to three parameters, which must

have the names DOMNAME, VALUE and TEXT. At least one of both the parameters VALUE and TEXT must exist and be an EXPORT parameter.

Parameter DOMNAME can be used in order to determine the name of the concerned domain. In case this module is called in a search help exit, then it can be informed about the domain name even via its IMPORTING parameter DOMNAME. In case both of these mechanisms are not used, then the domain of the data element is automatically used, which was assigned to the parameter VALUE. In case even the parameter VALUE was not defined, or in case the determined domain does not have any input help, then the exception NO_F4_HLP is triggered along with a suitable message.

The actual values defined by the domain are handled in the parameter VALUE. The fixed value texts for these values are handled in the parameter TEXT. Thus this parameter is meaningless for standardized input helps for data types DATS and TIMS.

If you want to still modify the list of fixed values (including its texts), call this module twice in an individual search help exit whereby you name DD07V_TAB respectively while calling. You can still influence the fixed value list by modifying DD07V_TAB during calls. Otherwise you should leave DD07V_TAB unattended while calling.

Example

Fixed value help of domain S_CLASS should be displayed for a field, where flight classes can be entered. However, the first class (fixed
value 'F') should not be offered. You can realize the desired input help with the help of an elementary search help. This search help should have two EXPORT parameters, which must have the names VALUE and TEXT. One data element must be assigned to the parameter VALUE, which points to the domain S_CLASS (preferably the one, which also types the field on the input screen). You should assign data element VAL_TEXT to the parameter TEXT. Further, you should assign items 1 and 2 on the hit list to parameters VALUE and TEXT. Finally, you must assign a search help exit, containing following source text, to the search help:

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 must then attach the defined search help to the screen field, whereby the parameter VALUE should be assigned to the screen field (which should thus also be the IMPORT parameter).

Notes

  1. The definitions in the above example do not lead to a situation, where the value 'F' is declined by the input validation of the corresponding field. You must define such a check in the flow logic of the corresponding dynpro. In case the input field on the screen is nevertheless displayed as alistbox, the user can automatically select from the number of values, which are offered by the input help.
  2. You can also extend the above example in such a manner that the fixed values are limited only if another field (e.g. 'Airline) has a specific content (e.g. 'LH'). Hereby, you must extend the search help by one IMPORT parameter 'Airline', which you want to link with the corresponding screen field while linking.
    In search help exit, you can ascertain the airline entered by the user with the help of function module F4UT_PARAMETER_VALUE_GET. Finally, you can carry out the above- mentioned deletion from DD07V_tab depending upon the thus determined value.
  3. This module can also be used to display only fixed value texts for a field in an input help and hide the actual fixed values. Generally, it is suitable for these purposes to display the corresponding input field as listbox.

Further information





Parameters

CALLCONTROL
DOMNAME
RECORD_TAB
SHLP
SHLP_TAB
VALUE

Exceptions

NO_F4_HLP

Function Group

CACS_MAP_F4

General Data in Customer Master   ROGBILLS - Synchronize billing plans  
This documentation is copyright by SAP AG.

Length: 6002 Date: 20240523 Time: 052057     sap01-206 ( 96 ms )