Batchrapportage
Laatst bijgewerkt: 14-10-2026QV2QS genereert na een batchrun zowel rapporten per project als geaggregeerde rapporten, en biedt gedetailleerde conversieresultaten op elk niveau.
Rapporten per project
Elk project in de batch ontvangt een afzonderlijk Excel-conversierapport en een JSON-bestand met een managementsamenvatting, identiek aan de single-projectmodus. Deze bestanden worden geschreven naar de submap reports/ binnen elke projectuitvoermap.
Geaggregeerde rapporten
QV2QS schrijft de volgende geaggregeerde bestanden naar de hoofdmap van de uitvoer:
batch_summary.json— Machineleesbare samenvatting met projectaantallen, succes-/mislukkingsstatus, timing en geaggregeerde KPI's (totaal aantal werkbladen, objecten, percentage automatisering).batch_summary.html— Op zichzelf staand HTML-rapport voor een snelle controle.batch_conversion_report_<timestamp>.xlsx— Geconsolideerde Excel-werkmap met een samenvattend werkblad, uitsplitsing per project en gecombineerde objectdetails voor alle projecten.
Structuur van batch_summary.json
Het batch_summary.json-bestand bevat de volgende velden op het hoogste niveau voor CI/CD-integratie en programmatische parsing.
| Veld | Beschrijving |
|---|---|
schema
|
Schemaversie (momenteel 1). |
kind
|
Altijd qv2qs_batch_summary. |
version
|
QV2QS-versietekenreeks. |
timestamp_utc
|
ISO 8601-tijdstempel van de batchuitvoering. |
batch.total_projects
|
Totaal aantal ontdekte projecten. |
batch.succeeded
|
Aantal projecten dat succesvol is voltooid. |
batch.failed
|
Aantal projecten dat is mislukt. |
batch.wall_clock_sec
|
Totale verstreken tijd in seconden. |
batch.cumulative_sec
|
Som van de duur van alle individuele projecten. |
aggregated_kpis
|
Totalen over alle succesvolle projecten: sheets, objects_in_scope, auto, follow_up, errors, images_unique, auto_pct, follow_up_pct. |
projects
|
Array van vermeldingen per project. Elk item bevat name, ok (boolean), duration_sec en output_dir. Succesvolle projecten bevatten een summary-object met aantallen werkbladen/objecten. Mislukte projecten bevatten een error-tekenreeks. |
exec_summaries
|
Array van volledige managementsamenvattingsobjecten voor alle succesvolle projecten. |
Het executive_summary.json-bestand voor elk afzonderlijk project gebruikt hetzelfde schema (kind: qv2qs_exec_summary) en bevat project metadata, kpis (werkbladen, objecten, automatiseringsscores, overloopaantallen), breakdowns (resultaten per type, overloopacties) en object_details (placeholders, fouten, aanpassingen gegroepeerd per type). In de single-projectmodus bevat het bestand ook een data_model sectie met veld- en tabelaantallen, bytegroottes en toepassingseigenschappen. Applicatie-eigenschappen omvatten het tijdstip van de laatste herlading, de venstertitel, de sectietoegangsstatus en verbindingstypen voor gegevensherkomst. De sectie data_model is niet opgenomen in bestanden per project in batchmodus.
Het kpis-object bevat de volgende timingvelden:
| Veld | Beschrijving |
|---|---|
kpis.duration_sec
|
Lokale conversieduur in seconden (alleen PRJ-parsing en JSON-generatie). |
kpis.app_build_sec
|
Buildduur van de cloud-app in seconden (qlik app build). Alleen aanwezig wanneer er een cloudimplementatie is uitgevoerd. |
kpis.app_build_included_reload
|
Boolean. true als de buildtijd van de app een reload omvat, anders false. Alleen aanwezig wanneer er een cloudimplementatie is uitgevoerd. |
kpis.total_duration_sec
|
End-to-end doorlooptijd in seconden (conversie + cloud-implementatie). Alleen aanwezig wanneer een cloud-implementatie is uitgevoerd. Voor alleen lokale runs gebruikt u duration_sec. |
Console-uitvoer
Nadat alle projecten zijn voltooid, geeft de console een overzichtstabel weer met het totale aantal projecten, hoeveel er zijn geslaagd, hoeveel er zijn mislukt, de doorlooptijd en de cumulatieve verwerkingstijd. Mislukte projecten worden afzonderlijk vermeld met foutmeldingen.
Batch CLI-referentie
De volgende argumenten zijn specifiek voor de batchmodus. Voor algemene conversieargumenten die ook van toepassing zijn in batchmodus, zie Argumentreferentie.
| Argument | Beschrijving | Standaard |
|---|---|---|
--batchDir PATH
|
Hoofdmap (of door puntkomma's gescheiden paden) om te scannen op QVW/QVF-projecten. | Verplicht |
--batchWorkers N
|
Maximaal aantal gelijktijdig te converteren projecten (0 = automatisch: CPU-kernen min 1). |
0
|
--batchFlatOutput
|
Vlak de uitvoermapstructuur af in plaats van de bronhiërarchie te spiegelen. | Uit |
--generatePrj
|
Automatisch PRJ-mappen genereren voor bronbestanden die er geen hebben. | Uit |
--qsAppName TEMPLATE
|
Sjabloon voor app-naamgeving voor Qlik Cloud-implementatie. Ondersteunt de placeholders {name}, {rel} en {index} . |
Projectnaam |