Batchrapportering
Senast uppdaterad: 2026-10-14QV2QS genererar både projektvisa och aggregerade rapporter efter en batchkörning, vilket ger detaljerade konverteringsresultat på varje nivå.
Projektvisa rapporter
Varje projekt i batchen får en individuell Excel-konverteringsrapport och en sammanfattande JSON-fil, identiskt med enprojektläget. Dessa filer skrivs till undermappen reports/ i varje projekts utdatakatalog.
Aggregerade rapporter
QV2QS skriver följande aggregerade filer till utdatarotkatalogen:
batch_summary.json— Maskinläsbar sammanfattning med antal projekt, status för lyckat/misslyckat, tidsåtgång och aggregerade KPI:er (totalt antal ark, objekt, procentandel automatisering).batch_summary.html— Fristående HTML-rapport för snabb granskning.batch_conversion_report_<timestamp>.xlsx— Konsoliderad Excel-arbetsbok med ett sammanfattningsark, uppdelning per projekt och kombinerade objektdetaljer över alla projekt.
Struktur för batch_summary.json
batch_summary.json-filen innehåller följande toppnivåfält för CI/CD-integrering och programmatisk parsning.
| Fält | Beskrivning |
|---|---|
schema
|
Schemaversion (för närvarande 1). |
kind
|
Alltid qv2qs_batch_summary. |
version
|
Versionssträng för QV2QS. |
timestamp_utc
|
ISO 8601-tidsmarkör för batchkörningen. |
batch.total_projects
|
Totalt antal upptäckta projekt. |
batch.succeeded
|
Antal projekt som slutfördes framgångsrikt. |
batch.failed
|
Antal projekt som misslyckades. |
batch.wall_clock_sec
|
Total förfluten tid i sekunder. |
batch.cumulative_sec
|
Summan av alla enskilda projektvaraktigheter. |
aggregated_kpis
|
Totalsummor för alla lyckade projekt: sheets, objects_in_scope, auto, follow_up, errors, images_unique, auto_pct, follow_up_pct. |
projects
|
Array med poster per projekt. Varje post innehåller name, ok (boolesk), duration_sec och output_dir. Framgångsrika projekt innehåller ett summary-objekt med antal ark/objekt. Misslyckade projekt innehåller en error-sträng. |
exec_summaries
|
Array med fullständiga sammanfattningsobjekt för alla framgångsrika projekt. |
executive_summary.json-filen för varje enskilt projekt använder samma schema (kind: qv2qs_exec_summary) och innehåller project metadata, kpis (ark, objekt, automatiseringspoäng, spillantal), breakdowns (resultat per typ, spillåtgärder) och object_details (platshållare, fel, justeringar grupperade efter typ). I enprojektläge innehåller filen även ett data_model-delavsnitt med antal fält och tabeller, bytestorlekar och applikationsegenskaper. Applikationsegenskaper omfattar tidpunkt för senaste omladdning, fönstertitel, status för delavsnittsåtkomst och kopplingstyper för dataursprung. Delavsnittet data_model ingår inte i batchlägesfiler per projekt.
Objektet kpis innehåller följande tidsfält:
| Fält | Beskrivning |
|---|---|
kpis.duration_sec
|
Lokal konverteringstid i sekunder (endast PRJ-parsning och JSON-generering). |
kpis.app_build_sec
|
Byggtid för molnapp i sekunder (qlik app build). Visas endast när molndistribution utfördes. |
kpis.app_build_included_reload
|
Booleskt värde. true om appens byggtid inkluderar en omladdning, false annars. Visas endast när molndistribution utfördes. |
kpis.total_duration_sec
|
End-to-end-klocktid i sekunder (konvertering + molndistribution). Visas endast när molndistribution utfördes. För enbart lokala körningar, använd duration_sec. |
Konsolutdata
När alla projekt har slutförts visar konsolen en sammanfattningstabell med det totala antalet projekt, hur många som lyckades, hur många som misslyckades, klocktid och kumulativ bearbetningstid. Misslyckade projekt listas individuellt med felmeddelanden.
Batch CLI-referens
Följande argument är specifika för batchläge. För allmänna konverteringsargument som även gäller i batchläge, se Argumentreferens.
| Argument | Beskrivning | Standard |
|---|---|---|
--batchDir PATH
|
Rotkatalog (eller semikolonseparerade sökvägar) att genomsöka efter QVW/QVF-projekt. | Obligatoriskt fält |
--batchWorkers N
|
Maximalt antal projekt att konvertera samtidigt (0 = auto: CPU-kärnor minus 1). |
0
|
--batchFlatOutput
|
Platta ut utdatakatalogstrukturen i stället för att spegla källhierarkin. | Av |
--generatePrj
|
Generera automatiskt PRJ-mappar för källfiler som saknar en. | Av |
--qsAppName TEMPLATE
|
Mall för appnamngivning för Qlik Cloud-distribution. Stöder platshållarna {name}, {rel} och {index}. |
Projektnamn |