# 常見工作流程

以下範例涵蓋了最常見的使用案例。每個都基於相同的核心模式：指定一個 QVW 檔案、一個輸出資料夾、以及一個 Qlik Cloud 環境。在所有範例中，`--outputDir` 是輸出根。QV2QS 會自動建立一個以 QVW 檔案命名的子資料夾（例如，`./output/Sales/`）。所有這些工作流程也可以透過網路精靈來執行。如需引導式方法，請參閱[精靈步驟](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/user-interface/wizard-steps.htm)。

## 部署至 Qlik Cloud 並包含資料

標準的移轉工作流程。QV2QS 會產生 PRJ 資料夾，轉換使用者介面，上傳 QVW 以載入二進位資料，在 Qlik Cloud 中重新載入應用程式，並產生 Excel 報告。重新載入後，上傳的 QVW 會被刪除，並還原原始的載入指令碼。

```
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qsAppName "Sales" --qlikContext my-tenant --autoBinary --reload --reportXlsx
```

## 匯出 QVF 檔案

QV2QS 使用 Qlik Cloud 引擎建置應用程式，將結果匯出為 QVF 檔案，然後刪除雲端應用程式。匯出的 QVF 可以匯入不同的 Qlik Cloud 租用戶。

警告備註

匯入 QV2QS 產生的 QVF 檔案到 Qlik Sense Enterprise Client-Managed 未經所有版本測試或官方支援，且不建議這麼做。如需詳細資訊，請參閱 [Qlik Sense Enterprise Client-Managed 相容性](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/known-limitations/qsecm-compatibility.htm)。

```
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --exportQvf --reload --autoBinary --reportXlsx
```

## 批次移轉整個 QlikView 環境

掃描一或多個資料夾以尋找所有 QVW 和 PRJ 配對，平行轉換這些配對，並將每個部署到 Qlik Cloud。使用 `--batchWorkers` 來控制並行。

```
QV2QS.exe --batchDir C:\QVApps --outputDir C:\Output --generatePrj --qlikContext my-tenant --autoBinary --reload --batchWorkers 4 --reportXlsx
```

## 保留 QlikView 像素版面配置

啟用固定畫布模式以保留精確的 QlikView 物件位置和工作表背景。調整縮放比例以控制版面配置如何對應至 Qlik Sense 螢幕尺寸。

```
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --autoBinary --reload --fixedSheetCanvas --fixedSheetCanvasScale 1.5 --fixedSheetCanvasObjectScale 1.5
```

## 更新已轉換的應用程式

針對現有的 Qlik Cloud 應用程式重新執行轉換，而不建立新的應用程式。QV2QS 重複使用上次執行中的應用程式 ID。

```
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --autoBinary --reload --reportXlsx
```

## 更新應用程式，同時保留其載入指令碼

重新執行轉換以更新現有應用程式的 UI 圖層，而不覆寫載入指令碼。目標應用程式會保留其現有的資料連線和重新載入邏輯。更新前會自動匯出無資料備份。新增 `--reload` 以執行現有的指令碼並重新整理資料。

```
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --preserveTargetAppScript --reportXlsx
```

## 更新應用程式並保留其變數

重新執行轉換，以更新現有應用程式的 UI 圖層和載入指令碼，而不覆寫變數。與 `--preserveTargetAppScript` 結合，以保持目標應用程式中的載入指令碼和變數完整無缺。

```
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qlikContext my-tenant --reuseAppId --preserveTargetAppVariables --reportXlsx
```

## 設定 Qlik Cloud 驗證

在執行任何轉換之前，請先設定 qlik-cli 上下文。互動式設定會提示您輸入租用戶 URL 和 API 金鑰，並儲存認證以供後續執行使用。

```
QV2QS.exe --setupQlikAuth
```

## 程式化使用 (CI/CD)

QV2QS 支援直接驗證，無需預先建立 qlik-cli 上下文。內嵌傳遞租用戶 URL 和 API 金鑰。QV2QS 驗證憑證並將驗證標頭注入到每個 qlik-cli 呼叫中。未建立或修改任何內容檔案。使用 `--accept-eula` 以接受授權合約，無需互動式提示。

```
QV2QS.exe --accept-eula --generatePrj --qvw Sales.qvw --outputDir ./output --qlikTenantUrl https://my-tenant.us.qlikcloud.com --qlikApiKey eyJhbG... --qsAppName "Sales" --autoBinary --reload --plain
```

此模式對於多租戶和多用戶的並行執行是安全的。API 金鑰不會寫入磁碟，且不會出現在記錄檔中。

憑證也可以設定為環境變數：

```
set QV2QS_QLIK_TENANT_URL=https://my-tenant.us.qlikcloud.com
set QV2QS_QLIK_API_KEY=eyJhbG...
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qsAppName "Sales" --autoBinary --reload --plain
```

## 不使用 Qlik Cloud 的本機建置

在磁碟上產生轉換後的輸出和轉換報告，無需連線至 Qlik Cloud。僅限本機模式適用於移轉評估、部署前審查以及離線環境。本地建置輸出不包含媒體上傳、背景影像解析度、替代狀態建立或工作表發佈。若要完整部署，請使用建置至 Qlik Cloud 或匯出 QVF 模式。如需了解僅限本機的限制和使用案例的詳情，請參閱[轉換運作方式](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/getting-started/how-conversion-works.htm#local-only-mode)。

```
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --unbuildOnly
```

## 了解更多

* [引數參考](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm)
* [使用者介面](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/user-interface/index.htm)