UNIDAD 2: DECLARACIÓN Y PROCESAMIENTO DE DATOS
LECCIÓN 8: PANTALLA DE SELECCIÓN
1) Parámetros de selección
Si queremos introducir algunas delimitaciones a nuestro programa de modo que nuestro reporte (tipo de programa ABAP donde generalmente existe una pantalla de selección donde se ingresan ciertos parámetros) solo se ejecute para ciertos datos que el usuario deberá introducir en la pantalla entonces 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 utiliza para restringir el procesamiento y la salida de los datos. Por lo general se coloca después de la declaración de datos.
Dentro de una pantalla de selección se pueden declarar dos tipos de objetos:
PARAMETER: en los cuales el usuario podrá ingresar valores individuales.
SELECT-OPTIONS: en donde el usuario podrá ingresar rangos de valores.
En el siguiente ejemplo declaramos los parámetros P_FECHA y P_NOMBRE.
AUDIO: Si deseamos declarar en la pantalla de selección un solo parámetro, entonces utilizaremos la palabra reservada PARAMETER. Si deseamos declarar en la pantalla de selección más de un parámetro, entonces utilizaremos la palabra reservada PARAMETERS: tengamos en cuenta que podemos también utilizar PARAMETERS y declarar un solo parámetros, o también declarar varios parámetros en la pantalla de selección y para cada uno de ellos escribir en la izquierda la palabra reservada PARAMETER.
NOTA: La longitud máxima que puede tener el nombre de un parámetro es de 8 posiciones.
El agregado de la cláusula OBLIGATORY hace que el parámetro sea obligatorio.
El agregado de la cláusula DEFAULT asigna un valor por defecto al parámetro. Si ejecutamos nuestro reporte veremos lo siguiente:
Lo que vemos es que al ejecutar nuestro reporte nos aparece la pantalla de selección que acabamos de crear. Vemos que a la derecha de la fecha nos aparece el icono.
Si presionamos sobre el ícono o presionamos F4 dentro del campo fecha, se abrirá la siguiente ventana:
Aquí estamos viendo la ayuda de búsqueda asociada al campo SY-DATUM el cual es el tipo de nuestro parámetro.
Ahora vamos a cambiar las descripciones de los parámetros que aparecen en la pantalla. Para esto vamos a ir a:
PASAR A/ELEMENTOS DE TEXTO/TEXTOS DE SELECCIÓN
E ingresamos las descripciones que mejor se adapten a nuestro propósito.
AUDIO: Es importante que para poder ingresar los textos de selección el programa en cuestión debe activarse previamente, de lo contrario la columna Texto correspondiente a la solapa Texto de selección aparecerá en gris.
Los cuales se visualizarán de la siguiente manera en pantalla:
Los SELECT-OPTIONS son iguales a los PARAMETER salvo que en ellos se puede ingresar rangos de valores, es decir un valor desde y un valor hasta, aparte de valores individuales.
En el siguiente ejemplo, declaramos el SELECT-OPTIONS S_CLAVEP.
De nuevo, si ejecutamos el reporte, a la derecha del campo Clave de país nos aparece el icono, si lo presionamos vemos la ayuda de búsqueda correspondiente al tipo LAND1_GP que es un tipo de la tabla KNA1.
Tabla KNA1: La tabla base de datos estándar KNA1 corresponde al Maestro de Clientes. De cada cliente 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.
Podemos crear un “MARCO” que encuadre a los parámetros de la pantalla de selección. Para ello, debemos colocar a la declaració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.
Donde b1 es el nombre del marco y text-001 es el título que se visualizará en el extremo superior izquierdo del marco.
2) Clases de Mensajes
Una vez que ingresamos todos los parámetros de nuestro reporte y ejecutamos el programa, lo que vamos a querer es que dependiendo de los parámetros introducidos se produzcan determinadas acciones.
Para analizar el contenido de los parámetros existe el evento AT SELECTION-SCREEN (evento de un reporte ABAP que se ejecuta después de finalizado el procesamiento de la pantalla de selección y que permite la validación de los parámetros introducidos). En este evento es donde se validan los valores ingresados en la pantalla de selección.
Supongamos que queremos que la fecha ingresada por pantalla sea mayor o igual a la fecha actual y que si no es así se emita un mensaje en la pantalla advirtiendo que el valor introducido es incorrecto. Para esto, vamos a tener que crear una Clase de mensajes (esta terminación se utiliza para representar diferentes formularios de mensajes en el sistema SAP) a través de la transacción SE91 tal como lo vemos a continuación:
Transacción SE91: La transacción estándar SE91 se utiliza para la creación, modificación y visualización de las clases de mensajes en SAP, las cuales nos permiten agrupar los mensajes que utilizaremos en una aplicación.
Le asignamos una descripción y grabamos.
Y creamos nuestro primer mensaje.
Luego en nuestro programa, escribiremos el código correspondiente en el evento AT SELECTION-SCREEN para cumplir con esta validación.
Por último, ejecutamos nuestro reporte con una fecha de la pantalla de selección anterior a la fecha actual y vemos el siguiente mensaje en el extremo inferior izquierdo de la pantalla.
AUDIO: Dentro de los mensajes que emitimos por pantalla podemos mostrar el contenido de variables, para ello utilizaremos el símbolo &, supongamos que tomamos el mensaje 000 de la clase de mensaje z_prueba que utilizamos anteriormente, el cual dice: “La fecha debe ser mayor o igual a la fecha actual” y deseamos que al final del mensaje se visualice la fecha del día actual. Entonces al final de dicho mensaje vamos a agregar un espacio y el símbolo &. Luego, tenemos que modificar la declaración del mensaje en el programa agregando a continuación de la clase de mensaje la cláusula WITH seguida de la variable del sistema sy-datum que contiene la fecha. Es importante tener en cuenta que cada & puede albergar 50 caracteres y que como máximo los mensajes pueden contener hasta 4 variables identificadas con &. Si en un mensaje se desea hacer salir el carácter & como texto y no como variable debemos escribirlo 2 veces.
El mensaje que mostramos es un mensaje de error. Esto está determinado por la letra e que se antecede al número del mensaje y la clase de mensajes entre paréntesis.
|
S
|
Status
|
El programa continua sin interrupción.
|
La línea de status.
|
|
I
|
Información
|
El programa continua después de la interrupción.
|
Una ventana de diálogo.
|
|
W
|
Warning
|
Depende del contexto del mensaje.
|
E
|
Error
|
Depende del contexto del mensaje (puede causar la cancelación del programa)
|
A
|
Terminación
|
El programa termina después de un cuadro de dialogo.
|
Una ventana de diálogo.
|
|
X
|
Dump
|
Error en tiempo de ejecución tipo X
|
Un dump.
|