Value Transport for Input Helps
There is a value transport between the field contents on the screen and the interface of the search help when the input help is called and when a line of the hit list is selected. The values already entered on the screen can then be used as restrictions for a selection from the hit list. Only those hits that are consistent with the values already entered are displayed.
In the above example, screen fields A, B and C are linked with parameters of the search help. As a result, values can only be transported between the screen and the search help for these three fields. Existing contents of screen fields A and B can be used for selecting the hit list since they are linked with an import parameter of the search help. The values of parameters A and C can be returned to the screen from the hit list since these parameters are declared as export parameters of the search help.
Parametrizing the Import Parameters of the Search Help
If the search help is attached to the screen field with a data element (
Attaching to Data Elements) or directly in the screen ( Attaching to Screen Fields), only one search help parameter is assigned to this field. The value transport can only take place between the screen field and this parameter.If the search help is attached to the table field (
Attaching to Table Fields) or to the check table of the field ( Attaching to Tables), a value transport can take place for all the screen fields that are linked with a parameter of the search help.When the input help is called, the system tries to find a field with the same name on the screen for each import parameter of the search help that is attached to a table or structure field. If such a field is found, the contents of the screen field are copied to the search help parameter.
There are at most four steps when searching for the screen field with the same name:
Returning the Values from the Hit List
Values are only returned at the level where the input help was called. If the input help is called for example within a step loop, the values are only returned from the hit list in fields of the corresponding line of this step loop. In particular, values are never returned from the hit list to the module pool of the screen.
The values of the hit list are only returned in input fields and in fields that are only linked with an export parameter of the search help (used to parametrize pure text fields that are not used in the selection).