Skip to main content
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.
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.

​
Passo a passo

1

Abra a página Templates

Vá para Templates e localize o Template que precisa atualizar.
2

Abra a ação de edição

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

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).
4

Salve as alterações

Clique em Atualizar Template.
5

Gere 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 Template Builder abrem no builder ao serem editados. Templates enviados como arquivos .tpl abrem no wizard de envio/edição.

​
Guia de campos

​
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

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

API equivalente

Endpoint Update templates