Skip to main content
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.
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. Para Templates enviados, você pode alterar Nome do Template, Formato de Saída e Arquivo do Template (.tpl).
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.
Templates criados com o Template Builder abrem no builder quando editados. Templates enviados como arquivos .tpl abrem no assistente de upload/edição.

​
Guia de campos

​
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

Atualizar um Template não reescreve Relatórios já gerados. Gere um novo Relatório depois de corrigir o Template.
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.
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

Equivalente na API

Endpoint de atualização de templates