Todo sobre reportes interactivos – Parte 2

Esta es la segunda parte de una serie de artículos sobre los reportes interactivos APEX, compuesta por:

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

En este artículo me voy a centrar en los procesos de personalización de los atributos a nivel de región, reporte y columnas de un reporte interactivo.

Personalizando atributos de región de un reporte interactivo

Existe una serie de atributos de los reportes interactivos, los cuales se definen al nivel de la región que contiene dichos reportes. Estos atributos los vamos a encontrar agrupados en las siguientes secciones:

Como se puede ver en la imagen anterior, cuando seleccionamos en el panel de la izquierda la región del reporte interactivo, en el panel de la izquierda vamos a tener los atributos de la región (dentro de los recuadros rojos).

 Adicionalmente, podemos observar que además de la pestaña de atributos de Región, tenemos dos más, una de Atributos y una tercera Imprimiendo.

A continuación, me voy a centrar en dos tareas específicas:

• ¿Cómo modificar cualquier atributo de la región del reporte?
• ¿Cómo mostrar los reportes interactivos de manera condicional?

¿Cómo modificar atributos de la región del reporte?

En el primer artículo de esta serie, definimos un campo de trabajo. En este, creamos una aplicación con 4 reportes interactivos, de manera que ahora podríamos realizar cambios sobre cualquiera de ellos.

Pero antes, veamos cuál es el procedimiento general para modificar atributos de región del reporte:

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:
   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, tal como se muestra en la siguiente imagen.
      
   3. Para encontrar un grupo o atributo, puede usar la caja de búsqueda en la parte superior del panel, lo único que debe hacer es escribir en la caja de búsqueda el nombre del grupo o el atributo que desea localizar. También puede utilizar el menú desplegable a la derecha de la caja de búsqueda, que muestra los nombres de los diferentes grupos, al hacer clic en el nombre del grupo, será dirigido a dicho grupo.
   4. Una vez localizada la propiedad de la región, puede realizar el cambio que desea.
   5. Para finalizar, lo que resta es Guardar los cambios.

Puede ver ayuda sobre cada propiedad específica mostrada en el Editor de Propiedades, para esto, simplemente hace clic sobre la propiedad deseada y luego, en el panel central hace clic sobre la pestaña Ayuda, con lo cual ontendrá una descripción de los valores que puede definir en dicha propiedad.

Ahora veamos un ejemplo, en este caso vamos a utilizar el reporte de proyectos que creamos en la parte 1 de esta serie.

En este momento el reporte debe lucir tal y como se muestra en la imagen a continuación.

Como podemos observar en la imagen, si no tenemos el menú abierto, para observar que página tenemos abierta, no sabemos de que se trata, porque una de las caarcterísticas de los reportes interactivos, es que no muestra el título de la región por defecto.

Entonces, sería importante agregar de alguna manera un título a la region para que nuestra usuario final pueda saber en que consiste el reporte que está observando. También podríamos agregar un párrafo de texto en donde explicamos el contenido de la información y, ¿por qué no? algunas notas aclaratorias, por ejemplo del significado de cada valor de la columna “Estado”.

Existen diferentes formas de hacer todo esto, como por ejemplo, agregar nuevas regiones para cada uno de estos requerimientos. Pero, también podemos hacerlo utilizando las propiedades de la región, que en este caso es lo que nos interesa. Veamos cómo.

Primero vamos a definir un título para la región, que identifique el tipo de reporte que estamos viendo en la pantalla. Para eso:

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 buscar el grupo “Cabecera y Pie de Página”.
   
3. Nos vamos a colocar en la propiedad Texto de Cabecera y vamos a agregar el siguiente código HTML: <h3>Informe de Proyectos</h3>

Lo que hicimos en el punto 3, es agregar una etiqueta HTML que agrega un Encabezado o Título de nivel 3. Aquí podríamos guardar los cambios realizados y ver lo que sucede, pero antes de eso, vamos a realizar un segundo cambio.

