Rapports par lots
Dernière mise à jour : 14/10/2026QV2QS 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.
| 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 |