Objetivo
Corrigir a configuração de origem que produziu um Relatório errado e então gerar um novo Relatório. Por exemplo, se um arquivo CSV está com linhas faltando, revise os filtros usados na geração. Se o layout está errado, atualize o Template. Se os valores estão errados, teste o Data Source e confirme que ele aponta para o banco e schema esperados.
Quando usar
Use esta página quando:
- um operador pergunta por que um Relatório gerado não pode ser alterado diretamente;
- um Relatório gerado tem dados, layout ou formato de saída errados;
- um Relatório em
Errorou parado emPendingExtractionprecisa de investigação antes de tentar de novo; - o time precisa de um arquivo corrigido preservando o Relatório gerado original como histórico.
Antes de começar
Identifique o que está errado:
| Problema | Fonte provável a verificar |
|---|---|
| Layout do arquivo está errado | Estrutura do Template ou arquivo .tpl |
| Formato de saída está errado | Formato de Saída do Template |
| Linhas estão faltando | Filtros do Relatório ou schema do Data Source |
| Valores estão errados | Conexão do Data Source, schema, campos ou dados de origem |
A geração retornou Error ou parou em PendingExtraction | Detalhes do Relatório, Template, Data Source, filtros |
O Relatório original permanece disponível para histórico de auditoria. O arquivo corrigido é um novo Relatório gerado.
Passo a passo
Revise como ele foi gerado
Verifique o Template, filtros, formato de saída, status e quaisquer detalhes de erro.
Corrija a configuração de origem
Atualize o Template, teste ou edite o Data Source, ou ajuste os filtros que você vai usar na próxima geração.
Gere um novo Relatório
Use o Template, Data Source e filtros corrigidos para gerar um novo Relatório.
Guia de campos
| Campo ou status | O que ajuda a diagnosticar | Exemplo |
|---|---|---|
| Template | Se o Template e o formato de saída corretos foram usados. Campos técnicos incluem templateId, templateDescription e templateOutputFormat. | Monthly tax CSV, csv |
| Filtros | Se o Relatório gerado incluiu o subconjunto pretendido de dados. Campo técnico: filters. | status eq active |
| Status | Se o Relatório concluiu, ainda está rodando, está esperando extração ou retornou um erro. Campo técnico: status. | Error |
| Detalhes do erro | Mensagem retornada pelo Reporter quando a geração falha. Campo técnico: error. | connection timeout |
| Data Source | Se o Relatório veio do banco e schema esperados. Verifique o filtro database e o mapeamento de campos do Template. | production-postgres |
Resultado esperado
O Relatório incorreto fica inalterado e um novo Relatório corrigido é gerado a partir da configuração ajustada.
Erros comuns e pontos de atenção
Tentar editar o arquivo gerado
Tentar editar o arquivo gerado
O Reporter mantém os Relatórios gerados como saídas históricas. Corrija o Template, Data Source ou filtros e gere novamente.
Corrigir o Template quando o filtro estava errado
Corrigir o Template quando o filtro estava errado
Linhas faltando costumam vir dos filtros, não do Template. Revise as entradas da geração antes de mudar o Template.
Regerar sem testar o Data Source
Regerar sem testar o Data Source
Se os valores estão errados ou o acesso ao schema mudou, teste o Data Source antes de gerar um Relatório corrigido.
Próximos passos
- Use Atualizar um Template quando o layout ou o formato de saída estiverem errados.
- Use Testar uma conexão de Data Source quando valores ou acesso ao schema estiverem suspeitos.
- Use Gerar um Relatório após corrigir a configuração de origem.
Criar relatório
Gere o Relatório corrigido. Não há endpoint de edição direta para saídas históricas.
Verificar status do relatório
Monitore o Relatório corrigido antes do download.