Status GUI y Títulos
Creación de un Status GUI
Es un componente independiente de los programas ABAP, que se utiliza para proporcionarle al usuario un amplio rango de funciones en la pantalla de los programas.
Está compuesto por barras de menú, barras de herramientas estándar, barras de herramientas de aplicaciones y la configuración de teclas de función. En el siguiente gráfico, identificamos cada uno de los componentes en la pantalla de salida de un reporte ABAP.
Vamos a crear un Status GUI para el reporte ZPRUEBA_EST_USUARIOS, que mostrará los usuarios activos y los inactivos dependiendo de que botón de la barra de herramientas de la aplicación ha sido presionado.
Para esto, accedemos a la transacción SE80, ingresamos el nombre del programa, presionamos enter y lo creamos tal como lo hacíamos a través de la transacción SE38.
Luego, vamos a crearle un Status GUI, para ello sobre el nombre del programa, hacemos botón derecho Crear / Status GUI tal como vemos en la siguiente imagen:
En la siguiente ventana, ingresamos el nombre del Status GUI, que será 0100, una descripción que podría ser "Status del reporte de usuarios" y presionamos continuar.
Luego veremos a la derecha de la pantalla, los componentes del Status GUI como vemos a continuación.
Luego, desplegamos la lista que está en la Barra de pulsadores y en el primer ítem en blanco, escribimos el código de función correspondiente a la ejecución del botón de usuarios activos, que será USU_ACTI y presionamos enter.
Aquí veremos una ventana de diálogo que nos indicará que no existe texto asignado a esa función y presionaremos continuar.
Luego veremos otra ventana donde completamos los datos referentes al nuevo botón.
- Código de Función: se utiliza para darle un nombre al botón.
- Texto función: se corresponde al texto que se muestra a la derecha del ícono del botón.
- Nombre ícono: será el ícono que se visualice por pantalla dentro del botón. Este se puede elegir dentro de una gran variedad de íconos que se visualizan presionando F4.
- Texto Info: es el nombre de ayuda del botón. Este se visualizará cuando dejemos quieto unos segundos el puntero del mouse sobre el botón.
Luego presionamos continuar y en la siguiente ventana de diálogo asignaremos una tecla de función al botón, que tendrá el mismo efecto que cuando hacemos clic con el puntero del mouse el botón. Por ejemplo, seleccionamos Shift-F1 y presionamos continuar.
Finalmente, con el botón creado veremos el primer ítem de la siguiente manera.
Aquí presionamos enter sobre el código USU_ACTI y completamos en la siguiente ventana, el campo Icon text. que será el texto que se visualice dentro del botón en la pantalla de salida.
Luego haremos lo mismo con el botón de usuarios inactivos, cuyo código será USU_INACTI y finalmente grabamos los cambios realizados y activamos.
Ahora vamos a introducir código en el reporte para poder utilizar el nuevo Status GUI. Lo primero que debemos hacer es declarar la utilización del status. Esto lo haremos mediante la sentencia SET PF-STATUS, tal como vemos a continuación.
Luego para capturar cual botón presiono el usuario, utilizaremos el evento AT USER-COMMAND junto con la variable del sistema SY-UCOMM que contendrá el código de función correspondiente al botón presionado.
Las subrutinas USUARIOS_ACTIVOS y USUARIOS_INACTIVOS realizan la selección e impresión de los correspondientes registros de la tabla ZTABLA_USUARIOS.
Finalmente activamos y al ejecutar el reporte veremos:
Si presionamos el botón "Reporte de usuarios activos" vemos un listado de los usuarios activos. Si no existen registros de usuarios activos, visualizaremos un mensaje de error. Lo mismo sucederá con los usuarios inactivos.
SABIAS QUE... Mediante la transacción estándar SE41 se pueden copiar Status GUI de un programa ABAP a otro.
AUDIO TIPS 1: Es frecuente que tengamos que desarrollar alguna transacción Z que disponga de botones en la barra de pulsadores. Una manera es creando un STATUS ID de cero dentro de nuestro programa a través de la transacción SE80. Pero el inconveniente que presenta esta opción es que deshabilita todos los botones pulsadores estándar de SAP y tendriamos que configurarlos manualmente. El mejor camino es copiarnos un STATUS I existente, agregarlo a nuestro reporte y añadirle las nuevas funcionalidades que queremos incluir. De esta forma estaremos conservando los pulsadores estándar de cada transacción. Para ello: Primero, debemos ejecutar el reporte cuyo estatus servirá de modelo. Allí, vamos a Sistema --> Estátus --> y podremos ver una pantalla y donde dice STATUS INTERFACE figura el nombre del estátus. Luego abrimos otro modo y entramos a la transacción estándar SE41. Luego vamos a Usuario --> Copiar Status y colocamos por un lado el nombre del programa y el estátus de origen y también el nombre del programa y el estátus que estamos desarrollando. Es importante tener en cuenta que el nombre del estátus no debe existir en ese reporte.
Creación de Títulos
Vamos a crear títulos para nuestro reporte. Para ello, en la transacción SE80, sobre el nombre del programa, hacemos botón derecho Crear/Títulos GUI, tal como vemos en la imagen siguiente.
En la siguiente ventana asignaremos un nombre al título y su descripción, que será la que se visualice en pantalla.
Luego crearemos el título 0200 para los usuarios inactivos y el título 0300 para la primer pantalla del reporte. Finalmente, presionamos el botón "Títulos (todos)" y veremos en pantalla los tres títulos creados. Lo último que nos queda es activarlos.
Para declarar la utilización de los títulos en el reporte, usamos la sentencia SET TITLEBAR tal como vemos en el siguiente gráfico.
Finalmente al ejecutar el reporte, visualizaremos los títulos, según los botones presionados de la pantalla.