✒️ABAP / El evento AT SELECTION-SCREEN y los tipos de mensajes Por Candela Calzada
ABAP El evento AT SELECTION-SCREEN y los tipos de mensajes
Unidad n°2: La declaración y el procesamiento de datos
Lección n°9: El evento AT SELECTION-SCREEN y los tipos de mensajes
Los tipos de mensajes:
Cuando ya tengamos todos los parámetros de entrada en la pantalla de selección de nuestro reporte, vamos a querer que dependiendo de los parámetros introducidos se produzcan determinadas acciones, es decir, que el programa tiene que saber si los parámetros ingresados por el usuario son correctos, en caso contrario, se deberán emitir los mensajes correspondientes de modo que se corrija el erro.
Tipos de mensajes:
- S: éxito.
- I: información.
- E: error.
- W: warning o advertencia.
- A: terminación
- X: dump o error en tiempo de ejecución.
Ejemplos:
- Mensaje de éxito: se ve en la barra de estado. Luego de su ejecución el procesamiento del programa continúa.
- Mensaje de información: se muestra en una ventana de diálogo. Si el programa se ejecuta de forma online, se pausará el procesamiento del programa hasta que el usuario interactúe con el programa.
- Mensaje de error: se produce la terminación del procesamiento de la pantalla. Los campos de la pantalla de selección especificados en el evento AT SELECTION-SCREEN permiten la entrada de datos donde el usuario introducirá un nuevo valor.
- Mensaje de advertencia: se muestra en la barra de status. Funciona como el msj de error, con excepción que el usuario puede saltear este tipo de mensajes presionando enter.
- Mensaje de terminación: se muestra en una ventana de diálogo y produce la terminación del programa.
- Mensaje dump: un dump es un error en tiempo de ejecución que interrumpe el procesamiento del programa. Estos msjs no se usan intencionalmente en los programas ABAP, si no que ocurre cuando se produce un error que no se contempló en la lógica del programa.
Las clases de mensajes:
- Son objetos de ABAP separados del programa principal, por ende debe activarse e incluirse dentro de los objetos que se transportarán al ambiente de testing.
- Son usados para almacenar todos los mensajes relativos a un proyecto o transacción de SAP.
- Se crean por la trans. estándar SE91.
*Trans SE91: se usa para la creación, modificación y visualización de las clases de mensajes en SAP, las cuales nos permiten agrupar los mensajes que usaremos en una aplicación. - Cada clase de mensaje puede almacenar hasta 1000 mensajes
EJ:
- Dentro de la trans SE91, pondremos el nombre de la clase de mensajes, que será "Z_CLASE_TEST" y creamos.
- En el campo de Texto breve, escribimos algo de referencia y guardamos.
- Vamos a la pestaña de mensajes y creamos el 1er mensaje que será el n°000.
- En el código del programa, usaremos la sentencia MESSAGE para emitir mensajes, se escribe como vemos:
MESSAGEe001(ZCLASE_MENSAJE) WITH<parámetro1> <parámetro2>... <parámetroN>
e 
tipo de mensaje.
001 núm. de mensaje
(ZCLASE_MENSAJE) clase de mensaje
<parámetro1> parámetros: son opcionales - Declaramos el evento AT SELECTION-SCREEN y dentro escribiremos el código correspondiente para ejecutar la validación.
AT SELECTION-SCREEN.
IF p_fecha < sy-datum.
MESSAGE e000(z_clase_test). "La fecha debe ser mayo o igual a la actual.
ENDIF. - Ejecutamos el reporte introduciendo en la pantalla de selección una fecha anterior a la actual y veremos un mensaje de error en la barra de status.
EJ: Usaremos parámetros dentro de los mensajes, ya que dentro de estos podemos mostrar el contenido de variables:
- Crear mensaje 001 con contenido: "& & & &" (los & pueden guardar hasta 50 caracteres y cuatro variables identificadas con & y si queremos que se vea un "&", debemos ponerlo doble: &&).
- En el programa escribiremos el msj usando los parámetros del msj 001 como vemos:
AT SELECTION-SCREEN.
IF p_fecha < sy-datum.
MESSAGE e000(z_clase_test) WITH 'La fecha debe ser mayor o igual a la actual'.
ENDIF. - Al ejecutar el programa, en la barra de status veremos el mensaje de error.
EJ: la última opción dentro de un msj definido en la clase de mensajes, es usar parte texto y parte parámetros:
- Crear el msj 002 con el contenido "La fecha debe ser mayor o igual a la fecha &".
- Dentro del programa, escribiremos de la sig. forma usando parte texto y parte parámetro del msj 002:
AT SELECTION-SCREEN.
IF p_fecha < sy-datum.
MESSAGE e000(z_clase_test) WITH 'La fecha debe ser mayor o igual a ' sy-datum.
ENDIF. - Al ejecutar el programa, si ponemos una fecha menor a la actual, nos saldrá el msj de error en la barra de status.
El evento AT SELECTION-SCREEN:
Para validar datos introducidos en los parámetros (parameters o select-options), usaremos AT SELECTION-SCREEN.
Su función es validar los parámetros de la pantalla de selección. Dentro de este evento se emite un msj de error, que hace que el procesamiento del programa no se cancela y el programa queda esperando a que el usuario vuelva a introducir un valor para el parámetro.
El AT SELECTION-SCREEN y las pantallas de selección de los programas junto con sus parámetros, solo tienen sentido cuando se ejecutan de forma online, es decir, donde hay interacción con el usuario.
Ej: en la pantalla de selección de nuestro programa, tenemos varios parámetros de entrada (parameters o select-options), y deseamos validarlos, para que cuando se ingrese un valor incorrecto, el usuario tenga la posibilidad de reingresar ese campo en particular y no todos, tal como sucedería si las validaciones estuvieran debajo en el AT SELECTION-SCREEN:
REPORT z_test_at_selection_screen.
PARAMETER: p_fecha TYPE sy-datum,
p_nombre(10) TYPE c.
- Declarar un evento AT SELECTION-SCREEN ON, para cada parámetro que queremos validar:
REPORT z_test_at_selection_screen.
PARAMETER: p_fecha TYPE sy-datum,
p_nombre(10) TYPE c.AT SELECTION-SCREEN ON p_fecha.
IF NOT p_fecha IS INITIAL AND p_fecha LT sy-datum.
MESSAGE e000 (ztest_mensajes) WITH 'La fecha introducida es mejor a la del día'.
ENDIF.AT SELECTION-SCREEN ON p_nombre.
IF NOT p_nombre IS INITIAL AND p_nombre CA '012345678'.
MESSAGE e000 (ztest_mensajes) WITH 'El nombre introducido no puede contener números'.
ENDIF. -
Al ejecutar el programa, si introducimos un valor incorrecto para el parámetro p_fecha, veremos en la barra de status "La fecha introducida es menor a la del día".
Si introducimos un valor incorrecto para p_nombre, en la barra de status veremos "El nombre no puede contener números".
Escanear / Compartir
Sobre el autor
Publicación académica de Candela Calzada, en su ámbito de estudios para el Curso SAP ABAP.
SAP Expert
Candela Calzada
Profesión: Técnica Electrónica - Argentina - Legajo: JW91W
✒️Autor de: 160 Publicaciones Académicas
🎓Cursando Actualmente: Curso SAP ABAP Avanzado
🎓Egresado de los módulos:
Disponibilidad Laboral: FullTime
Presentación:
Me encuentro estudiando la ingeniería en sistemas de información. poseo amplia experiencia en edición de videos. tengo bases entorno a la programación que quiero continuar consolidando.
Certificación Académica de Candela Calzada
