# Batchrapportering

QV2QS 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](https://help.qlik.com/sv-SE/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm).

| 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 |

## Läs mer

* [Utdatastruktur och appnamngivning](https://help.qlik.com/sv-SE/migration/Content/Qv2qsMigration/batch-conversion/output-structure-and-app-naming.htm)
* [Konverteringsrapport](https://help.qlik.com/sv-SE/migration/Content/Qv2qsMigration/conversion-results/conversion-report.htm)
* [Instrumentpanel för ledningssammanfattning](https://help.qlik.com/sv-SE/migration/Content/Qv2qsMigration/user-interface/executive-summary-dashboard.htm)