SELECTION-SCREEN

Special additions in the selection include of the logical database

You can only use the additions described here in the selection include of the logical database ldb. Some are optional, some are required.

Extras:

1. ... FOR NODE node

2. ... FOR TABLE dbtab

3. ... ID selid

Addition 1

... FOR NODE node

Addition 2

... FOR TABLE dbtab

Effect

These additions assign an object defined in a SELECTION-SCREEN to a node node dbtab of the logical database ldb. If the node has type T (table), you can use either FOR TABLE or FOR NODE. With other node types, you must use FOR NODE.
This assignment is necessary, so that only the relevant SELECTION-SCREEN statements are used to form the selection screen of the report. These are the statements that refer to a node used in the report. SELECTION-SCREEN statements in the selection include, that are assigned in the FOR TABLE dbtab or FOR NODE node additions to nodes that are not used in the report are ignored when the system constructs the selection screen for the report.

Note

A node in the logical database ldb is considered to be "used in the report" if it is declared in the report using the NODES statement (or using the TABLES statement for nodes with type T). It is also "used" if it is on the path from the root of the database hierarchy to a node node_2 that is declared in the report.

Example

Hierarchy of the logical database ldb:

SPFLI
|
---- SAPLANE
|
---- SFLIGHT
|
---- SBOOK

In the report:

TABLES SFLIGHT.

The following nodes are "used": SFLIGHT (because it is directly declared), and SAPLANE and SPFLI (because they are on the path from the root of the hierarchy SPFLI to the declared table SFLIGHT. SBOOK counts as "unused". This means that any SELECTION-SCREEN statements in DBldbSEL with the addition FOR TABLE SBOOK are ignored.

Notes

1. In the following variants, you must use either FOR NODE node or FOR TABLE dbtab within DBldbSEL:
   - ... POSITION
   - ... ULINE
   - ... PUSHBUTTON
   - ... SKIP
   
2. With ... COMMENT, you must use either the FOR NODE node, the FOR TABLE dbtab or the FOR FIELD addition.
   
3. You may not use FOR NODE node or FOR TABLE dbtab with:
   - ... BEGIN OF BLOCK
   - ... BEGIN OF LINE
   Instead, the (select-options, parameters, comments, underlines ...) contained in the block or line are omitted from the selection screen if their associated table is not used in the report. If this results in an empty block or line, these are suppressed (along with any frames belonging to empty blocks).
   
   

Addition 3

... ID selid

Effect

This addition identifies a SELECTION-SCREEN object (such as a comment, underline or blank line) using an ID of up to three characters. You can then enter this ID in the SELECTION-SCREEN EXCLUDE IDS id statement to exclude the object from a selection screen version.

Notes

1. This addition is optional. You only need it for the variant SELECTION-SCREEN EXCLUDE IDS id.
   
2. You can use ID id with the following variants:
   - ... COMMENT
   - ... ULINE
   - ... PUSHBUTTON
   - ... SKIP
   - ... FUNCTION KEY
   _ ... INCLUDE
   - ... DYNAMIC SELECTIONS
   - ... FIELD SELECTION
   
3. To exclude a block, use SELECTION-SCREEN EXCLUDE BLOCKS block.
   
   

Additional help

Processing Selections