> ## 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 a partir do mesmo template do Reporter.

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

## Objetivo

***

Corrija a configuração de origem que produziu um Relatório errado e gere um novo Relatório.

Por exemplo, se um arquivo CSV tem linhas ausentes, revise os filtros usados durante a geração. Se o layout está errado, atualize o Template. Se os valores estão errados, teste a Fonte de Dados e confirme que ela aponta para o banco de dados e o esquema esperados.

## Quando usar

***

Use esta página quando:

* um operador pergunta por que o Reporter não pode alterar um Relatório gerado diretamente.
* um Relatório gerado tem dados, layout ou formato de saída errados.
* um Relatório `Error` ou `Partial` precisa de investigação antes de tentar novamente.
* a equipe precisa de um arquivo corrigido preservando o Relatório gerado original para histórico.

Não use esta tarefa para sobrescrever um arquivo gerado. Gere um novo Relatório depois da correção.

## Antes de começar

***

Identifique o que está errado:

| Problema                                | Provável fonte a verificar                                    |
| --------------------------------------- | ------------------------------------------------------------- |
| O layout do arquivo está errado         | Estrutura do Template ou arquivo `.tpl`                       |
| O formato de saída está errado          | **Formato de Saída** do Template                              |
| Linhas estão ausentes                   | Filtros do Relatório ou esquema da Fonte de Dados             |
| Os valores estão errados                | Conexão da Fonte de Dados, esquema, campos ou dados de origem |
| A geração retornou `Error` ou `Partial` | Detalhes do Relatório, Template, Fonte de Dados, filtros      |

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

## Passo a passo

***

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

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

  <Step title="Corrigir a configuração de origem">
    Atualize o Template, teste ou edite a Fonte de Dados, ou ajuste os filtros que você vai usar na próxima geração.
  </Step>

  <Step title="Gerar um novo Relatório">
    Use o Template, a Fonte de Dados e os filtros corrigidos para gerar um novo Relatório.
  </Step>

  <Step title="Baixar o arquivo corrigido">
    Espere até o novo Relatório atingir `Finished`, depois 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. Os campos técnicos incluem `templateId`, `templateDescription` e `templateOutputFormat`. | `Monthly tax CSV`, `csv` |
| Filtros          | Se o Relatório gerado incluiu o subconjunto de dados pretendido. Campo técnico: `filters`.                                                         | `status eq active`       |
| Status           | Se o Relatório terminou, ainda está em execução, cobre apenas algumas de suas seções 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`     |
| Fonte de Dados   | Se o Relatório veio do banco de dados e do esquema esperados. Verifique o filtro `database` e o mapeamento de campos do Template.                  | `production-postgres`    |

## Resultado esperado

***

O Relatório incorreto permanece inalterado. O Reporter gera um novo Relatório corrigido a partir da configuração corrigida.

## 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, a Fonte de Dados ou os filtros, depois gere novamente.
  </Accordion>

  <Accordion title="Corrigir o Template quando o filtro estava errado">
    Linhas ausentes costumam vir dos filtros, não do Template. Revise as entradas da geração antes de alterar o Template.
  </Accordion>

  <Accordion title="Gerar novamente sem testar a Fonte de Dados">
    Se os valores estão errados ou o acesso ao esquema mudou, teste a Fonte de Dados antes de gerar um Relatório corrigido.
  </Accordion>
</AccordionGroup>

## Próximos passos

***

* Use [Atualizar um Template](/pt/products/reporter/console/updating-a-template) quando o layout ou o formato de saída estiver errado.
* Use [Testar a conexão de uma Fonte de Dados](/pt/products/reporter/console/testing-a-data-source) quando os valores ou o acesso a esquemas forem suspeitos.
* Use [Gerar um Relatório](/pt/products/reporter/console/generating-a-report) depois de corrigir a configuração de origem.

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

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