Show TOC

 Value Transport for Input HelpsLocate this document in the navigation structure

Use

There is a value transport between the field contents on the screen and the interface of the search help when you call the input help and when you select a line of the hit list. The values that you have already entered on the screen are used as restrictions for a selection from the hit list.

Note

The system displays only those hits that are consistent with the values that you have already entered on the screen.

Features

To explain better the specificity of the value transport, we examine the following example. In this example, screen fields A, B and C are linked with parameters of the search help. As a result, values can be transported only between the screen and the search help for these three fields. You can use existing contents of screen fields A and B to select the hit list since these fields 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 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 or directly on the screen, only one search help parameter is assigned to this field. The value transport can take place only between the screen field and this parameter.

If the search help is attached to the table field or to the check table of the field, 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 on the screen for each import parameter of the search help that is attached to a table or structure field. If a field referencing this table or structure field is found, the content of the screen field is copied to the search help parameter.

There are at most four steps when searching for the screen field with the same name:

  1. If the input help is called in a step loop, the system searches for a field with the same name in this step loop.
  2. If the step loop does not contain a field with the same name, the corresponding subscreen is searched.
  3. If the subscreen does not have a field with the same name, the main screen is searched.
  4. If the main screen does not contain a field with the same name either, the module pool of the corresponding screen is searched.

You can see these four steps in the figure below.

Returning the Values from the Hit List

Values are only returned at the level where the input help was called. For example, if the input help is called within a step loop, the values are only returned from the hit list in fields of the corresponding line of this step loop.

Caution

The system does not return values from the hit list to the module pool of the screen.

The values of the hit list are returned only in input fields and in fields that are linked to only one export parameter of the search help (used to parametrize pure text fields that are not used in the selection).

See also:

Assignment of a Search Help to Data Element

Assignment of a Search Help to a Check Table

Assignment of a Search Help to a Table Field or Structure Field

Direct Assignment of a Search Help to a Screen Field