PARAMETERS - ldb_options
Short Reference
ABAP Syntax(Obsolete) ... FOR {TABLE|NODE} node
[HELP-REQUEST]
[VALUE-REQUEST]
[AS SEARCH PATTERN] ... .
ABAP_ADDITIONS:
1 ... FOR {TABLE|NODE} node
2 ... HELP-REQUEST
3 ... VALUE-REQUEST
4 ... AS SEARCH PATTERN
What does it do? These additions for the statement
PARAMETERS are only possible in the
selection include of a logical
database . They must be used to assign a node in the logical database
to the parameter. Subroutines for self-defined helps can be called and a
special parameter can be defined for evaluating the search help
associated with the logical database.
Latest notes: If logical databases are no longer created, then these
additions of the statement PARAMETERS no longer need to be used
either.
ABAP_ADDITION_1 ... FOR {TABLE|NODE} node
What does it do? With this addition, the parameter has to be assigned to a
node of the structure of the logical database. If a node belongs
to type T , the addition TABLE can be used instead of
NODE . For a description of the node types, see the
NODES statement.
When the selection screen of an
executable program associated with
the logical database is generated, input fields are created only for
those parameters for which an
interface work area for the assigned node (or a node beneath
it in the hierarchy) is declared using NODES or
TABLES in the executable program. When using the function
module LDB_PROCESS , the assigned node node must be
requested so that the parameter appears on the selection screen.
ABAP_ADDITION_2 ... HELP-REQUEST
What does it do? This addition specifies that the para_hlp
subroutine ( para is the name of the parameter) of the
database program of the logical
database is called if the user selects the F1 field help for a
screen element of the parameter on the selection screen. If the
subroutine is not available, the addition is ignored.
If the parameter is defined in ABAP Dictionary with a reference to a
data type, the field help that is defined there is not displayed.
Latest notes: In the called subroutine, the field help display can be
programmed or called using suitable function modules, such as
HELP_OBJECT_SHOW . If the input help is selected, no other
selection screen events can be
triggered and there is no automatic pass by value between the selection
screen and the program.
ABAP_ADDITION_3 ... VALUE-REQUEST
What does it do? This addition specifies that the para_val
subroutine ( para is the name of the parameter) of the
database program of the logical
database is called if the user selects the F4 input help on a
screen element of the parameter on the
selection screen . The input help key is displayed for the input field
of the parameter on the selection screen. If the subroutine is not
available, the addition is ignored.
If the parameter is defined in ABAP Dictionary with a reference to a
data type, the input help that is defined there is not displayed.
Latest notes: In the called subroutine, the input help display can be
programmed or called using suitable function modules such as
F4IF_INT_TABLE_VALUE_REQUEST . If the input help is selected, no other
selection screen events are triggered and there is no automatic pass by
value between the selection screen and the program. Suitable function
modules must be used for this, as with general
dynpros . The parameter that is changed in the subroutine is
transported to the selection screen.
ABAP_ADDITION_4 ... AS SEARCH PATTERN
What does it do? This addition enables a search help to be evaluated in
the database program . To do this,
the logical database has to be assigned to a search help in transaction
SE36 . Except for the mandatory addition FOR
TABLE|NODE , the AS SEARCH PATTERN addition can only be
combined with the MODIF ID
addition. In particular, a type cannot be defined with the addition
TYPE .
The data type of the parameter is the internal table SYLDB_SP
from the type group
SYLDB . This table has three
columns: HOTKEY (search help ID), STRING (search string),
and TRANGE ( deep data type for complex
search helps). The selection screen
displays an outlined block with the title "Selection using search help",
which contains input fields for the search help ID and the search string
as well as a pushbutton for complex search helps.
After the selection screen has
been processed , the list of values provided by the search help is
available in the internal table ldb_SP in the database program.
Instead of the PUT_root subroutine, the PUT_ldb_SP
subroutine is called. Here, "ldb" is the name of the logical
database and "root" is the name of the root node. This subroutine
can read the actual data using the list of values in ldb_SP and
can then call the PUT_root subroutine, where the
GET root event is triggered by the PUT root
statement.
Note
See also Logical Databases - Associations with
Search Helps .
Documentation extract taken from SAP system, � Copyright SAP AG. All rights reserved