# 批次報表

QV2QS 在批次執行後會產生個別專案報告與彙總報告，提供各層級詳細的轉換結果。

## 依專案報告

批次中的每個專案都會收到個別的 Excel 轉換報告與執行摘要 JSON 檔案，與單一專案模式完全相同。這些檔案會寫入至每個專案輸出目錄中的 `reports/` 子資料夾。

## 彙總報表

QV2QS 會將下列彙總檔案寫入輸出根目錄：

* `batch_summary.json` — 機器可讀摘要，包含專案計數、成功/失敗狀態、時間以及彙總 KPI（工作表總數、物件、自動化百分比）。
* `batch_summary.html` — 供快速檢閱的獨立 HTML 報告。
* `batch_conversion_report_<timestamp>.xlsx` — 彙總 Excel 活頁簿，包含摘要工作表、各專案解析，以及跨所有專案的合併物件詳細資料。

## batch\_summary.json 結構

`batch_summary.json` 檔案包含下列頂層欄位，供 CI/CD 整合與程式化剖析使用。

| 欄位 | 描述 |
| --- | --- |
| `schema` | 結構描述版本 (目前為 `1`)。 |
| `kind` | 一律 `qv2qs_batch_summary`。 |
| `version` | QV2QS 版本字串。 |
| `timestamp_utc` | 批次執行的 ISO 8601 時間戳記。 |
| `batch.total_projects` | 探索到的專案總數。 |
| `batch.succeeded` | 成功完成的專案數量。 |
| `batch.failed` | 失敗的專案數量。 |
| `batch.wall_clock_sec` | 總經過時間（以秒為單位）。 |
| `batch.cumulative_sec` | 所有個別專案工期的總和。 |
| `aggregated_kpis` | 所有成功專案的總計：`sheets`、`objects_in_scope`、`auto`、`follow_up`、`errors`、`images_unique`、`auto_pct`、`follow_up_pct`。 |
| `projects` | 各專案項目的陣列。每個項目包含 `name`、`ok`（布林值）、`duration_sec` 和 `output_dir`。成功的專案包含具有工作表/物件計數的 `summary` 物件。失敗的專案包含 `error` 字串。 |
| `exec_summaries` | 所有成功專案的完整執行摘要物件陣列。 |

每個個別專案的 `executive_summary.json` 檔案皆使用相同的結構描述 (`kind: qv2qs_exec_summary`)，並包含 `project` 中繼資料、`kpis` (工作表、物件、自動化分數、溢位計數)、`breakdowns` (各類型結果、溢位動作)，以及 `object_details` (依類型分組的預留位置、錯誤、調整)。在單一專案模式下，該檔案還包含一個 `data_model` 區段，其中包含欄位與資料表計數、位元組大小以及應用程式屬性。應用程式屬性包含上次重新載入時間、視窗標題、區段存取狀態，以及資料譜系連線類型。`data_model` 區段未包含在批次模式的個別專案檔案中。

`kpis` 物件包含下列計時欄位：

| 欄位 | 描述 |
| --- | --- |
| `kpis.duration_sec` | 以秒為單位的本機轉換時間（僅限 PRJ 剖析與 JSON 產生）。 |
| `kpis.app_build_sec` | 雲端應用程式建置時間 (以秒為單位) (`qlik app build`)。僅在執行雲端部署時顯示。 |
| `kpis.app_build_included_reload` | 布林值。如果應用程式建置時間包含重新載入，則為 `true`，否則為 `false`。僅在執行雲端部署時顯示。 |
| `kpis.total_duration_sec` | 端對端實際經過時間（以秒為單位）（轉換 + 雲端部署）。僅在執行雲端部署時顯示。若僅限本機執行，請使用 `duration_sec`。 |

## 主控台輸出

所有專案完成後，主控台會顯示摘要表，其中包含專案總數、成功數量、失敗數量、實際經過時間以及累計處理時間。失敗的專案會個別列出，並附上錯誤訊息。

## Batch CLI 參考

以下引數專用於批次模式。如需同時適用於批次模式的一般轉換引數，請參閱 [引數參考](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm)。

| 引數 | 描述 | 預設值 |
| --- | --- | --- |
| `--batchDir PATH` | 用於掃描 QVW/QVF 專案的根目錄（或以分號分隔的路徑）。 | 必填 |
| `--batchWorkers N` | 同時轉換專案的最大數量 (`0` = 自動：CPU 核心數減 1)。 | `0` |
| `--batchFlatOutput` | 扁平化輸出目錄結構，而非鏡射來源階層結構。 | 關閉 |
| `--generatePrj` | 自動為沒有 PRJ 資料夾的來源檔案產生 PRJ 資料夾。 | 關閉 |
| `--qsAppName TEMPLATE` | 適用於 Qlik Cloud 部署的應用程式命名範本。支援 `{name}`、`{rel}` 和 `{index}` 預留位置。 | 專案名稱 |

## 了解更多

* [輸出結構與應用程式命名](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/batch-conversion/output-structure-and-app-naming.htm)
* [轉換報告](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/conversion-results/conversion-report.htm)
* [主管摘要儀表板](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/user-interface/executive-summary-dashboard.htm)