Skip to main content
El módulo Reporter usa un pequeño conjunto de objetos centrales. Se conectan entre sí, pero el operador no siempre empieza creando una fuente de datos. En algunos entornos, las fuentes de datos internas para productos Lerian como Midaz o CRM ya están configuradas.

​
Flujo principal

Reporter tiene dos rutas de entrada comunes:
  • Datos de producto interno ya configurados: Template → Report → Download
  • Conexión de datos externa o ausente: Data Source → Template → Report → Download
  • La Plantilla indica cómo debe verse el informe y en qué formato.
  • La fuente de datos indica de dónde provienen los datos. Puede ya existir para productos internos. Para bases de datos externas, la agregas manualmente.
  • El Informe es el archivo que Reporter produce cuando ejecuta una Plantilla contra los datos conectados. Los filtros pueden acotar el resultado.
  • La descarga es la acción del operador que saca el archivo terminado de la Console.

​
Qué significa cada objeto

​
Cuándo una Plantilla se convierte en un Informe

Una Plantilla por sí sola es solo una definición. Se convierte en un Informe cuando haces clic en Generate Report en el asistente de 4 pasos de la página Reports. En ese momento:
  1. Reporter toma la Plantilla seleccionada.
  2. Aplica los filtros que configuraste.
  3. Lee desde las fuentes de datos referenciadas por la Plantilla.
  4. Produce un archivo en el formato de salida de la Plantilla y lo agrega a la lista de Reports con estado Processing.
  5. Cuando la generación termina, el estado pasa a Finished y el archivo se vuelve descargable.

​
Qué campos realmente importan

Cuando los operadores se atascan, suele ser por el mismo puñado de campos.

​
Al revisar o agregar una fuente de datos

  • Connection Name: Cómo aparece la conexión en el resto de lugares (en plantillas, en filtros de informes). Para fuentes de datos externas, elige algo que identifique el entorno, no solo el motor (por ejemplo, production-db, no solo postgres).
  • Database Type: Selecciona PostgreSQL o MongoDB. Determina el puerto predeterminado y el controlador de conexión.
  • Host / Port / Database Name / Username / Password: Lo mínimo necesario para alcanzar la base de datos.
  • Schemas (PostgreSQL): Limita a qué esquemas puede acceder Reporter. Déjalo vacío para usar el valor predeterminado (public).
  • SSL Configuration: Opcional, pero úsala siempre que no confíes completamente en la ruta de red.

​
Al agregar una plantilla

  • Archivo .tpl (modo de carga): La definición real de la plantilla. Obligatorio.
  • Template Name: Cómo aparece la Plantilla en las listas y los selectores.
  • Output Format: Fija el tipo de archivo final (CSV, XML, HTML, TXT o PDF). Cuando seleccionas PDF en Template Builder, el código generado es HTML, renderizado como PDF en el momento de la generación.

​
Al generar un informe

  • Template: La Plantilla que quieres ejecutar.
  • Filters (opcional): Cada fila es Database + Table + Field + Operator + Value(s). Usa los filtros para producir un subconjunto más acotado sin editar la Plantilla.

​
Lectura práctica de la UI

Usa esta interpretación cuando guíes a los usuarios:
  • Templates define cómo debe verse la salida.
  • Reports es donde la estructura y los datos se combinan y producen un archivo.
  • Data Sources define qué puede leer Reporter. Úsala para inspeccionar conexiones existentes, probar la conectividad o agregar bases de datos externas.
  • Overview es el panel operativo: KPI, el calendario de entregas y los recordatorios de entregas próximas o vencidas.

​
Cuándo suelen perderse los usuarios

Una Plantilla es una definición. Un Informe es un archivo generado. Puedes generar muchos Informes a partir de la misma Plantilla a lo largo del tiempo (cada uno con sus propios filtros, fecha de ejecución y estado).
La fuente de datos es la conexión que usa Reporter para leer datos. Un Filtro es una restricción por ejecución que no cambia la Plantilla ni la fuente de datos, solo los datos que incluye el Informe actual.
Template Builder genera código .tpl a partir de los bloques que ensamblas en la Console. Subir un .tpl omite el constructor y usa un archivo preparado externamente. Ambos terminan siendo el mismo tipo de Plantilla, pero solo las plantillas creadas con el constructor pueden volver a editarse en el editor visual.
Cuando un Informe llega a Finished, Reporter ya produjo el archivo y puedes descargarlo. Los recordatorios de la página Overview rastrean la entrega por separado, como enviar el archivo a un regulador o archivarlo.
Combina esta página con Ruta de configuración al incorporar nuevos usuarios. Una página explica el modelo. La otra explica el orden.