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

# Atualizar um Template

> Atualize o nome, o formato de saída ou substitua o arquivo .tpl enviado de um Template direto pela interface do Lerian Console.

Use esta página quando um Template deve continuar disponível, mas algo no nome, formato de saída, layout ou arquivo de origem precisar mudar.

## Objetivo

***

Atualizar o Template reutilizável que os futuros Relatórios usarão.

Por exemplo, atualize um Template quando o responsável pelo relatório alterar as colunas CSV exigidas, o arquivo precisar ser gerado em XML em vez de TXT, ou o nome do Template estiver genérico demais para os operadores identificarem com segurança.

## Quando usar

***

Use esta tarefa quando:

* o Template ainda é necessário;
* o nome ou o formato de saída está errado;
* um arquivo `.tpl` enviado precisa ser substituído;
* um Template do Template Builder precisa de edições no nível de bloco;
* os futuros Relatórios devem usar o Template corrigido.

Não use esta tarefa para mudar um Relatório já gerado. Relatórios gerados são arquivos históricos. Corrija a configuração de origem e gere um novo Relatório.

## Antes de começar

***

Verifique que tipo de Template você está editando:

* **Template enviado**: atualize o nome, o formato de saída ou substitua o arquivo `.tpl`.
* **Template do Template Builder**: abra o builder, edite os blocos e salve o `.tpl` gerado.

Confirme que a mudança é para futuros Relatórios. Relatórios já gerados a partir do Template antigo ficam inalterados.

<Warning>
  Substituir um arquivo `.tpl` afeta cada Relatório futuro gerado a partir deste Template. Valide o novo arquivo antes de usá-lo em um ciclo de reporting.
</Warning>

## Passo a passo

***

<Steps>
  <Step title="Abra a página Templates">
    Vá para **Templates** e localize o Template que precisa atualizar.
  </Step>

  <Step title="Abra a ação de edição">
    Clique nos três pontos (<Icon icon="ellipsis-vertical" />) na coluna **Ações** e selecione **Editar**.
  </Step>

  <Step title="Edite os campos do Template">
    Em **Editar Template**, atualize os campos que mudaram. Para Templates enviados, você pode alterar **Nome do Template**, **Formato de Saída** e **Arquivo de Template (.tpl)**.
  </Step>

  <Step title="Salve as alterações">
    Clique em **Atualizar Template**.
  </Step>

  <Step title="Gere um Relatório de teste">
    Gere um novo Relatório com o Template atualizado e confirme que a saída corresponde à estrutura esperada.
  </Step>
</Steps>

<Note>
  Templates criados com **Template Builder** abrem no builder ao serem editados. Templates enviados como arquivos `.tpl` abrem no wizard de envio/edição.
</Note>

## Guia de campos

***

| Campo                          | O que alterar                                                                                                            | Exemplo                                           |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------- |
| **Nome do Template**           | Rótulo obrigatório no Console para os operadores. Mapeia para `name` no Console e para `description` na API do Reporter. | `Monthly tax XML`                                 |
| **Formato de Saída**           | Tipo de arquivo para futuros Relatórios. Use `csv`, `xml`, `html`, `txt` ou `pdf`.                                       | `xml`                                             |
| **Arquivo de Template (.tpl)** | Arquivo substituto opcional. Se fornecido, deve ser `.tpl`, maior que 0 bytes e não superior a 5 MB.                     | Substituir `tax-v1.tpl` por `tax-v2.tpl`          |
| Blocos do builder              | Estrutura visual para Templates criados pelo builder. Salvar exige pelo menos um bloco válido.                           | Adicionar um bloco **Agregação** **Total amount** |

## Resultado esperado

***

O Template permanece na página **Templates** com a configuração atualizada. Os futuros Relatórios gerados a partir dele usam o novo nome, formato de saída e estrutura do Template.

## Erros comuns e pontos de atenção

***

<AccordionGroup>
  <Accordion title="Esperar que Relatórios antigos mudem">
    Atualizar um Template não reescreve os Relatórios já gerados. Gere um novo Relatório após corrigir o Template.
  </Accordion>

  <Accordion title="Substituir o arquivo sem conferir o formato de saída">
    Se a estrutura do arquivo `.tpl` e o **Formato de Saída** não baterem com o formato de entrega esperado, os operadores podem gerar o tipo errado de arquivo.
  </Accordion>

  <Accordion title="Renomear sem contexto operacional">
    Nomes como `Template 1` ou `New Template` são difíceis de distinguir durante a geração de relatórios. Use um nome que inclua o propósito ou o período do relatório.
  </Accordion>
</AccordionGroup>

## Próximos passos

***

* Use [Gerar um Relatório](/pt/lerian-console/reporter-console/generating-a-report) para testar o Template atualizado.
* Use [Corrigir um Relatório](/pt/lerian-console/reporter-console/editing-a-report) se o problema foi encontrado em um Relatório gerado.
* Use [Excluir um Template](/pt/lerian-console/reporter-console/deleting-a-template) apenas se o Template não for mais necessário.

<Card title="API equivalente" type="tip" horizontal>
  [Endpoint Update templates](/pt/reference/reporter/update-templates)
</Card>