Skip to main content
Usa Template Builder para crear o mantener una plantilla de forma visual. El constructor convierte los bloques en código .tpl, de modo que los operadores puedan definir la estructura del informe sin escribir manualmente el archivo de la plantilla.

​
Objetivo

Construye una plantilla a partir de bloques visuales y guárdala para la futura generación de informes. Por ejemplo, una plantilla de transacciones mensuales puede usar texto fijo para el encabezado y un Loop para cada fila de transacción. También puede usar bloques Variable para campos como el monto y la fecha, y un bloque Aggregation para el total.

​
Cuándo usarlo

Usa Template Builder cuando:
  • los operadores necesitan crear una plantilla sin editar código .tpl.
  • una plantilla de Template Builder necesita mantenimiento visual.
  • la estructura del informe depende de campos, bucles, condiciones o totales de una fuente de datos.
  • el equipo quiere descargar el archivo .tpl generado después de construirlo.
Usa la carga de .tpl en su lugar cuando un equipo técnico ya creó y revisó la plantilla fuera de la Console.

​
Antes de empezar

Confirma:
  • existe al menos una fuente de datos relevante si la plantilla necesita campos de base de datos. Puede ser una fuente interna ya configurada para el entorno o una fuente externa agregada desde Data Sources.
  • probaste la fuente de datos cuando el estado de la conexión o la visibilidad del esquema son inciertos. Sus tablas y campos quedan entonces disponibles en la barra lateral.
  • conoces el formato de salida esperado: XML, HTML, CSV, TXT o PDF.
  • el operador conoce la estructura del informe, como el encabezado obligatorio, las filas, los totales o las secciones condicionales.
Los bloques definen la estructura de salida. Los filtros aplicados durante la generación del informe definen qué registros entran en esa estructura.

​
Paso a paso

1

Abre el constructor

Ve a la página Templates y haz clic en Template Builder.
2

Nombra la plantilla

Edita el nombre de la plantilla en el encabezado. Usa un nombre que los operadores puedan identificar durante la generación del informe.
3

Elige el formato de salida

Selecciona XML, HTML, CSV, TXT o PDF.
Cuando seleccionas PDF, el código de plantilla generado usa formato HTML. El código se convierte a PDF durante la generación del informe.
4

Agrega bloques al lienzo

Usa la barra de herramientas de bloques para agregar estructura. Los bloques comunes son Text, Variable, Loop, Conditional y Aggregation.
5

Conecta campos desde Data Sources

Usa la barra lateral de Data Sources para explorar esquemas, tablas y campos. Haz clic en un campo para agregar un bloque Variable para ese campo.
6

Revisa el código generado cuando sea necesario

Cambia de Visual a Code para inspeccionar la vista previa del .tpl generado. La vista de código es para revisión y copia/descarga, no para edición manual.
7

Guarda la plantilla

Haz clic en Save. El constructor valida los campos de bloque obligatorios, genera el código .tpl y guarda la plantilla.

​
Guía de campos

​
Campos y controles del constructor

​
Guía de campos de bloques

​
Tipos de bloque

​
Trabajar con bloques

  • Haz clic en un tipo de bloque en la barra de herramientas para agregarlo al lienzo.
  • Arrastra los bloques para reordenar la salida.
  • Configura cada bloque en línea. Por ejemplo, un Variable necesita una fuente y un campo, mientras que un Conditional necesita una condición.
  • Usa Inline cuando el bloque deba renderizarse sin un salto de línea después.
  • Usa Trim whitespace para eliminar espacios adicionales alrededor de la salida del bloque.
  • Usa Duplicate para copiar un bloque configurado.
  • Usa Delete para eliminar un bloque de la plantilla.
Los bloques contenedores como Loop, Conditional, Section y With pueden contener bloques hijos. Úsalos cuando la salida necesite contenido repetido o agrupado.

​
Resultado esperado

Después de guardar, la plantilla aparece en la página Templates. Puedes seleccionarla en el asistente Generate Report. También puedes descargar el archivo .tpl generado desde el constructor.

​
Errores comunes y puntos de atención

La barra lateral solo muestra las Data Sources configuradas. Si la fuente interna esperada no aparece, confirma la configuración con el administrador de Reporter. Si el informe necesita una base de datos externa, agrega y prueba esa fuente de datos antes de usar campos de base de datos en la plantilla.
El constructor valida los bloques durante el guardado. Si un bloque no tiene fuente, campo, condición o expresión, corrige ese bloque antes de guardar.
Los bloques de la plantilla definen la estructura del archivo. Los filtros del informe se seleccionan después, durante la generación del informe. Ellos deciden qué registros entran en la salida.
La salida en PDF proviene de HTML. Construye la plantilla como contenido compatible con HTML cuando el formato de salida final es PDF.

​
Próximos pasos

Equivalente en la API

No existe un endpoint de API separado para el constructor visual. Usa Endpoint de carga de plantilla con un archivo .tpl preparado.