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

***

Todo Template abre no mesmo assistente de edição. Você pode atualizar o nome, o formato de saída e a categoria, ou substituir o arquivo `.tpl`. O Template Builder não abre um Template salvo. Para alterar os blocos de um Template que você montou, monte-o de novo e salve-o como um novo Template, ou substitua o arquivo `.tpl` dele.

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.

## Passo a passo

***

**1. Abrir a página Templates**

Acesse **Templates** e localize o Template que você precisa atualizar.

**2. Abrir a ação de edição**

Clique nos três pontos () na coluna **Ações** e selecione **Editar**.

**3. Editar os campos do Template**

Em **Editar template**, atualize os campos que mudaram: **Nome do Template**, **Formato de Saída**, **Categoria** e **Arquivo do Template (.tpl)**. Se você não enviar um novo arquivo, o arquivo atual permanece.

**4. Salvar as mudanças**

Clique em **Atualizar Template**.

**5. Gerar um Relatório de teste**

Gere um novo Relatório com o Template atualizado e confirme que a saída corresponde à estrutura esperada.

## 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` |
| **Categoria** | Família de relatório obrigatória. | `cadoc` |

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

***

> [accordion] 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] 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] 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.

## Próximos passos

***

* Use [Gerar um Relatório](https://docs.lerian.studio/pt/products/reporter/console/generating-a-report.md) para testar o Template atualizado.
* Use [Corrigir um Relatório](https://docs.lerian.studio/pt/products/reporter/console/editing-a-report.md) se você encontrou o problema em um Relatório gerado.
* Use [Excluir um Template](https://docs.lerian.studio/pt/products/reporter/console/deleting-a-template.md) apenas se você não precisar mais do Template.

> [card] Equivalente na API
>
> [Endpoint de atualização de templates](https://docs.lerian.studio/pt/reference/products/reporter/update-templates.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.