Objetivo
Agrega una plantilla que los operadores puedan seleccionar al generar informes. Por ejemplo, una plantilla de impuestos mensuales puede definir un encabezado CSV, una fila por transacción y un monto total al final del archivo. Una plantilla XML regulatoria puede definir las etiquetas XML necesarias y completarlas con valores de una fuente de datos.
Cuándo usarlo
Usa esta tarea cuando:
- configuras la primera plantilla para un informe cuya fuente de datos ya existe
- una nueva obligación de informes requiere una nueva estructura de salida
- tu equipo ya tiene un archivo
.tplrevisado y necesita ponerlo a disposición en la Console - un operador necesita construir la plantilla de forma visual en lugar de editar código
.tpl
Antes de empezar
Confirma lo siguiente:
- la fuente de datos que alimentará la plantilla está disponible cuando 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
- conoces el formato de salida esperado: CSV, XML, HTML, TXT o PDF
- la plantilla se creará en Template Builder o se subirá como un archivo
.tpl - el responsable del informe confirmó los campos que deben aparecer en la salida
Una plantilla es la definición reutilizable que Reporter aplica más adelante durante la generación de informes. No es el informe generado en sí.
Opción 1: Construir en Template Builder
Usa Template Builder cuando un operador necesita ensamblar la plantilla de forma visual a partir de bloques.
1
Abre Template Builder
Ve a la página Templates y haz clic en Template Builder.
2
Nombra la plantilla
Usa un nombre que los operadores puedan reconocer después, como
Monthly tax CSV o Daily transaction PDF. Luego ingresa la Category, la familia del informe, como cadoc.3
Elige el formato de salida
Selecciona el formato que debe producir el informe generado: XML, HTML, CSV, TXT o PDF.
4
Agrega los bloques de la plantilla
Agrega bloques como Text, Variable, Loop, Conditional o Aggregation. En la práctica, los bloques representan las piezas del archivo final: texto fijo, valores de base de datos, filas repetidas, secciones condicionales o totales.
5
Conecta los campos con los datos
Usa la barra lateral de Data Sources para seleccionar campos de la conexión de base de datos configurada. Por ejemplo, usa un bloque Variable para colocar
transactions.amount en la salida.6
Guarda la plantilla
Haz clic en Save para validar los bloques y guardar el archivo
.tpl generado.Opción 2: Subir un archivo .tpl
Usa la carga cuando un equipo técnico ya mantiene la plantilla fuera de la Console.
1
Abre el asistente de carga
Ve a la página Templates y haz clic en New Template.
2
Sube el archivo
En el paso File, arrastra el archivo
.tpl a Drag file here, o haz clic en to select para explorar tu computadora.3
Configura la plantilla
En el paso Config, completa Template Name, Output Format y Category.
4
Revisa el resumen
En el paso Review, confirma el archivo, el nombre, el formato de salida y la categoría. Usa los botones de edición si algún campo está incorrecto.
5
Guarda la plantilla
Haz clic en Save Template.
Guía de campos
Campos del asistente de carga
Campos de Template Builder
Resultado esperado
Después de guardar, la plantilla aparece en la página Templates y se puede seleccionar en el asistente Generate Report.
Errores comunes y puntos de atención
Subir un archivo que no es .tpl
Subir un archivo que no es .tpl
La carga solo acepta archivos
.tpl. Si la plantilla no es definitiva, usa primero Template Builder o prepara el archivo .tpl fuera de la Console.Elegir el formato de salida incorrecto
Elegir el formato de salida incorrecto
El formato de salida controla qué tipo de archivo descargarán los operadores después de generar un informe. Confirma el formato necesario antes de guardar.
Crear una plantilla antes de que la fuente de datos esté lista
Crear una plantilla antes de que la fuente de datos esté lista
Las plantillas pueden hacer referencia a campos de las Data Sources. Es posible que los operadores no sepan qué campos son seguros de usar cuando la fuente necesaria está ausente o no tiene un resultado de prueba.
Próximos pasos
- Usa Generar un informe para crear un informe a partir de la plantilla.
- Usa Actualizar una plantilla si la estructura, el archivo, el nombre o el formato de salida necesitan corrección.
- Usa Template Builder para construir otra plantilla de forma visual.