# 輸出結構與應用程式命名

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

資訊備註

單一專案模式也會在輸出根目錄下建立個別專案的子資料夾。如需詳細資訊，請參閱[轉換運作方式](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/getting-started/how-conversion-works.htm)。

## 輸出結構

預設情況下，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 中使用具代表性的樣本進行幾分鐘的測試，即可在大批次處理時節省大量心力。

提示備註

先從 3 到 5 個應用程式的小批次開始驗證設定，再擴展至完整集合。

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

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

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

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

| 預留位置 | 描述 |
| --- | --- |
| `{name}` | 專案名稱 |
| `{rel}` | 從掃描根目錄算起的相對目錄路徑 |
| `{index}` | 循序專案編號 (從 1 開始) |

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

## 深入了解

* [平行執行](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/batch-conversion/parallel-execution.htm)
* [批次報表](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/batch-conversion/batch-reporting.htm)
* [參數參考](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm)