常見工作流程

上次更新：2026/10/14

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

部署至 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.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 模式。如需了解僅限本機的限制和使用案例的詳情，請參閱轉換運作方式。

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

了解更多

• 引數參考
• 使用者介面