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, puede mejorar significativamente el contenido de detalles e 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, puede configurarse su propia consulta SQL, que será independiente de la consulta SQL del conjunto de datos principal. De esta manera, puede generar datos sin crear múltiples conjuntos de datos, manteniendo así su diseño organizado y limpio. Los parámetros se pueden utilizar tanto como parte de funciones y consultas SQL como 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 poderosa herramienta amplía enormemente las posibilidades de análisis, permitiéndole 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 tabla, en una palabra, y dondequiera que 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, debe hacer clic en el botón Administrador de catálogos en la esquina superior izquierda de la barra de herramientas.

En la ventana que se abre, a la izquierda, seleccione el elemento Parámetros, luego haga clic en el botón "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án 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 de Configuración seleccionaremos Bind with Single Column. En la siguiente línea de Fuente de datos, elegiremos la tabla desde la cual se realizará la selección. En nuestro caso, se trata de los diputados. 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 hacer eso, desplácese hacia abajo en la lista de propiedades, busque la línea Importar SQL y haga clic en ella.

Aparecerá una ventana de creación de solicitud. Ya ha registrado previamente la cadena de selección de la columna member_count: el número total de participantes. Sólo necesitamos agregar la condición “where Developer = 1”. Podemos verificar la solicitud haciendo clic en el botón Verificar y, si tiene éxito, debe hacer clic en Aceptar. 

Después de completar los pasos anteriores, haga clic en Aceptar 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, cierre la ventana del Administrador de Catálogos y pruebe el parámetro recién creado. Para hacerlo, arrástrelo a la página del informe y haga clic en Ver. Después de completar este paso, se le pedirá que acepte el valor del parámetro tomado de la base de datos actual, así que haga clic en Aceptar. 

¡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 eso, hay que repetir los mismos pasos que tomamos al crear el parámetro. Déjame recordarte. Haz clic en el Administrador de Catálogos, seleccione Fórmulas y luego Nueva fórmula en la esquina superior izquierda.

Antes de que aparezca la ventana de creación de fórmulas, se nos pedirá que ingresemos un nombre para la fórmula.

Después de eso, se abrirá el IDE para que pueda escribir código en Java. Integrado en InterSystems Reports, el compilador le permite escribir funciones cortas sin definir clases ni métodos. Para calcular el porcentaje, necesitamos dividir nuestro nuevo parámetro por 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 (impulsada por AtScale). Así, obtuvimos la siguiente fórmula. Preste atención a la función que le permite escribir comentarios en el código. Un código bien documentado facilitará que otros trabajen con sus fórmulas.

Después de escribir, puede verificar si el código resultante tiene algún error haciendo clic en el botón de marca de verificació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, haga clic en el botón Guardar y la fórmula aparecerá en el catálogo.

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

Esta función se puede utilizar como indicador para gráficos y tablas. Le 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 la dimensión month_year_num en el eje x. Resultó una tendencia muy visual y lo hicimos en apenas unos minutos. 

Ahora es el momento de mirar las etiquetas. 

Están incrustados en la página del informe desde la pestaña Insertar con el botón Etiqueta.

.

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

La funcionalidad incorporada le 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 ayudarlo a diseñar una etiqueta. Para que aparezcan, seleccione el widget Etiqueta.

Para configurar los bordes del widget, desplácese hacia abajo hasta la categoría Borde. Seleccione los 4 bordes: Línea inferior, Línea izquierda, Línea derecha y Línea superior, y configúrelos todos en Sólido.

Para rellenar el fondo, debe desplazarse por las propiedades hasta la categoría Color y seleccionar el tono deseado. Se puede hacer lo mismo en la pestaña Formato en la barra de herramientas en la parte superior.

Si desea seleccionar el tamaño de fuente, permanezca en la misma pestaña Formato, haga clic en el menú desplegable con tamaños y elija el que desee. También 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, utilice 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 Geometría en el panel de propiedades del widget a la izquierda.

En este artículo, intentamos cubrir tres características básicas de InterSystems Reports (con tecnología de Logi Report). Es por eso que esperamos que a estas alturas sepas cómo crear fórmulas, parámetros y etiquetas con gran confianza.