> ## 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 ou o formato de saída de um Template, ou substitua o arquivo .tpl enviado, diretamente do Console da Lerian, sem excluir e recriar o template.

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

## Objetivo

***

Atualize o Template reutilizável que Relatórios futuros vão usar.

Por exemplo, atualize um Template quando o responsável pelo relatório mudar as colunas CSV exigidas. Atualize-o quando o formato de saída deve ser XML em vez de TXT. Atualize-o quando o nome do Template for genérico demais para os operadores identificarem com segurança.

## Quando usar

***

Use esta tarefa quando:

* você ainda precisa do Template.
* o nome ou o formato de saída está errado.
* um arquivo `.tpl` enviado precisa de substituição.
* um Template do Template Builder precisa de edições no nível de bloco.
* Relatórios futuros devem usar o Template corrigido.

Não use esta tarefa para alterar 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 o tipo de Template que você deve editar:

* **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 se aplica a Relatórios futuros. Relatórios já gerados a partir do Template antigo continuam sem alteração.

<Warning>
  Substituir um arquivo `.tpl` afeta todos os Relatórios futuros gerados a partir deste Template. Valide o novo arquivo antes de usá-lo em um ciclo de geração de relatórios.
</Warning>

## Passo a passo

***

<Steps>
  <Step title="Abrir a página Templates">
    Acesse **Templates** e localize o Template que você precisa atualizar.
  </Step>

  <Step title="Abrir 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="Editar 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 do Template (.tpl)**.
  </Step>

  <Step title="Salvar as mudanças">
    Clique em **Atualizar Template**.
  </Step>

  <Step title="Gerar 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 o **Template Builder** abrem no builder quando editados. Templates enviados como arquivos `.tpl` abrem no assistente de upload/edição.
</Note>

## Guia de campos

***

| Campo                          | O que mudar                                                                                                                     | Exemplo                                               |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------- |
| **Nome do Template**           | Rótulo obrigatório no Console para os operadores. Ele é mapeado para `name` no Console e para `description` na API do Reporter. | `Monthly tax XML`                                     |
| **Formato de Saída**           | Tipo de arquivo para Relatórios futuros. Use um entre `csv`, `xml`, `html`, `txt` ou `pdf`.                                     | `xml`                                                 |
| **Arquivo do Template (.tpl)** | Arquivo de substituição opcional. Se enviado, deve ser `.tpl`, maior que 0 bytes e no máximo 1 MiB.                             | Substitua `tax-v1.tpl` por `tax-v2.tpl`               |
| Blocos do builder              | Estrutura visual para Templates criados no builder. Salvar exige pelo menos um bloco válido.                                    | Adicione um bloco de **Agregação** de **Valor total** |

## Resultado esperado

***

O Template continua na página **Templates** com a configuração atualizada. Relatórios futuros 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 Relatórios já gerados. Gere um novo Relatório depois de corrigir o Template.
  </Accordion>

  <Accordion title="Substituir o arquivo sem verificar o formato de saída">
    Se a estrutura do arquivo `.tpl` e o **Formato de Saída** não corresponderem ao formato de entrega esperado, os operadores podem gerar o tipo de arquivo errado.
  </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/products/reporter/console/generating-a-report) para testar o Template atualizado.
* Use [Corrigir um Relatório](/pt/products/reporter/console/editing-a-report) se você encontrou o problema em um Relatório gerado.
* Use [Excluir um Template](/pt/products/reporter/console/deleting-a-template) apenas se você não precisar mais do Template.

<Card title="Equivalente na API" type="tip" horizontal>
  [Endpoint de atualização de templates](/pt/reference/products/reporter/update-templates)
</Card>