Vamos a agregar un párrafo en donde agregamos alguna información sobre los datos mostrados en el reporte:

1. En la propiedad Texto de Cabecera, vamos a agregar, por debajo del Encabezado agregado en el procedimiento anterior, el siguiente texto como un párrafo (no agregue las comillas):

“<p>El informe de proyectos muestra los datos de generales de todos y cada uno de los proyectos que se encuentran definidos, ya sea que estos se encuentren activos o ya se hayan finalizado</p>”

Finalmente, vamos a agregar unas notas aclaratorias al final del reporte, en donde explicamos el significado de cada uno de los estados de los proyectos, para lo cual, en la propiedad Texto de Pie de Página, vamos a agregar lo siguiente (sin las comillas):

“<ul>
<li><strong>Assigned</strong> – El proyecto se encuentra asignado a una persona pero aún no se estpa trabajando en él</li>
<li><strong>In-Progress</strong> – El proyecto está siendo ejecutado en estos momentos</li>
<li><strong>Completed</strong> – El proyecto ya se completó</li>
</ul>“

Ahora si, vamos a guardar los cambios realizados, haciendo clic en el botón Guardar.

Las propiedades de Cabecera y Pie de Página de la región deberían lucir como se observa en la siguiente imágen:

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.

¿Cómo mostrar el reporte de manera condicional?

Puedes cambiar cualquier otra propiedad de región de todas las que están definidas para la misma, pero a continuación, me voy a centrar en una especial, el mostrado condicional de la región del reporte.

Una de las características que tiene APEX, es que nos permite de manera condicional, mostrar o no ciertos elementos de una página de nuestra aplicaciones, o incluso la página entera, esto nos permite, dependiendo de una condición específica que em uchos casos puede estar ligada con un usuario específico, mostrar o no una región. En este caso, mostrar o no nuestro reporte interactivo.

Todo esto nos permite de cierta manera definir algún grado de seguridad en nuestras aplicaciones (aunque existen otras maneras de aplicar seguridad a los componentes de nuestras aplicaciones).

El condicionamiento de nuestra región de reporte interactivo va a estar definido por el Tipo de condicionamiento que definamos, el cual puede ser uno de los siguientes:

1. Página Actual = Página. La página actual es igual que el valor que se introduce en Página.
2. Página Actual != Página. La página actual no es igual que el valor que se introduce en Página.
3. La página actual está en una lista delimitada por comas. La página actual está en la lista delimitada por comas que se introduce en Página.
4. La página actual está en una lista no delimitada por comas. La página actual no está en la lista delimitada por comas que se introduce en Página.
5. La página actual está en modo Versión para Impresora. El usuario final ha cambiado la página actual al modo “Versión para Impresora”.
6. Página Actual no en modo Versión para Impresora. El usuario final no ha cambiado la página actual al modo “Versión para Impresora”.
7. Página/Región Es de Sólo Lectura. Ya se trate de una región principal o de página, si son las adecuadas, la condición “Solo Lectura” se evalúa en TRUE.
8. Página/Región NO Es de Sólo Lectura. La región principal o de página, si son las adecuadas, se muestran con normalidad.
9. Usuario Autenticado (no público). El usuario final está conectado a la aplicación. Esto significa que el usuario es un usuario válido y registrado de acuerdo con el esquema de autenticación definido para la aplicación.
10. El Usuario es el Usuario Público (el usuario no se ha autenticado). El usuario final no está conectado a la aplicación. No se ha validado utilizando el procedimiento de autenticación definido para la aplicación.
11. Errores de Validación en Línea Mostrados. En la página se muestra un error de validación en línea después de una ejecución de página.
12. Errores de Validación en Línea No Mostrados. El error de validación en línea no se muestra en la página.
13. Idioma Actual = Valor. El usuario final está ejecutando la aplicación en el idioma que se introduce en el atributo Valor.
14. Idioma Actual != Valor. El usuario final no está ejecutando la aplicación en el idioma que se introduce en el atributo Valor.
15. El idioma actual está incluido en el valor. El usuario final está ejecutando la aplicación en uno de los idiomas que se introducen en el atributo Valor.
16. El idioma actual no está incluido en el valor. El usuario final no está ejecutando la aplicación en ninguno de los idiomas que se introducen en el atributo Valor.
17. Nunca. El componente nunca se representa ni ejecuta. Cambiar una condición a Nunca eliminará cualquier condición existente. Para desactivar un componente temporalmente, Oracle recomienda utilizar en su lugar el atributo Opción de creación.

