Pular para o conteúdo principal
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

CampoO que alterarExemplo
Nome do TemplateRó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ídaTipo 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 builderEstrutura 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

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