> ## 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.

# Añadir un Template

> Crea un Template en Reporter usando Template Builder o subiendo un archivo .tpl preparado.

Usa esta página para crear el Template que Reporter usará para generar un Report. Un Template es la estructura reutilizable del archivo de salida: define el diseño, los campos, las condiciones, los bucles, los cálculos y el formato final.

## Objetivo

***

Añadir un Template que los operadores puedan seleccionar al generar Reports.

Por ejemplo, un Template fiscal mensual puede definir una cabecera CSV, una fila por transacción y un monto total al final del archivo. Un Template XML regulatorio puede definir las etiquetas XML requeridas y rellenarlas con valores de un Data Source.

## Cuándo usarlo

***

Usa esta tarea cuando:

* estás configurando el primer Template para un informe cuyo Data Source ya existe;
* una nueva obligación de informe requiere una nueva estructura de salida;
* tu equipo ya tiene un archivo `.tpl` revisado y necesita ponerlo disponible en la Console;
* un operador necesita construir el Template visualmente en lugar de editar código `.tpl`.

No uses esta tarea para arreglar un Template que ya existe. Usa [Actualizar un Template](/es/lerian-console/reporter-console/updating-a-template) en su lugar.

## Antes de empezar

***

Confirma:

* el Data Source que alimentará el Template está disponible cuando el Template necesite campos de base de datos. Puede ser una fuente interna ya configurada para el entorno o una externa añadida desde **Data Sources**;
* se conoce el formato de salida esperado: CSV, XML, HTML, TXT o PDF;
* el Template se creará en **Template Builder** o se subirá como archivo `.tpl`;
* el responsable del informe ha confirmado los campos que deben aparecer en la salida.

<Note>
  Un Template no es un Report generado. Es la definición reutilizable que Reporter aplica más tarde durante la generación.
</Note>

## Opción 1: Construir en Template Builder

***

Usa Template Builder cuando un operador necesite ensamblar el Template visualmente a partir de bloques.

<Steps>
  <Step title="Abre Template Builder">
    Ve a la página **Templates** y haz clic en **Template Builder**.
  </Step>

  <Step title="Nombra el Template">
    Usa un nombre que los operadores puedan reconocer después, como `Monthly tax CSV` o `Daily transaction PDF`.
  </Step>

  <Step title="Elige el formato de salida">
    Selecciona el formato que debe producir el Report generado: XML, HTML, CSV, TXT o PDF.
  </Step>

  <Step title="Añade los bloques del Template">
    Añade 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.
  </Step>

  <Step title="Conecta campos a los datos">
    Usa la barra lateral de Data Sources para seleccionar campos de la conexión configurada. Por ejemplo, usa un bloque **Variable** para colocar `transactions.amount` en la salida.
  </Step>

  <Step title="Guarda el Template">
    Haz clic en **Save** para validar los bloques y guardar el archivo `.tpl` generado.
  </Step>
</Steps>

## Opción 2: Subir un archivo `.tpl`

***

Usa la subida cuando un equipo técnico ya mantiene el Template fuera de la Console.

<Steps>
  <Step title="Abre el wizard de subida">
    Ve a la página **Templates** y haz clic en **New Template**.
  </Step>

  <Step title="Sube el archivo">
    En el paso **File**, arrastra el archivo `.tpl` a **Drag file here**, o haz clic en **to select** para buscar en tu equipo.
  </Step>

  <Step title="Configura el Template">
    En el paso **Config**, rellena **Template Name** y **Output Format**.
  </Step>

  <Step title="Revisa el resumen">
    En el paso **Review**, confirma el archivo, el nombre y el formato de salida. Usa los botones de edición si algún campo es incorrecto.
  </Step>

  <Step title="Guarda el Template">
    Haz clic en **Save Template**.
  </Step>
</Steps>

<Tip>
  **API equivalente**: [Endpoint Upload template](/es/reference/reporter/upload-template)
</Tip>

## Guía de campos

***

### Campos del wizard de subida

| Campo                    | Qué introducir                                                                                                                        | Ejemplo           |
| ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------- | ----------------- |
| **Template File (.tpl)** | Archivo `.tpl` obligatorio usado como fuente del Template. Debe ser mayor que 0 bytes y no superior a 5 MB. Campo de API: `template`. | `monthly-tax.tpl` |
| **Template Name**        | Nombre obligatorio visible al operador. Se mapea a `name` en la Console y a `description` en la API de Reporter.                      | `Monthly tax CSV` |
| **Output Format**        | Tipo obligatorio de salida. Usa `csv`, `xml`, `html`, `txt` o `pdf`.                                                                  | `csv`             |

### Campos de Template Builder

| Campo                         | Qué introducir                                                                                                                                           | Ejemplo                                                                  |
| ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| **Template name**             | Nombre obligatorio en el encabezado del builder. Se convierte en el nombre guardado del Template y en el prefijo del nombre del archivo `.tpl` generado. | `Daily transaction PDF`                                                  |
| Barra de bloques              | Añade al menos un bloque antes de guardar. Los bloques se convierten en el código `.tpl` generado.                                                       | Cabecera **Text** + **Loop** sobre transacciones + **Aggregation** total |
| Barra lateral de Data Sources | Usa los Data Sources configurados para insertar campos en bloques **Variable**. Los campos técnicos incluyen `dataSource`, `table` y `field`.            | `production-postgres.transactions.amount`                                |

## Resultado esperado

***

Tras guardar, el Template aparece en la página **Templates** y puede seleccionarse en el wizard **Generate Report**.

## Errores comunes y puntos de atención

***

<AccordionGroup>
  <Accordion title="Subir un archivo que no es `.tpl`">
    La subida solo acepta archivos `.tpl`. Si el Template aún se está diseñando, usa primero **Template Builder** o prepara el archivo `.tpl` fuera de la Console.
  </Accordion>

  <Accordion title="Elegir el formato de salida incorrecto">
    El formato de salida controla qué tipo de archivo descargarán los operadores tras generar un Report. Confirma el formato requerido antes de guardar.
  </Accordion>

  <Accordion title="Crear un Template antes de que el Data Source esté listo">
    Los Templates pueden referenciar campos de Data Sources. Si la fuente requerida falta o no está probada, los operadores pueden no saber qué campos son seguros usar.
  </Accordion>
</AccordionGroup>

## Pasos siguientes

***

* Usa [Generar un Report](/es/lerian-console/reporter-console/generating-a-report) para crear un Report a partir del Template.
* Usa [Actualizar un Template](/es/lerian-console/reporter-console/updating-a-template) si la estructura, el archivo, el nombre o el formato de salida necesitan corrección.
* Usa el [Template Builder](/es/lerian-console/reporter-console/template-builder) cuando los operadores necesiten mantener el Template visualmente.