Una vez que seleccionamos el Tipo de condicionamiento que vamos a utilizar, debemos de proporcionar o modificar otros atributos de la región, los cuales van a depender del tipo seleccionado.

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:
   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.
      Localice el grupo de atributos Condición de Servidor, puede usar la caja de búsqueda en la parte superior del panel. También puede utilizar el menú desplegable a la derecha de la caja de búsqueda, que muestra los nombres de los diferentes grupos, al hacer clic en el nombre del grupo, será dirigido a dicho grupo.
   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. Complete los nuevos atributos mostrados al realizar la selcción del atributo Tipo.
   5. Para finalizar, haga clic en el botón Guardar.

Personalizando atributos del reporte interactivo

De la misma manera que tenemos atributos para definir la región del reporte interactivo, tenemos en el panel del editor de propiedades, a la derecha de la pantalla, una pestaña en donde podemos modificar los atributos del reporte en sí, tal como se muestra en la imagen anterior.

Si observas bien, he resaltado en un recuadro rojo la pestaña de los atributos del reporte, la cual se encuentra a la derecha de la pestaña Región, que ya vimos en las secciones anteriores. Esta nueva pestaña está identificada con el encabezado Atributos.

Al igual que con los atributos de la Región, los atributos del reporte están organizados en grupos, específicamente los siguientes:

Ahora que ya conocemos un poco de estos atributos de reporte, veamos primeramente cuál es el procedimiento general para modificar un atributos y, posteriormente, cómo realizar cambios de los atributos para lograr un objetivo específico.

Manejo del enlace incorporado

Como se mencionó anteriormente, uno de los grupos de atributos nos permite definir un enlace de manera sencilla para cada línea del reporte, este enlace puede ser:

• a la vista de un solo registro, que nos muestra cada uno de los registros del reporte de manera individual,
• a una página de la aplicación,
• a un URL específico, o bien,
• excluir dicho enlace.

Cuando definimos un reporte interactivo, por defecto, la opción que se habilita es esta última, o sea, que no se incluye ningún enlace. Sin embargo, si cualdo estamos creando el reporte activamos la opción de crear también un formulario, entonces se va a agregar en este caso, un enlace a la página del formulario que se está creando junto con el reporte.

Una vez que hemos creado el reporte interactivo, podemos definir cualquiera de las opciones de enlace que se mencionan anteriormente, para lo cual vamos a ejecutar el siguiente procedimiento.

