快速入門
上次更新:2026/10/14使用精靈或命令列,執行首次端對端轉換。
必要條件
- 一台 Windows 機器 (Windows 10、11,或 Windows Server 2019、2022、2025)
- QlikView 文件的一份 副本 (
.qvw或 QlikView 建立的.qvf檔案) 在本機工作資料夾中。Qlik Sense QVF 檔案不是有效的來源輸入。不要將 QV2QS 指向共用磁碟機或 QlikView Server 掛載點上的生產檔案。詳情請參閱原始檔案安全性。或者,使用其中一個隨附的範例專案。請參閱 範例專案。 - 一個已啟用 API 金鑰存取的 Qlik Cloud 租用戶 (適用於雲端部署)。如需設定指示,請參閱設定 Qlik Cloud 存取。
使用精靈
請執行下列動作:
- 按兩下
QV2QS.exe。首次啟動時,QV2QS 會顯示授權合約。接受協議以繼續。精靈會在預設瀏覽器中開啟。 - 在設定步驟中,選取建置至 Qlik Cloud。
- 在 專案 步驟中,選取 QVW 檔案。保持啟用 自動產生 PRJ (將 QVW 檔案解壓縮成一組 XML 和文字檔案,QV2QS 會在轉換期間讀取這些檔案)。
- 在輸出步驟中,選取輸出根資料夾。QV2QS 會自動建立一個以 QVW 檔案名稱命名的子資料夾。
- 在 Qlik Cloud 驗證 步驟中,輸入租用戶 URL 和 API 金鑰。精靈會驗證連線。
- 在 Qlik Cloud 應用程式 步驟中,輸入應用程式名稱。啟用重新載入和自動二進位,以將資料填入應用程式。
- 在 檢閱 步驟中,驗證組態摘要。此精靈還包含樣式、進階和轉換報告等步驟,並提供合理的預設值。在執行前,請視需要調整這些步驟。
- 按一下執行。QV2QS 會產生 PRJ 資料夾、轉換 QlikView UI、將應用程式部署到 Qlik Cloud,並產生轉換報告。
轉換完成後,執行摘要儀表板會顯示轉換指標和追蹤項目。直接從摘要開啟 Qlik Cloud 應用程式,以檢閱已轉換的資料表。
使用命令列
以下範例從 QVW 檔案產生 PRJ 資料夾、轉換使用者介面、將應用程式與資料部署到 Qlik Cloud,並產生 Excel 報告:
QV2QS.exe --generatePrj --qvw Sales.qvw --outputDir ./output --qsAppName "Sales" --qlikContext my-tenant --autoBinary --reload --reportXlsx
此--autoBinary旗標會將 QVW 檔案暫時上傳至 Qlik Cloud,以便轉換後的應用程式可以透過Binary陳述式載入資料。重新載入完成後,QV2QS 會刪除上傳的檔案,並還原原始的載入指令碼到雲端應用程式中。
QV2QS 會對未在命令列中指定的選項套用預設值。控制台輸出在深色模式下使用豐富的格式,會自動產生轉換報告,並且會使用動態格線版面配置,除非啟用固定畫布模式。如需引數和預設值的完整清單,請參閱 引數參考。
預期內容
單一應用程式轉換搭配雲端部署和資料重新載入,通常會在兩到五分鐘內完成端對端作業。本地轉換步驟 (PRJ 提取、XML 解析和 JSON 生成) 即使對於複雜的應用程式,也能在 30 秒內完成。雲端部署和應用程式建置會增加一到三分鐘。重新載入時間完全取決於資料量和資料來源組態。如需依管道步驟的詳細時序解析,請參閱轉換運作方式。
產生了什麼
成功轉換後,專案子資料夾(例如,./output/Sales/)包含已轉換的應用程式結構、擷取的媒體、轉換報告和診斷記錄。如需完整說明,請參閱轉換的運作方式。