Todo sobre reportes interactivos – Parte 3

Continúo con la tercera parte de esta serie de artículos sobre los reportes interactivos APEX, de la que al momento llevamos:

• Todo sobre reportes interactivos – Parte 1.
• Todo sobre reportes interactivos – Parte 2.

En esta ocasión voy a seguir con algunos ejemplos específico de como realizar modificaciones a los atributos del reporte para alcanzar resultados específicos. Me refiero específicamente a las modificaciones que podemos realizar para personalizar tanto la barra de búsqueda como el menú de acciones.

Personalizando la barra de búsqueda de un reporte interactivo

Por defecto, cuando creamos un reporte interactivo, este viene acompañado de una barra de búsqueda y también un menú de acciones (este último lo veremos más adelante en detalle).

Cuando damos mantenimiento a un reporte interactivo, podemos personalizar o remover esta barra de búsqueda de acuerdo a nuestras preferencias o necesidades y es lo que vamos a estudiar a continuación.

Como ya se mencionó, inicialmente todo reporte iteractivo viene con está barra de búsqueda y la podemos localizar en la parte superior del reporte, al lado izquierdo de la página. Esta barra está compuesta por los siguientes elementos:

• El botón Seleccionar columnas a buscar, por medio del cual indicamos en cual columna o columnas queremos realizar la búsqueda.
• Un Área de texto donde podemos ingresar la cadena que queremos buscar.
• El botón Ir, que ejecuta el proceso de búsqueda.
• El botón Acciones, que como mencioné arriba, lo veremos detalladamente más adelante.

Adicionalmente, si un usuario a guardado uno o más reportes, a la derecha del botón Ir, se desplegará una lista desplegable con dichos reportes. También se pueden mostrar en esta barra los botones para acceder a diferentes vistas del reporte si estás han sido configuradas.

En la imagen anterior, podemos observar de izquierda a derecha, los cuatro elementos principales que se listaron anteriormente.

¿Cómo modificar la barra de búsqueda?

El procedimiento para personalizar la barra de búsqueda de un reporte interactivo es el siguiente:

1. Ingresar al ambiente de desarrollo de APEX, al espacio de trabajo donde tenemos nuestra aplicación.
2. Una vez en la página principal del espacio de trabajo, ingresamos al Creador de Aplicaciones.
3. En la página principal del creador de aplicaciones, vamos a seleccionar la aplicación que contiene el reporte.
4. En la página principal de la aplicación, vamos a ingresar a la página que contiene el reporte indicado.
5. Cuando estamos en el diseñador de páginas verá una página similar a la que se muestra a continuación:
   1. En el panel de Presentación, a la izquierda de la pantalla, seleccione la región del reporte interactivo (en la imagen a continuación, resaltada dentro del recuadro rojo)
      Al realizar la selección, en el panel de la derecha, el editor de propiedades, se van a mostrar los atributos de la región, aquí vamos a hacer clic en el pestaña Atributos (resaltada en negrita en la imagen).
   2. Vamos a utilizar el menú desplegable a la derecha de la caja de búsqueda de atributos, que muestra los nombres de los diferentes grupos, y vamos a hacer clic en Barra de Búsqueda. Se mostrarán dichos atributos, enmarcados en rojo a la derecha de la imagen de arriba.
   3. De acuerdo con sus necesidades, apague o encienda el interruptor para las opciones:
      1. Incluir Barra de Búsqueda. Si desea que se muestre total o parcialmente la barra de búsqueda o que por el contrario no se muestre. Si apaga esta opción, las demás opciones no se mostrarán y se desahabilitarán por defecto.
      2. Campo de Búsqueda. Muestra o deja de mostrar la caja de tecto en la que podemos ingresar cadenas a buscar dependiendo del estado que le definamos.
      3. Lista Desplegable del Buscador. Muestra u oculta el botón de selección de columnas a buscar a la izquierda de la caja o campo de búsqueda. Esta lista le permite al usuario limitar la búsqueda a ejecutar a columnas específicas del reporte. Por defecto, la búsqueda se realiza en todas las columnas del reporte.
      4. Lista de Selección de Informes. Esta opción habilita o deshabilita el mostrado de una lista desplegable de reportes definidos por el usuario.
      5. Selector de filas por Página. Por defecto, esta opción se encuentra apagada y se utiliza para mostrar una lista de valores desplegable con diferentes números de líneas a mostrar por página para el reporte interactivo.
   4. También puede definir la Etiqueta del Botón de Búsqueda, de manera que no se muestre como Ir, sino con una etiqueta más acorde a su utilidad, como por ejemplo “Buscar”.
   5. El último atributo que puede definir, relacionado con la barra de búsqueda, es el Máximo de Filas por Página, el cual está relacionado con el Selector de Filas por Página, aquí definimos cual es el númerro máximo que se mostrará en esta lista.
   6. Para finalizar, hacemos clic en el botón Guardar.

