✒️ABAP / La pantalla de selección Por Yeny Yanes Bautista
ABAP La pantalla de selección
LA PANTALLA DE SELECCIÓN
1. Los parámetros de selección
Hasta ahora aprendimos a crearun reporte que procesa información e imprime por pantalla un determinado resultado, pero que sucede si queremos introducir algunas delimitaciones a nuestro programa, de modo que solo se ejecute para ciertos datos que el usuario introduzca en la pantalla. Para lograr esto deberemos crear una pantalla de selección
>>Pantalla de selección: Es un área dentro de los reportes en donde se especifican los parámetros de selección por los cuales se va a ejecutar el programa. Se utilizan para restringir el procesamiento y la salida de los datos y por lo general se escribe despues de la declaración de datos, dentro del include de declaración de datos<<
La pantalla de selección de un programa va a estar compuesta por parámetros de entrada de datos:
→ Los PARAMETER en los cuales el usuario podrá ingresar valores individuales.
→ Los SELECT-OPTIONS en donde el usuario podrá ingresar rangos de valores.
Para declarar un PARAMETER vamos a utilizar la palabra reservada PARAMETER seguida del nombre del parameter y su tipo:
PARAMETERS: p_fecha LIKE sy-datum.
p_nombre(10) TYPE c.
La longitud máxima que puede tener el nombre de un parámetro es de 8 posiciones. Si escribimos un nombre de parámetro de más de 8 posiciones entonces se producirá un error al momento de la activación
Si deseamos declarar en la pantalla de selección un sólo parámetro entonces utilizaremos la palabra reservada PARAMETER: y si deseamos declarar en la pantalla de selección más de un parámetro entonces utilizaremos la palabra reservada PARAMETERS:
Si a la derecha del parámetro de entrada aparece el icono correspondiente al matchcode esto significa que el parámetro tiene asociada una ayuda de búsqueda
Ejemplo: el campo sy-datum tiene asociada una ayuda de búsqueda
p_fecha y p_nombre son los nombres de los parámetros y nosotros queremos que se visualicen descripciones y no nombres técnicos.
Para ellos vamos a crear lo que llamamos textos de selección para cada uno de los parámetros de la pantalla de selección
Pasar a → Elementos de texto → Textos de selección
para cada uno de los parámetros introducimos las descripciones que mejor se adapten al propósito de cada parámetro.
Ejemplo: p_fecha → Fecha de pago
p_nombre → Nombre y apellido
Es importante tener en cuenta que para poder introducir los correspondientes textos de selección el programa en cuestión debe activarse previamente de lo contrario la columna Texto correspondiente a la solapa de selección aparecerá
Debemos tener presente que los textos de selección son un objeto más dentro de os objetos de ABAP que forman parte de un programa ABAP por lo tanto, así como los programas se activan, los textos de selección tambien deben activarse.
Existen algunas adiciones o agregados que podemos utilizar, los cuales son muy útiles, por ejemplo:
- El agregado de la cláusula OBLIGATORY hace que el parámetro sea obligatorio.
- El agregado de la DEFAULT asigna un valor por defecto al parámetro.
PARAMETERS: p_fecha LIKE sy-datum OBLIGATORY DEFAULT sy-datum,
p_nombre(10) TYPE c OBLIGATORY.
Dentro de los parámetros podemos tambien crear otros 2 tipos de parámetros de entrada:
Los Checkbox que permiten a usuario tildar las opciones que prefiera dentro de un grupo de opciones disponibles
Los Radiobutton en donde el usuario selecciona una de las opcions entre todas las existentes.
PARAMETERS: p_list AS CHECKBOX, "Emitir listado
p_arch AS CHECKBOX. "Generar archivo de salida
**Agregar textos de selección para los checkbox que se crean
Veamos ahora cómo se declaran los radiobutton:
PARAMETERS: p_arg RADIOBUTTON GROUP bot2, "Argentina,
p_chi RADIOBUTTON GROUP bot2, "Chilena,
p_col RADIOBUTTON GROUP bot2, "Colombiana,
p_esp RADIOBUTTON GROUP bot2, "Española,
p_otr RADIOBUTTON GROUP bot2. "Otra Nacionalidad.
**Agregar textos de selección para los radiobutton que se crean
Los SELECTION-OPTIONS son parámetros que nos permiten ingresar rangos de valores, es decir, un valor desde y un valor hasta, aparte de valores individuales. Para declarar un SELECTION-OPTION vamos a utilizar la palabra reservada SELECT-OPTIONS seguida del nombre del parámetro y su tipo tal como vemos en la siguiente imagen.
DATA_ v_clavep TYPE 1and1_gp.
SELECT-OPTIONS s_clavep FOR v_clavep. "Clave de país
**Agregar textos de selección para el select-options que se crean
<<La tabla base de datos KNA1 corresponde al maestro de clientes. De cada cliente que se guarda en SAP información tal como el número de cliente, el país, el nombre, el código postal y muchos otros datos más.>>
Frame o Marco se utilizan para encuadrar a los parámetros de la pantalla de selección. Para ello debemos colocar a la delcaración de los parámetros dentro de las siguientes sentencias:
SELECTION-SCREEN BEGIN OF BLOCK b1 WITH FRAME TITLE text-001.
SELECTION-SCREEN END OF BLOCK b1.
b1 es el nombre del marco
text-001 es el título que se visualizará en el extremo superior izquierdo del marco.
SELECTION-SCREEN BEGIN OF LINE b1.
SELECTION-SCREEN END OF LINE b1.
Se utiliza cuando deseamos colocar un texto de selección largo, el que se muestra a la izquierda del parámetro y su largo está bastante restringido entonces si tenemos que mostrar en pantalla un texto largo si o si tenemos que utilizar la sentencia SELECTION-SCREEN COMMENT 1(50)
AT SELECTION-SCREEN OUTPUT: Este evento se ejecuta antes de que se muestre la pantalla de selección y se utiliza para determinar de forma dinámica si mostramos o no mostramos un parámetro de la pantalla de selección,
Ejemplo: p_fecha <= sy-datum. Si se cumple la condición que la fecha ingresada por parámetro es menor o igual a la fecha del día entonces vamos a recorrer los campos de la pantalla y vamos a grisar el parametro v_nombre y tambien el texto que se muestra a izquierda de este parámetro.
Escanear / Compartir
Sobre el autor
Publicación académica de Yeny Gisela Yanes Bautista, en su ámbito de estudios para la Carrera Consultor ABAP Nivel Inicial.
SAP Senior
Yeny Gisela Yanes Bautista
Profesión: Ingeniera en Sistemas - Honduras - Legajo: XC34C
✒️Autor de: 46 Publicaciones Académicas
🎓Egresado de los módulos:
- Master Funcional ABAP
- Master ABAP for HANA
- Carrera Consultor ABAP Nivel Avanzado
- Carrera Consultor ABAP Nivel Inicial
Disponibilidad Laboral: FullTime 
