批次報表
上次更新：2026/10/14QV2QS 在批次執行後會產生個別專案報告與彙總報告，提供各層級詳細的轉換結果。
依專案報告
批次中的每個專案都會收到個別的 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 參考
以下引數專用於批次模式。如需同時適用於批次模式的一般轉換引數，請參閱 引數參考。
| 引數 | 描述 | 預設值 |
|---|---|---|
--batchDir PATH
|
用於掃描 QVW/QVF 專案的根目錄（或以分號分隔的路徑）。 | 必填 |
--batchWorkers N
|
同時轉換專案的最大數量 (0 = 自動：CPU 核心數減 1)。 |
0
|
--batchFlatOutput
|
扁平化輸出目錄結構，而非鏡射來源階層結構。 | 關閉 |
--generatePrj
|
自動為沒有 PRJ 資料夾的來源檔案產生 PRJ 資料夾。 | 關閉 |
--qsAppName TEMPLATE
|
適用於 Qlik Cloud 部署的應用程式命名範本。支援 {name}、{rel} 和 {index} 預留位置。 |
專案名稱 |