輸出結構與應用程式命名

上次更新：2026/10/14

QV2QS 將批次輸出組織成目錄階層，並為 Qlik Cloud 部署提供彈性的應用程式命名。本主題涵蓋目錄版面配置選項、設定建議以及命名範本。

輸出結構

預設情況下，QV2QS 會在輸出根目錄下鏡射來源目錄階層。每個專案都會產生一個包含建置輸出、報告和記錄的子資料夾。

保留階層 (預設)

<outputDir>/
  <RelativePath>/
    <ProjectName>/
      build/
      images/
      reports/
      logs/

扁平化階層 (--batchFlatOutput)

<outputDir>/
  <ProjectName>/
    build/
    images/
    reports/
    logs/

當來源資料夾結構反映組織分組（依部門、地區或事業單位），且輸出需要反映該結構時，保留階層結構會非常實用。當資料夾結構不具實質意義，或在後續流程中使用扁平清單更易於處理時，扁平化階層結構便非常實用。

若兩個專案產生相同的輸出資料夾名稱（例如位於不同子目錄中且名稱皆為 Sales 的兩個專案），QV2QS 會附加 _2、_3 及後續數字以避免衝突。

批次模式下的設定

所有轉換設定皆會統一套用至批次中的每個專案。沒有個別專案覆寫的機制。固定的畫布縮放比例、物件縮放比例、尺寸限制、裁切尺寸、版面配置縮小、背景處理以及其他所有設定，都會以相同方式套用至該次執行中的每個應用程式。

這項統一套用具有一項重要的實務意涵：在執行批次轉換時，將類似的應用程式分組在一起。具有相似螢幕解析度、背景影像版面配置和物件大小的應用程式，很適合在單一批次中處理。版面配置或設計模式差異顯著的應用程式，適合使用不同的設定分別進行批次執行。

建議的批次轉換工作流程：

1. 將所有來源 QVW 和 QVF 檔案複製到本機工作資料夾。請勿針對正式環境目錄或網路共用執行批次轉換。
2. 識別具有相似版面配置特性 (解析度、背景影像、物件密度) 的 QlikView 應用程式群組。
3. 以單一專案模式載入每個群組的代表性應用程式。
4. 開啟 Mockup Studio，並嘗試調整固定畫布、縮放、裁切以及大小限制設定，直到版面配置令人滿意為止。
5. 請記下為該群組產生最佳結果的設定。
6. 切換至批次模式，指向包含該群組的資料夾，並套用相同的設定。
7. 針對每個應用程式群組重複此步驟。

此方法可避免常見的錯誤：使用通用設定執行大量批次作業，事後再花費時間手動調整個別應用程式。在 Mockup Studio 中使用具代表性的樣本進行幾分鐘的測試，即可在大批次處理時節省大量心力。

批次模式下的應用程式命名

將批次轉換部署至 Qlik Cloud 時，--qsAppName 會控制每個應用程式的命名方式：

• 未指定 — 每個應用程式均以專案命名 (<Name>)。
• 純文字 — 此值會用作前綴：<prefix> - <Name>。
• 具有預留位置的範本 — 該值會被視為格式字串。

範本字串中可使用下列預留位置。

例如，--qsAppName "Migrated {name} ({rel})" 會產生如 Migrated Sales (region1/finance) 的應用程式名稱。

深入了解

• 平行執行
• 批次報表
• 參數參考