1. Hacer clic en el panel de presentación a la izquierda del diseñador de páginas, en el nombre de la región del reporte interactivo.
2. En el panel de la derecha, del editor de propiedades, hacemos clic en la pestaña Atributos.
3. Enlace, es el primer grupo de atributos que podemos ver. En el atributo Columna de enlace:
   1. Si queremos habilitar la vista de un solo registro:
      1. Selecionamos Enlace a Vista de Una Sola Fila.
      2. En Identificar Filas como Únicas por, seleccionamos la manera en que identificamos de manera única la final, la cual puede ser ROWID o Columna única.
      3. En Icono de Enlace, o bien seleccionamos uno de los iconos proporcionados por defecto, o incluimos el tag HTML del icono que vamos a usar como enlace.
      4. Adicionalmente, si es necesario o queremos, podemos definir valores para; Atributos de Enlace, Esquema de Autorización y Tipo de Condición.
   2. Si queremos enlazar con una página específica:
      1. Selecionamos Enlace a Destino Personalizado.
      2. En Destino:
         1. En Tipo, seleccionamos Página en esta aplicación si vamos a redirigir a una página en la misma aplicación, o bien, Página en una Aplicación Diferente si la página pertenece a otra aplicación.
         2. Seleccionamos o ingresamos el número de página o número de aplicación y página según sea el caso.
         3. En Definir Elementos, definimos los parámetros a pasar y sus respectivos valores.
         4. Hacemos clic en el botón Aceptar.
      3. En Icono de Enlace, o bien seleccionamos uno de los iconos proporcionados por defecto, o incluimos el tag HTML del icono que vamos a usar como enlace.
      4. Adicionalmente, si es necesario o queremos, podemos definir valores para; Atributos de Enlace, Esquema de Autorización y Tipo de Condición.
   3. Si queremos enlazar a un URL personalizado:
      1. Selecionamos Enlace a Destino Personalizado.
      2. En Destino:
         1. En Tipo, seleccionamos URL.
         2. En URL ingresamos el enlace al que vamos a redireccionar, incluyendo los parámetros que necesitamos pasar.
      3. En Icono de Enlace, o bien seleccionamos uno de los iconos proporcionados por defecto, o incluimos el tag HTML del icono que vamos a usar como enlace.
      4. Adicionalmente, si es necesario o queremos, podemos definir valores para; Atributos de Enlace, Esquema de Autorización y Tipo de Condición.
4. Hacemos clic en el botón Guardar.

Veamos lo anterior con un ejemplo práctico y agreguemos a nuestro reporte de proyectos un enlace a la vista de una sola fila.

1. Abra en el diseñador de páginas la página del reporte de proyectos.
2. En el panel de presentación haga clic en ela región Proyectos (o como se llame la región de su reporte de proyectos).
3. En el panel del Editor de Propiedades, haga clic en la pestaña Atributos.
4. En Columna de Enlace, seleccione Enlace a Vista de Una Sola Fila.
5. En Identificar filas como únicas por, selecccione Columna única.
6. En Columna única, seleccione ID (Id es la llave primaria de los registros de proyectos).
7. Haga clic en el botón Guardar.

Ahora el reporte debe lucir como el que se muestra en la siguiente imagen.

Como puede ver en la imagen anterior, ahora en la parte izquierda del reporte, tenemos una columna con un ícono (enmarcada con el recuadro rojo).

Si hacemos clic en cualquiera de estos iconos, el reporte cambiará a la vista de una sola fila y entonces veremos en pantalla un reporte similar al que se muestra a continuación.

Como habrá podido observar, en la pantalla tendrá la información de la fila del reporte seleccionada, solamente que ahora el formato en que se muestra es diferente, ya no se muestra como una fila con columnas, sino que. se muestra a manera de tabla.

Sin embargo, si aún no lo ha notado, se mantienen las características de formato como los nombres de las columnas, el formato aplicado a los datos y todos los otros cambios que hayamos aplicado, como los textos de Cabecera y Pie que habíamos definido previamente para el informe.

Adicionalmente, en la esquina superior izquierda, por debajo de la Cabecera, podrá ver un botón Vista de Informe, el cual nos retorna a la vista tradicional del reporte.

También verá en la esquina superior derecha, en la misma región donde se encuentra el botón mencionado en el párrafo anterior, verá el control de páginación, con el cual podemos navegar de una fila a otra, ya sea hacia adelante o hacia atrás.

Y por el momento aquí vamos a parar, en la siguiente publicación de la serie, veremos algunos otros ejemplos específicos de modificación de atributos del reporte interactivo y continuaremos con otras opciones de modificación de atributos que podemos hacer.