Dinaup DocsInformes
Crea listados y consultas sobre cualquier sección de Flex sin escribir SQL: filtros, columnas calculadas, roles, visibilidad, parámetros y consumo por API.
Un informe es una configuración que produce un listado de datos a partir de una sección. Eliges qué columnas quieres, cómo filtrarlas, cómo agruparlas y ordenarlas, y obtienes una consulta reutilizable: para verla en pantalla, exportarla o consumirla desde la API. Todo sin escribir SQL.
Un informe siempre nace de una sección. La sección es el origen de los datos (las "tablas" de Flex); el informe es la vista que defines sobre ella. Antes de crear un informe, ten clara la sección de la que vas a partir.
Qué puedes hacer con un informe
| Capacidad | Para qué sirve |
|---|---|
| Selección de columnas | Eliges exactamente qué campos de la sección aparecen en el listado, incluidos datos de secciones relacionadas. |
| Filtrado rápido | Acotas los resultados con condiciones sobre los campos (igual, distinto, contiene, entre desde y hasta…) sin escribir nada de código. |
| Filtro por algoritmo | Cuando la condición es un cálculo y no un campo directo, un algoritmo decide qué filas entran. |
| Columnas calculadas | Añades columnas cuyo valor lo produce un algoritmo: totales, búsquedas en otras secciones, agregados de registros relacionados. |
| Rol de columna | Le dices al informe qué tipo de dato es una columna (moneda, porcentaje, cantidad…) para que la formatee y la trate bien. |
| Visibilidad de columna | Controlas cuándo se muestra u oculta una columna sin tener que quitarla del informe. |
| Agrupación y ordenación | Agrupas filas por uno o varios campos y ordenas el resultado como necesites. |
| Preguntas dinámicas | El informe pregunta parámetros al usuario antes de ejecutarse (por ejemplo, un rango de fechas) y filtra con su respuesta. |
| Consumo por API | Expones el informe como endpoint para que sistemas externos lean sus datos de forma estandarizada. |
Filtrado: rápido o por algoritmo
Hay dos formas de acotar qué filas devuelve un informe, y se combinan:
- Filtrado rápido: condiciones directas sobre los campos de la sección. Eliges un campo, un operador y un valor (o un parámetro). Es el filtro del día a día y no requiere código.
- Filtro por algoritmo: cuando lo que decide la pertenencia de una fila es un cálculo (un total, una comparación derivada, un dato de otra sección), un algoritmo resuelve la condición.
Las preguntas dinámicas (también llamadas variables del informe) convierten un filtro fijo en uno interactivo: el sistema pregunta el valor al usuario justo antes de ejecutar la consulta. El caso más habitual es delimitar un periodo temporal.
→ Guía: Filtrar informe por rango de fechas
Columnas calculadas, agrupación y ordenación
Un informe no se limita a volcar campos tal cual:
- Columnas calculadas: el valor de la columna lo genera un algoritmo. Sirve para sumar líneas de un documento, traer el nombre de un registro relacionado o calcular un importe derivado, todo dentro del propio listado.
- Agrupación: juntas las filas por uno o varios campos para obtener subtotales y resúmenes en lugar del detalle fila a fila.
- Ordenación: defines el orden del resultado por las columnas que elijas.
Los cálculos de un informe se apoyan en algoritmos, que se ejecutan como consultas SQL optimizadas. Entender los tipos de algoritmo (lineal, cruzado, búsqueda…) te ayuda a decidir qué columna calculada o qué filtro necesitas. → Algoritmos
Rol de una columna
El rol le dice al informe qué clase de dato representa una columna. No cambia el valor: cambia cómo se interpreta, se formatea y se trata en pantalla, en los totales y en la exportación. Por defecto una columna es automática, y el informe deduce su trato por el formato del campo. Cuando ese trato automático no acierta, fijas el rol a mano.
| Rol | Cuándo usarlo |
|---|---|
| Automático | El informe decide el trato de la columna según el tipo del campo. Es el valor por defecto y vale para la mayoría de columnas. |
| Moneda | La columna es un importe. Se presenta como dinero (decimales y símbolo monetario) y se comporta como tal en sumas y totales. |
| Porcentaje | La columna es un tanto por ciento. Se muestra en formato porcentual en lugar de como número suelto. |
| Cantidad | La columna es una cantidad asociada al propósito del informe (por ejemplo, unidades). El informe la trata como su magnitud principal. |
| Última vez visto | Marca la columna que representa la fecha/momento de última actividad, para usarla como referencia temporal del registro. |
El rol es sobre todo formato y semántica: una columna con rol Moneda se ve y se suma como dinero. Si una cifra aparece sin símbolo de moneda o un porcentaje sale como número crudo, casi siempre se arregla fijando el rol correcto.
Visibilidad de una columna
La visibilidad controla cuándo aparece una columna sin obligarte a eliminarla del informe. Es útil para tener columnas que solo importan en ciertos contextos, o que el informe necesita para calcular o filtrar pero que no quieres mostrar.
| Visibilidad | Comportamiento |
|---|---|
| Siempre visible | La columna aparece en todos los casos. |
| Siempre oculta | La columna nunca se muestra, pero sigue formando parte del informe (sirve para cálculos o filtros internos sin ensuciar el listado). |
| Automática | El informe decide si mostrarla según el contexto. Es el comportamiento por defecto. |
| Oculta en complementos | La columna se ve en el informe principal, pero se oculta cuando el informe se usa como complemento dentro de otra vista. |
Ocultar una columna no es lo mismo que quitarla. Una columna oculta sigue calculándose y puede usarse para filtrar, agrupar u ordenar; solo deja de mostrarse. Quítala del informe solo si de verdad no la necesitas para nada.
Consumir informes desde la API
Cualquier informe puede convertirse en una fuente de datos para integraciones externas. Los informes API son informes normales que cumplen unas convenciones de nombre y categoría para poder consumirse de forma estandarizada. Se dividen en sincronizables y no sincronizables según su complejidad.
Es la vía recomendada para que un sistema externo lea datos de Dinaup: defines el informe una vez y lo consultas como endpoint, sin acoplarte a la estructura interna de la base de datos.
→ Informes API · Integraciones
Subpáginas
Filtrar por rango de fechas
Informes API
→ Filtrar informe por rango de fechas → Informes API → Algoritmos
Impresión de factura emitida
Plantilla completa de documento dinámico que genera el PDF de una factura de venta a partir de una factura concreta, con su DinaScript.
Filtrar informe por rango de fechas
Configura un informe para que pregunte al usuario un rango de fechas antes de ejecutarse, ideal para consultas contables o de ventas por periodo.