# Rapports par lots

QV2QS génère à la fois des rapports par projet et des rapports agrégés après une exécution par lots, fournissant des résultats de conversion détaillés à chaque niveau.

## Rapports par projet

Chaque projet du lot reçoit un rapport de conversion Excel individuel et un fichier JSON de synthèse, identiques à ceux du mode projet unique. Ces fichiers sont écrits dans le sous-dossier `reports/` de chaque répertoire de sortie du projet.

## Rapports agrégés

QV2QS écrit les fichiers agrégés suivants dans le répertoire racine de sortie :

* `batch_summary.json` — Résumé lisible par machine avec le nombre de projets, le statut de réussite/échec, la durée et les KPI agrégés (nombre total de feuilles, objets, pourcentage d'automatisation).
* `batch_summary.html` — Rapport HTML autonome pour une consultation rapide.
* `batch_conversion_report_<timestamp>.xlsx` — Classeur Excel consolidé avec une feuille de synthèse, une répartition par projet et le détail combiné des objets pour l'ensemble des projets.

## Structure de batch\_summary.json

Le fichier `batch_summary.json` contient les champs de premier niveau suivants pour l'intégration CI/CD et l'analyse programmatique.

| Champ | Description |
| --- | --- |
| `schema` | Version du schéma (actuellement `1`). |
| `kind` | Toujours `qv2qs_batch_summary`. |
| `version` | Chaîne de version QV2QS. |
| `timestamp_utc` | Horodatage ISO 8601 de l'exécution par lots. |
| `batch.total_projects` | Nombre total de projets découverts. |
| `batch.succeeded` | Nombre de projets terminés avec succès. |
| `batch.failed` | Nombre de projets qui ont échoué. |
| `batch.wall_clock_sec` | Temps total écoulé en secondes. |
| `batch.cumulative_sec` | Somme de toutes les durées individuelles des projets. |
| `aggregated_kpis` | Totaux pour l'ensemble des projets réussis : `sheets`, `objects_in_scope`, `auto`, `follow_up`, `errors`, `images_unique`, `auto_pct`, `follow_up_pct`. |
| `projects` | Tableau d'entrées par projet. Chaque entrée comprend `name`, `ok` (booléen), `duration_sec` et `output_dir`. Les projets réussis incluent un objet `summary` avec le nombre de feuilles/objets. Les projets ayant échoué incluent une chaîne `error`. |
| `exec_summaries` | Tableau d'objets complets de résumé opérationnel pour tous les projets réussis. |

Le fichier `executive_summary.json` de chaque projet individuel utilise le même schéma (`kind: qv2qs_exec_summary`) et contient des métadonnées `project`, `kpis` (feuilles, objets, scores d'automatisation, nombres de dépassements), `breakdowns` (résultats par type, actions de dépassement) et `object_details` (espaces réservés, erreurs, ajustements regroupés par type). En mode projet unique, le fichier contient également une section `data_model` avec le nombre de champs et de tables, les tailles en octets et les propriétés de l'application. Les propriétés de l'application incluent l'heure du dernier rechargement, le titre de la fenêtre, le statut de la section access et les types de connexion de traçabilité des données. La section `data_model` n'est pas incluse dans les fichiers par projet en mode batch.

L'objet `kpis` comprend les champs de temporisation suivants :

| Champ | Description |
| --- | --- |
| `kpis.duration_sec` | Durée de conversion locale en secondes (analyse PRJ et génération JSON uniquement). |
| `kpis.app_build_sec` | Durée de génération de l'application cloud en secondes (`qlik app build`). Présent uniquement lorsqu'un déploiement cloud a été effectué. |
| `kpis.app_build_included_reload` | Booléen. `true` si le temps de génération de l'application inclut un rechargement, `false` sinon. Présent uniquement lorsqu'un déploiement cloud a été effectué. |
| `kpis.total_duration_sec` | Temps d'horloge de bout en bout en secondes (conversion + déploiement cloud). Présent uniquement lorsqu'un déploiement cloud a été effectué. Pour les exécutions locales uniquement, utilisez `duration_sec`. |

## Sortie de la console

Une fois tous les projets terminés, la console affiche un tableau récapitulatif indiquant le nombre total de projets, le nombre de réussites, le nombre d'échecs, le temps réel écoulé et le temps de traitement cumulé. Les projets ayant échoué sont répertoriés individuellement avec leurs messages d'erreur.

## Référence de la CLI Batch

Les arguments suivants sont spécifiques au mode batch. Pour les arguments de conversion généraux qui s'appliquent également en mode batch, consultez [Référence des arguments](https://help.qlik.com/fr-FR/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm).

| Argument | Description | Par défaut |
| --- | --- | --- |
| `--batchDir PATH` | Répertoire racine (ou chemins séparés par un point-virgule) à analyser pour rechercher des projets QVW/QVF. | Obligatoire |
| `--batchWorkers N` | Nombre maximal de projets à convertir simultanément (`0` = auto : cœurs de processeur moins 1). | `0` |
| `--batchFlatOutput` | Aplatir la structure du répertoire de sortie au lieu de reproduire la hiérarchie source. | Désactivé |
| `--generatePrj` | Générer automatiquement des dossiers PRJ pour les fichiers source qui n'en ont pas. | Désactivé |
| `--qsAppName TEMPLATE` | Modèle de nommage d'application pour le déploiement Qlik Cloud. Prend en charge les espaces réservés `{name}`, `{rel}` et `{index}`. | Project name |

## En savoir plus

* [Structure de sortie et nommage de l'application](https://help.qlik.com/fr-FR/migration/Content/Qv2qsMigration/batch-conversion/output-structure-and-app-naming.htm)
* [Rapport de conversion](https://help.qlik.com/fr-FR/migration/Content/Qv2qsMigration/conversion-results/conversion-report.htm)
* [Tableau de bord de synthèse](https://help.qlik.com/fr-FR/migration/Content/Qv2qsMigration/user-interface/executive-summary-dashboard.htm)