# Relatórios em lote

O QV2QS gera relatórios tanto por projeto quanto agregados após uma execução em lote, fornecendo resultados detalhados de conversão em todos os níveis.

## Relatórios por projeto

Cada projeto no lote recebe um relatório individual de conversão do Excel e um arquivo JSON de resumo executivo, idênticos ao modo de projeto único. Esses arquivos são gravados na subpasta `reports/` dentro de cada diretório de saída do projeto.

## Relatórios agregados

O QV2QS grava os seguintes arquivos agregados no diretório raiz de saída:

* `batch_summary.json` — Resumo legível por máquina com contagens de projetos, status de sucesso/falha, tempo e KPIs agregados (total de planilhas, objetos, porcentagem de automação).
* `batch_summary.html` — Relatório HTML independente para revisão rápida.
* `batch_conversion_report_<timestamp>.xlsx` — Pasta de trabalho consolidada do Excel com uma pasta de resumo, decompor por projeto e detalhes combinados de objetos em todos os projetos.

## Estrutura do batch\_summary.json

O arquivo `batch_summary.json` contém os seguintes campos de nível superior para integração com CI/CD e análise programática.

| Campo | Descrição |
| --- | --- |
| `schema` | Versão do esquema (atualmente `1`). |
| `kind` | Sempre `qv2qs_batch_summary`. |
| `version` | String de versão do QV2QS. |
| `timestamp_utc` | Carimbo de data/hora ISO 8601 da execução em lote. |
| `batch.total_projects` | Número total de projetos descobertos. |
| `batch.succeeded` | Número de projetos concluídos com sucesso. |
| `batch.failed` | Número de projetos que falharam. |
| `batch.wall_clock_sec` | Tempo total decorrido em segundos. |
| `batch.cumulative_sec` | Soma de todas as durações individuais dos projetos. |
| `aggregated_kpis` | Totais em todos os projetos bem-sucedidos: `sheets`, `objects_in_scope`, `auto`, `follow_up`, `errors`, `images_unique`, `auto_pct`, `follow_up_pct`. |
| `projects` | Array de entradas por projeto. Cada entrada inclui `name`, `ok` (booleano), `duration_sec` e `output_dir`. Projetos bem-sucedidos incluem um objeto `summary` com contagens de pasta/objeto. Projetos com falha incluem uma string `error`. |
| `exec_summaries` | Array de objetos completos de resumo executivo para todos os projetos bem-sucedidos. |

O arquivo `executive_summary.json` de cada projeto individual usa o mesmo esquema (`kind: qv2qs_exec_summary`) e contém metadados de `project`, `kpis` (planilhas, objetos, pontuações de automação, contagens de estouro), `breakdowns` (resultados por tipo, ações de estouro) e `object_details` (espaços reservados, erros, ajustes agrupados por tipo). No modo de projeto único, o arquivo também contém uma seção `data_model` com contagens de campos e tabelas, tamanhos em bytes e propriedades do aplicativo. As propriedades do aplicativo incluem a hora da última recarga, o título da janela, o status de acesso à seção e os tipos de conexão de linhagem de dados. A seção `data_model` não é incluída em arquivos por projeto no modo em lote.

O objeto `kpis` inclui os seguintes campos de temporização:

| Campo | Descrição |
| --- | --- |
| `kpis.duration_sec` | Duração da conversão local em segundos (apenas análise de PRJ e geração de JSON). |
| `kpis.app_build_sec` | Duração da compilação do aplicativo na nuvem em segundos (`qlik app build`). Presente apenas quando a implementação na nuvem foi realizada. |
| `kpis.app_build_included_reload` | Booleano. `true` se o tempo de compilação do aplicativo incluir um recarregamento, `false` caso contrário. Presente apenas quando a implementação na nuvem foi realizada. |
| `kpis.total_duration_sec` | Tempo decorrido de ponta a ponta em segundos (conversão + implementação na nuvem). Presente apenas quando a implementação na nuvem foi realizada. Para execuções somente locais, use `duration_sec`. |

## Saída do console

Após a conclusão de todos os projetos, o console exibe uma tabela de resumo com o número total de projetos, quantos foram bem-sucedidos, quantos falharam, o tempo de relógio e o tempo de processamento cumulativo. Os projetos com falha são listados individualmente com mensagens de erro.

## Referência da CLI do Batch

Os argumentos a seguir são específicos do modo em lote. Para argumentos gerais de conversão que também se aplicam ao modo em lote, consulte a [Referência de argumentos](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm).

| Argumento | Descrição | Padrão |
| --- | --- | --- |
| `--batchDir PATH` | Diretório raiz (ou caminhos separados por ponto e vírgula) a ser verificado em busca de projetos QVW/QVF. | Obrigatório |
| `--batchWorkers N` | Número máximo de projetos a serem convertidos simultaneamente (`0` = automático: núcleos de CPU menos 1). | `0` |
| `--batchFlatOutput` | Nivelar a estrutura de diretórios de saída em vez de espelhar a hierarquia de origem. | Desativado |
| `--generatePrj` | Gerar automaticamente pastas PRJ para arquivos de origem que não possuem uma. | Desativado |
| `--qsAppName TEMPLATE` | Modelo de nomenclatura de aplicativo para implementação do Qlik Cloud. Suporta os marcadores de posição `{name}`, `{rel}` e `{index}`. | Nome do projeto |

## Saiba mais

* [Estrutura de saída e nomenclatura do aplicativo](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/batch-conversion/output-structure-and-app-naming.htm)
* [Relatório de conversão](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/conversion-results/conversion-report.htm)
* [Painel de resumo executivo](https://help.qlik.com/pt-BR/migration/Content/Qv2qsMigration/user-interface/executive-summary-dashboard.htm)