> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Corrigir um Relatório

> Entenda por que Relatórios gerados não podem ser editados e como corrigir a configuração de origem antes de gerar um novo Relatório.

Um Relatório gerado é um arquivo histórico. O Reporter não edita a saída gerada após a geração terminar.

## 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 `Error` ou parado em `PendingExtraction` precisa de investigação antes de tentar de novo;
* o time precisa de um arquivo corrigido preservando o Relatório gerado original como histórico.

Não use esta tarefa para sobrescrever um arquivo gerado. Gere um novo Relatório após a correção.

## 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     |

<Note>
  O Relatório original permanece disponível para histórico de auditoria. O arquivo corrigido é um novo Relatório gerado.
</Note>

## Passo a passo

***

<Steps>
  <Step title="Abra os detalhes do Relatório">
    Vá para **Relatórios** e abra os detalhes do Relatório gerado.
  </Step>

  <Step title="Revise como ele foi gerado">
    Verifique o Template, filtros, formato de saída, status e quaisquer detalhes de erro.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Gere um novo Relatório">
    Use o Template, Data Source e filtros corrigidos para gerar um novo Relatório.
  </Step>

  <Step title="Baixe o arquivo corrigido">
    Espere o novo Relatório chegar a `Finished` e então baixe-o.
  </Step>
</Steps>

## 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

***

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>

## Próximos passos

***

* Use [Atualizar um Template](/pt/lerian-console/reporter-console/updating-a-template) quando o layout ou o formato de saída estiverem errados.
* Use [Testar uma conexão de Data Source](/pt/lerian-console/reporter-console/testing-a-data-source) quando valores ou acesso ao schema estiverem suspeitos.
* Use [Gerar um Relatório](/pt/lerian-console/reporter-console/generating-a-report) após corrigir a configuração de origem.

<CardGroup cols={2}>
  <Card title="Criar relatório" icon="code" href="/pt/reference/reporter/create-report">
    Gere o Relatório corrigido. Não há endpoint de edição direta para saídas históricas.
  </Card>

  <Card title="Verificar status do relatório" icon="code" href="/pt/reference/reporter/check-report-status">
    Monitore o Relatório corrigido antes do download.
  </Card>
</CardGroup>