El evento AT SELECTION-SCREEN y los tipos de mensajes en ABAP
La pantalla de selección es el conjunto de campos de entrada, parámetros y opciones de selección que se muestran al ejecutar un reporte ABAP. Su propósito es permitir que el usuario ingrese criterios para filtrar la información que posteriormente será consultada en tablas estándar de SAP o tablas personalizadas (Z).
En los programas de tipo reporte, el flujo habitual consiste en que el usuario introduce valores en la pantalla de selección, el sistema valida dichos valores, realiza la lectura de datos según los criterios ingresados y finalmente presenta los resultados en pantalla.
Para realizar validaciones sobre los datos introducidos por el usuario se utiliza el evento AT SELECTION-SCREEN. Este evento se ejecuta antes del procesamiento principal del programa y permite verificar que los valores ingresados cumplan con las reglas de negocio definidas.
Cuando se requiere validar un campo específico de forma individual, se recomienda utilizar el evento AT SELECTION-SCREEN ON seguido del nombre del parámetro o rango correspondiente. De esta manera, la validación se ejecuta únicamente cuando el usuario modifica dicho campo, permitiendo mostrar mensajes de error o advertencia de manera inmediata.
Ejemplo:
PARAMETERS: p_bukrs TYPE bukrs.
AT SELECTION-SCREEN ON p_bukrs.
IF p_bukrs IS INITIAL.
MESSAGE e001(zmsg).
ENDIF.
En este ejemplo, la validación se realiza únicamente sobre el parámetro P_BUKRS. Si el campo está vacío, se muestra un mensaje de error y el usuario no podrá continuar hasta corregir la información.
Los mensajes son el mecanismo utilizado por ABAP para informar al usuario el resultado de una validación o situación ocurrida durante la ejecución del programa. Los principales tipos de mensajes son:
Mensaje de éxito (S): Indica que una operación fue ejecutada correctamente. Se muestra en la barra de estado con un icono verde y no interrumpe el procesamiento del programa.
Mensaje de información (I): Muestra información relevante para el usuario mediante una ventana de diálogo. En ejecución interactiva, el programa queda en espera hasta que el usuario confirme el mensaje.
Mensaje de error (E): Señala que existe un problema que debe corregirse. Cuando se utiliza en la pantalla de selección, el sistema retorna al usuario al campo correspondiente e impide continuar hasta que el error sea solucionado.
Mensaje de advertencia (W): Informa una situación que requiere atención, pero permite al usuario continuar con la ejecución del programa. Generalmente se muestra en la barra de estado y puede omitirse presionando Enter.
Mensaje de cancelación (A): Muestra una ventana de diálogo y finaliza inmediatamente la ejecución del programa.
Mensaje de terminación anormal (X): Provoca un error en tiempo de ejecución (dump) y detiene completamente el procesamiento del programa.
Es importante considerar que el comportamiento de los mensajes depende del evento donde sean ejecutados. Por ejemplo, un mensaje de tipo E dentro del evento AT SELECTION-SCREEN devuelve el control al usuario para corregir la información ingresada. Sin embargo, un mensaje de error ejecutado durante START-OF-SELECTION puede generar una terminación anormal del programa, produciendo un dump y evitando que el usuario continúe interactuando con él.
Los textos de los mensajes se almacenan en clases de mensajes, las cuales se crean y administran mediante la transacción estándar SE91. Una clase de mensajes permite centralizar todos los textos utilizados por una aplicación o proyecto, facilitando su mantenimiento, reutilización y traducción a diferentes idiomas.