Screen Selection
Selection Parameters
The selection screen is an area within reports where the selection parameters are specified for program execution. It is used to restrict data processing and output, usually written after the data declaration, within the include data declaration.
There are essentially two types of parameters:
- PARAMETERS: Allows the user to input individual values.
PARAMETERS: p_parameter TYPE c. "Input parameter example
- SELECT-OPTIONS: Enables the user to input value ranges.
SELECT-OPTIONS s_date FOR sy-datum. "Date range input example
Note: The maximum length for a parameter name is 8 characters.
To avoid displaying the technical name of the PARAMETER, PARAMETERS, or SELECT-OPTIONS during program execution, we create a selection text. Navigate to "Go to" → "Text Elements" → "Selection Texts" to assign a descriptive text.
There are additional specifications for parameters, such as:
- OBLIGATORY: Makes the parameter mandatory.
PARAMETERS: p_date LIKE sy-datum OBLIGATORY DEFAULT sy-datum.
- DEFAULT: Assigns a default value to the parameter.
PARAMETERS: p_name TYPE c OBLIGATORY DEFAULT 'DefaultName'.
Within PARAMETERS, we can also create two types of input parameters:
- Checkbox: Allows the user to check preferred options within a group.
PARAMETERS: p_check AS CHECKBOX. "Checkbox input example
A checkbox group can be created for multiple options:
PARAMETERS: p_option1 AS CHECKBOX,
p_option2 AS CHECKBOX DEFAULT 'X',
p_option3 AS CHECKBOX.
- Radiobutton: The user selects one option from all available options.
PARAMETERS: p_option RADIOBUTTON GROUP grp1. "Radiobutton input example
A radiobutton group with options:
PARAMETERS: p_radio1 RADIOBUTTON GROUP grp2,
p_radio2 RADIOBUTTON GROUP grp2 DEFAULT 'X',
p_radio3 RADIOBUTTON GROUP grp2.
SELECT-OPTIONS parameter type, is the one that allows inputting ranges of values. Declaration example:
SELECT-OPTIONS s_key FOR v_key. "Select-options input example
As mentioned earlier, the technical name can be modified, and the OBLIGATORY addition can be applied.
Note: The KNA1 table is a standard database corresponding to the Customer Master, containing information such as customer number, country, name, postal code, and more.
The BLOCK is a frame that allows the grouping of the parameters in the selection screen:
SELECTION-SCREEN BEGIN OF BLOCK b1 WITH FRAME TITLE text-001.
...
SELECTION-SCREEN END OF BLOCK b1.
Here, b1 is the name of the frame, and text-001 is the title displayed at the upper-left corner of the frame. Clicking on text-001 allows adding text to text element 001.
E.g.
*&---------------------------------------------------------------------*
*& Report ZTEST_ABAP_JEGA_6
*&---------------------------------------------------------------------*
*&
*&---------------------------------------------------------------------*
REPORT ztest_abap_jega_6.
* Declaración de Tablas y variables
DATA: v_carrid(3) TYPE c,
v_connid(4) TYPE c.
* Pantalla de selección
SELECTION-SCREEN BEGIN OF BLOCK b1 WITH FRAME TITLE TEXT-001.
PARAMETERS: p_carrid LIKE v_carrid. "Compañía aérea
SELECT-OPTIONS: s_connid FOR v_connid. "Código de vuelo
SELECTION-SCREEN END OF BLOCK b1.
*----------------------------------------------------------------------*
AT SELECTION-SCREEN.
*----------------------------------------------------------------------*
IF p_carrid IS INITIAL OR s_connid-low IS INITIAL.
MESSAGE e001(z_prueba) WITH 'Debe completar los parámetros'.
ENDIF.
*----------------------------------------------------------------------*
START-OF-SELECTION.
*----------------------------------------------------------------------*
WRITE:/ 'Compañía aérea: ', p_carrid.
WRITE:/ 'Código de vuelo desde: ', s_connid-low.
WRITE:/ 'Código de vuelo hasta: ', s_connid-high.