Veamos un ejemplo específico de personalización de la barra de búsqueda. Si ejecutamos el reporte de Proyectos de la aplicación que hemos estado usando para esta serie, dicho reporte luciría tal y como se muestra en la imagen de abajo.

Procedamos a deshabilitar la barra de búsqueda para que esta no se muestre.

El proceso que debemos ejecutar para deshabilitar la barra de búsqueda del reporte (este o cualquier otro) es, una vez seleccionada la página que contiene el reporte:

1. En el Diseñador de páginas, seleccionamos la región Proyectos en el panel de presentación de la página.
2. En el Editor de Propiedades, a la derecha de la página, vamos a hacer clic en la pestaña “Atributos”, del Editor de Propiedades, hacemos clic en el menú desplegable de los grupos de atributos y seleccionamos Barra de Búsqueda.
3. Finalmente, “apagamos” el selector del atributo Incluir Barra de Búsqueda, tal y como se muestra en la siguiente imagen.

No olvide hacer clic en el botón Guardar para aplicar los cambios realizados.

Si ejecuta nuevamente el reporte, ahora este lucirá tal y como se muestra en la siguiente imagen:

Finalmente, el reporte de proyectos, debería lucir similar al que se muestra en la imagen a continuación, en donde podemos apreciar el título y párrafo aclaratorio, además de las notas de definición de los estados de proyectos.

De la imagen anterior quisiera rescatar algo que talvez ya hayan notado. Si bien la barra de búsqueda ya no aparece, las propiedades de los encabezados de las columnas se mantienen intactos, como lo muestra el menú desplegable por debajo de la columna Estado.

Esto es así porque estas son propiedades que corresponden a las columnas del reporte y no a los atributos del mismo, más adelante en esta serie, posiblemente en la Parte 5 de la misma, veremos como modificar estos atributos.

Personalizar el menú de acciones de un reporte interactivo

Tal y como mencioné en la sección anterior, existe un componente particular de la barra de búsqueda de un reporte interactivo que se conoce como el Menú de Acciones. Dicho menú esta representado por una lista desplegable, encabezada por el título Acciones.

Este menú aparece a la derecha de la barra de búsqueda y es usado por los usuarios finales para personalizar sus reportes interactivos de acuerdo a sus necesidades.

En el caso de los desarrolladores, estos pueden personalizar dicho menú, ya sea para que este se muestre o sea ocultado, o bien, para definir cuales son los componentes de este que el usuario final va a poder utilizar.

¿Cómo modificar el menú de acciones?

El procedimiento general para modificar el Menú de Acciones, es el siguiente:

1. En su aplicación, ingrese a la página con el reporte interactivo.
2. Cuando estamos en el diseñador de páginas:
   1. En el panel de Presentación, a la izquierda de la pantalla, seleccione la región del reporte interactivo (en la imagen a continuación, resaltada dentro del recuadro rojo)
      
   2. Al realizar la selección, en el panel de la derecha, el editor de propiedades, se van a mostrar los atributos de la región, que como se explicó anteriormente están organizados en grupos o secciones.
      Haga clic en la pestaña Atributos del Editor de Propiedades y seleccione el grupo de atributos Menú de Acciones.
   3. Una vez Condición de Servidor, selecciones el tipo de condición a utilizar. Se mostrarán nuevos atributos dependiendo de la selección hecha para el atributo Tipo.
   4. Una vez allí habilite o deshabilite cada una de las opciones que desee incluir o dejar de incluir en el menú. Estas opciones se detallan en el cuadro de más abajo.
   5. Para finalizar, haga clic en el botón Guardar.