Objetivo
Criar um Relatório gerado para uma necessidade operacional específica, período, entidade, status ou envio. Por exemplo, gere um CSV mensal de transações de maio, um arquivo XML para envio regulatório ou um resumo PDF filtrado por um segmento de clientes.
Quando usar
Use esta tarefa quando:
- o Template está pronto;
- o Data Source usado pelo Template está disponível. Pode ser uma fonte interna já configurada para o ambiente ou uma externa adicionada a partir de Data Sources;
- um operador precisa produzir um arquivo de Relatório;
- o Relatório precisa de filtros opcionais, como intervalo de datas, status, tipo ou entidade.
Antes de começar
Confirme:
- o Template selecionado é o correto para a obrigação;
- o formato de saída do Template corresponde ao arquivo que você precisa entregar;
- o Data Source usado pelo Template está disponível e testado quando o relatório depende de uma conexão que pode ter mudado;
- você sabe se o Relatório deve incluir todos os dados ou um subconjunto filtrado;
- os valores dos filtros são suficientemente precisos para o período de reporting.
Relatórios são gerados de forma assíncrona. Um novo Relatório começa em
Processing e só fica disponível para download quando chega a Finished.Passo a passo
1
Abra a página Relatórios
Vá para Relatórios e clique em Novo Relatório.
2
Selecione o Template
No passo Template, escolha o Template que define a estrutura e o formato de saída. Clique em Próximo.
3
Adicione filtros quando necessário
No passo Filtros, adicione um ou mais filtros para delimitar os dados. Este passo é opcional. Se o Relatório deve incluir todos os dados disponíveis, clique em Próximo.
4
Revise a configuração
No passo Revisão, confira o Template selecionado e os filtros aplicados.
5
Gere o Relatório
Clique em Gerar Relatório. O wizard passa ao passo Gerar e acompanha o progresso enquanto o Reporter cria o arquivo.
6
Monitore o status
Quando a geração termina com sucesso, o wizard oferece as ações Download e Ver na Lista. Se você fechar o wizard antes, o Relatório aparece na lista com status
Processing; espere até chegar a Finished antes de baixar.Guia de campos
Exemplos de filtros
Status e próxima ação
Resultado esperado
Um novo Relatório aparece na página Relatórios. Quando chega a
Finished, os operadores podem pré-visualizar ou baixar o arquivo gerado.
Erros comuns e pontos de atenção
Gerar com o Template errado
Gerar com o Template errado
O Template controla o layout e o formato de saída. Se o Template errado for selecionado, gere um novo Relatório com o Template correto.
Usar um Data Source que não foi testado
Usar um Data Source que não foi testado
Conexões com falha ou desatualizadas podem causar erros de geração. Teste o Data Source antes de gerar Relatórios operacionais quando a saúde da conexão for incerta, especialmente para bancos externos ou credenciais recém-alteradas.
Usar filtros amplos por engano
Usar filtros amplos por engano
Filtros vazios podem incluir todos os dados disponíveis. Confirme se o Relatório deve cobrir todos os registros ou apenas um período, status ou entidade específicos.
Esperar download imediato
Esperar download imediato
O download só fica disponível após o Relatório chegar a
Finished.Próximos passos
- Use Baixar um Relatório quando o status for
Finished. - Use Corrigir um Relatório se o arquivo gerado tiver dados, layout ou formato errados.
- Use Testar uma conexão de Data Source se a geração falha por problemas de conexão ou schema.
Criar relatório
Gere Relatórios de forma programática.
Verificar status do relatório
Consulte o status da geração antes do download.

