Los mensajes en Web Dynpro son utilizados para ofrecer al usuario información de estado de la aplicación, y para mostrar errores y avisos. En el siguiente artículo mostraremos como Web Dynpro permite definir qué tipo de mensaje es enviado, dónde se muestra y cómo es visualizado.
¿Dónde mostrar los mensajes WD4A?
Lo primero es saber dónde mostrar los mensajes WD4A. Existe un área reservada para los mismos, que por defecto está ubicada en la parte superior de la pantalla. Otra opción, es ubicarla donde el usuario lo requiera. Para ello se debe definir en el layout de la vista un elemento Message Area y ubicarlo donde se quiera.
¿Cuándo mostrar los mensajes WD4A?
Además, se puede elegir cuándo mostrar el área de mensajes WD4A: si mostrarlo siempre o sólo cuando existan mensajes a mostrar. Para ello, en la pestaña Properties de la aplicación Web Dynpro, se puede elegir una de las dos opciones con el siguiente radioButton:
Si se decide mostrar siempre el área de mensajes WD4A, cuando no haya mensajes se visualizará este área de la siguiente manera:
¿Cómo mostrar mensajes WD4A?
Para reportar un mensaje en una aplicación Web Dynpro, deben utilizarse los métodos del interfaz IF_WD_MESSAGE_MANAGER. Web Dynpro instancia automáticamente esta clase en cada controlador, y se puede recoger la misma de la siguiente manera:
DATA: l_controller TYPE REF TO if_wd_controller, l_message_manager TYPE REF TO if_wd_message_manager. l_controller ?= wd_this->wd_get_api( ). l_message_manager = l_controller->get_message_manager( ).
Una vez instanciada la interfaz, ya se pueden utilizar los distintos métodos de la clase para lanzar mensajes WD4A de error, warning, success… También existe una opción en el Code Wizard, para utilizar cualquier método de reporte de mensajes.
Todos los métodos para reportar mensajes Web Dynpro pueden ser agrupados en tres categorías:
- TEXT*: Los mensajes pertenecientes a esta categoría permiten mensajes conteniendo un texto arbitrario. Los textos traducidos pueden venir del OTR, de texto definido en clases ABAP, o del diccionario de datos.
- T100.*: Estos métodos utilizan texto definidos en la tabla de base de datos T100 como mensajes de entorno Web Dynpro.
- EXCEPCIONES: Errores recogidos en tiempo de ejecución y los texto relacionados pueden ser usado al escoger un mensaje de esta categoría.
Todos estos mensajes Web Dynpro Abap pueden relacionarse con un elemento UI. Los tipos de mensajes con * pueden recibir parámetros, para personalizar los mensajes según la aplicación.