InterSystems Reports - fórmulas, parámetros y etiquetas

En este artículo, exploramos el uso de parámetros, fórmulas y etiquetas en Logi Report Designer (anteriormente Logi JReport Designer). ¿Para qué sirven y cómo crearlos?

Utilizando la funcionalidad básica de InterSystems Reports Designer, parámetros, fórmulas y etiquetas, se puede mejorar significativamente la información del informe generado. Además, estas herramientas permiten automatizar algunos de los procesos, lo que agiliza y facilita enormemente la creación de informes.

Analicemos ahora cada herramienta por separado.

Los parámetros son variables configurables individualmente. Pueden almacenar datos tanto estáticos como dinámicos. Para un parámetro dinámico, se puede configurar una consulta SQL propia, que será independiente de la consulta SQL del conjunto de datos principal. De esta manera, se puede generar datos sin crear múltiples conjuntos de datos, manteniendo así el diseño organizado y limpio. Los parámetros se pueden utilizar tanto como parte de funciones y consultas SQL como indicador independiente con la siguiente sintaxis: "@YourParameter". Esta cualidad es simplemente indispensable cuando se requiere precisión y detalle de los datos.

Un parámetro estático es un valor predefinido o una lista de valores utilizados como condición o filtro en la salida. También se puede utilizar un parámetro estático en consultas SQL, funciones y etiquetas utilizando la misma sintaxis: “@YourParameter”.

Las fórmulas son funciones totalmente programables en el lenguaje Java. Esta potente herramienta amplía enormemente las posibilidades de análisis, permitiendo realizar cálculos complejos y establecer condiciones lógicas para los datos de salida. Las fórmulas se crean en el IDE de Java integrado dentro de Logi, con un conjunto integrado de funciones para trabajar con tipos de datos como array, fecha/hora, financieros, matemáticas, cadenas, etc. Las fórmulas pueden funcionar con todos los datos disponibles en InterSystems Reports. El IDE integrado comprende parámetros, campos calculados e incluso otras fórmulas.

Una etiqueta es un widget de texto. Sirve para mostrar caracteres en minúscula y variables. Su propósito habla por sí solo: se usa en encabezados y pies de página, como leyenda personalizada para un gráfico o una tabla, en una palabra... y donde sea necesario titular los datos. Al igual que todas las demás herramientas de InterSystems Reports, la etiqueta es un widget muy flexible. Se puede colocar en cualquier lugar de la página, dentro de un gráfico o tabla.

Aquí veremos ejemplos del uso más básico de estas herramientas.

Crearemos un parámetro que devuelva el número de desarrolladores del número total de miembros de la comunidad InterSystems.

Para crear un parámetro, hay que hacer clic en el botón "Catalog Manager" (Administrador de catálogos) en la esquina superior izquierda de la barra de herramientas.

En la ventana que se abre, a la izquierda, hay que seleccionar el elemento Parámetros y luego hacer clic en el botón "New parameter" (Nuevo parámetro) en la esquina superior izquierda.

Se abrirá la ventana de creación de parámetros.

En la primera línea, debemos configurar el nombre del parámetro. Se recomienda elegir un nombre que refleje con la mayor precisión posible el propósito del parámetro y que al mismo tiempo sea lo suficientemente breve. Es necesario porque durante el proceso de desarrollo se creará una gran cantidad de parámetros diferentes y existe el riesgo de sobrecargar las listas de parámetros y funciones. En este artículo, analizaremos el parámetro dinámico, por lo que en la segunda línea, en "Value setting" (Configuración del valor), seleccionaremos "Bind with single column". En la línea "Data source" (Fuente de datos), elegiremos la tabla desde la cual se realizará la selección. En nuestro caso, son los "members" (miembros de la Comunidad). Luego, en"Bind Column", seleccionaremos las columnas de las que devolveremos el valor. 

No hay una columna separada que pueda contar la cantidad de desarrolladores para nosotros en la tabla de Miembros. Sin embargo, gracias a la capacidad de establecer una consulta SQL especial, podemos establecer una condición para esta selección particular. Para hacerlo, hay que ir hacia abajo en la lista de propiedades, hasta la línea "Import SQL" y hacer clic en ella.

Aparecerá una ventana de creación de solicitud. Ya ha registrado previamente la cadena de selección de la columna members_count: el número total de participantes. Sólo necesitamos añadir la condición “where Developer = 1”. Podemos verificar la solicitud haciendo clic en el botón "Check" y, si ha salido bien, hay que hacer clic en Aceptar. 

