Relatórios em lote
Última atualização: 14/10/2026O 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.
| 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 |