> ## Documentation Index > Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt > Use this file to discover all available pages before exploring further. # Agrega una plantilla > Crea una plantilla en Reporter usando Template Builder o subiendo un archivo .tpl preparado, y luego asigna sus fuentes de datos para la generación de informes regulatorios. Usa esta página para crear la plantilla que Reporter usará para generar un informe. Una plantilla es la estructura reutilizable del archivo de salida: define el formato, los campos, las condiciones, los bucles, los cálculos y el formato final. ## 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 `.tpl` revisado 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` No uses esta tarea para corregir una plantilla que ya existe. Usa [Actualizar una plantilla](/es/products/reporter/console/updating-a-template) en su lugar. ## 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. Ve a la página **Templates** y haz clic en **Template Builder**. Usa un nombre que los operadores puedan reconocer después, como `Monthly tax CSV` o `Daily transaction PDF`. Selecciona el formato que debe producir el informe generado: XML, HTML, CSV, TXT o PDF. 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. 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. 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. Ve a la página **Templates** y haz clic en **New Template**. En el paso **File**, arrastra el archivo `.tpl` a **Drag file here**, o haz clic en **to select** para explorar tu computadora. En el paso **Config**, completa **Template Name** y **Output Format**. En el paso **Review**, confirma el archivo, el nombre y el formato de salida. Usa los botones de edición si algún campo está incorrecto. Haz clic en **Save Template**. **Equivalente en la API**: [Endpoint de carga de plantilla](/es/reference/products/reporter/upload-template) ## Guía de campos *** ### Campos del asistente de carga | Campo | Qué ingresar | Ejemplo | | ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------- | ----------------- | | **Template File (.tpl)** | Archivo `.tpl` obligatorio usado como fuente de la plantilla. Debe pesar más de 0 bytes y no más de 1 MiB. Campo de la API: `template`. | `monthly-tax.tpl` | | **Template Name** | Nombre obligatorio visible para el operador. Corresponde a `name` en la Console y a `description` en la API de Reporter. | `Monthly tax CSV` | | **Output Format** | Tipo de salida obligatorio. Usa uno de `csv`, `xml`, `html`, `txt` o `pdf`. | `csv` | ### Campos de Template Builder | Campo | Qué ingresar | Ejemplo | | -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- | | **Template name** | Nombre obligatorio en el encabezado del constructor. Se convierte en el nombre guardado de la plantilla y en el prefijo del nombre de archivo `.tpl` generado. | `Daily transaction PDF` | | Barra de herramientas de bloques | Agrega al menos un bloque antes de guardar. Los bloques se convierten en el código `.tpl` generado. | Encabezado **Text** + **Loop** sobre transacciones + total **Aggregation** | | Barra lateral de Data Sources | Usa las Data Sources configuradas para insertar campos en bloques **Variable**. Los campos técnicos incluyen `dataSource`, `table` y `field`. | `production-postgres.transactions.amount` | ## 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 *** 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. 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. 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](/es/products/reporter/console/generating-a-report) para crear un informe a partir de la plantilla. * Usa [Actualizar una plantilla](/es/products/reporter/console/updating-a-template) si la estructura, el archivo, el nombre o el formato de salida necesitan corrección. * Usa [Template Builder](/es/products/reporter/console/template-builder) cuando los operadores necesiten mantener la plantilla de forma visual.