Después de completar los pasos anteriores, hay que hacer clic en "Ok" en la ventana de creación de parámetros y el nuevo parámetro Developer_member aparecerá en el directorio de la izquierda. En este punto, hay que cerrar la ventana del "Catalog Manager" y probar el parámetro recién creado. Para hacerlo, se arrastra a la página del informe y se hace clic en "View". Después de completar este paso, hay que aceptar el valor del parámetro tomado de la base de datos actual, así que hay que hacer clic en "Ok". 

¡Listo! Ahora podemos ver cuántas personas en la comunidad son desarrolladores. Esta configuración se actualizará automáticamente cada vez que cambien los datos.

Ahora crearemos una fórmula. Esta fórmula calculará el porcentaje de desarrolladores respecto al número total de participantes. 

Para hacerlo, hay que repetir los mismos pasos que hicimos al crear el parámetro. Vamos a recordarlo. Hacer clic en el "Catalog Manager"s, seleccionar Fórmulas y después "New formula" en la esquina superior izquierda.

Antes de que aparezca la ventana de creación de fórmulas, se nos pide poner un nombre a la fórmula.

Después, se abrirá el IDE para escribir código en Java. Integrado en InterSystems Reports, el compilador permite escribir funciones cortas sin definir clases ni métodos. Para calcular el porcentaje, necesitamos dividir nuestro nuevo parámetro entre el número total de miembros y multiplicarlo por 100. Ya hemos creado el indicador CountTotalMembers. Lo hicimos con la herramienta llamada InterSystems Adaptive Analytics (de AtScale).

Así, obtuvimos la siguiente fórmula. Prestad atención a la función que permite escribir comentarios en el código. Un código bien documentado facilitará que otros trabajen con esas fórmulas.

Después de escribir, se puede verificar si el código resultante tiene algún error, haciendo clic en el botón de comprobación en la barra de herramientas. La herramienta comprobará si la sintaxis es correcta y si los parámetros especificados están presentes.

Una vez probada la función, se puede guardar. Para que eso suceda, hay que hacer clic en el botón "Save" y la fórmula aparecerá en el catálogo.

Siguiendo el ejemplo del parámetro, el siguiente paso será arrastrar la nueva fórmula a la página y averiguar el porcentaje de desarrolladores en el número total de participantes.

Esta función se puede utilizar como indicador para gráficos y tablas. Os daré un ejemplo del uso de nuestra nueva fórmula en un gráfico de barras. 

En este ejemplo, utilicé una nueva fórmula y obtuve la proporción de desarrolladores durante los últimos cinco meses.

Es un gráfico de barras, con la fórmula developers_to_members en el eje "y" y la dimensión month_year_num en el eje "x". Resultó ser una tendencia muy visual y lo hicimos en apenas unos minutos. 

Ahora es el momento de mirar las etiquetas. 

Están incrustadas en la página del informe desde la pestaña "Insert" con el botón "Label".

.

Aparecerá una ventana en la página, para ingresar el texto.

La funcionalidad incorporada permite editar muchos parámetros para la nueva etiqueta. En este artículo, utilizamos este widget para mejorar nuestra nueva tabla.

Hay muchos parámetros ubicados en el panel de la derecha que pueden ayudar a diseñar una etiqueta. Para que aparezcan, hay que seleccionar el widget "Label".

Para configurar los bordes del widget, hay que bajar hasta la categoría "Border". Seleccione los 4 bordes: Bottom Line (Línea inferior), Left Line (Línea izquierda), Right Line (Línea derecha) y Top Line (Línea superior), y poner en todos "solid".

Para rellenar el fondo, hay que bajar hasta la categoría "Color" y seleccionar el tono deseado. Se puede hacer lo mismo en la pestaña "Format" en la barra de herramientas de la parte superior.

Para seleccionar el tamaño de fuente, en la misma pestaña "Format", haced clic en el menú desplegable con tamaños y elegid el que queráis. También se puede configurar el tipo de fuente y la ubicación del texto dentro del widget. 

Para un posicionamiento más preciso en relación con otros widgets, se pueden utilizar las coordenadas que tiene la etiqueta dentro de la página. De forma predeterminada, los tamaños de las hojas están en pulgadas. La configuración de posicionamiento se encuentra en la categoría "Geometry" en el panel de propiedades del widget a la izquierda.

En este artículo, intentamos abordar tres características básicas de InterSystems Reports (con tecnología de Logi Report). Por eso esperamos que ya sepáis cómo crear fórmulas, parámetros y etiquetas con confianza.