精靈步驟
上次更新：2026/10/14使用者介面是一個精靈式介面，引導使用者完成整個轉換過程。精靈會在預設瀏覽器中開啟，在雙擊 QV2QS.exe 或執行可執行檔並使用 --ui 旗標。目前的版本號碼會顯示在「關於」對話方塊中。一個佈景主題切換按鈕位於右上角，可在淺色和深色模式之間切換。如需更多資訊，請參閱 深色模式。
此精靈依序呈現下列步驟。不適用於所選工作流程模式的步驟會自動隱藏。
設定
選擇工作流程模式 (必填)。所選模式決定了哪些後續步驟可用。
- 建置至 Qlik Cloud (預設) — 轉換 QlikView UI 並將產生的應用程式直接部署到 Qlik Cloud 租用戶。選擇此模式以立即在 Qlik Cloud 中查看轉換後的應用程式。此模式是建議的移轉工作流程。
- 匯出 QVF — 使用 Qlik Cloud 引擎轉換 QlikView UI，將產生的應用程式匯出為 QVF 檔案，然後刪除該雲端應用程式。選擇此模式以產生檔案，供與其他團隊共用或匯入至不同的租用戶。此模式仍需要一個 Qlik Cloud 租用戶和 API 金鑰。匯入至 Qlik Sense Enterprise Client-Managed 的功能未經所有版本測試，且非官方支援。如需詳細資訊，請參閱 Qlik Sense Enterprise Client-Managed 相容性。
- 僅限本機 — 在磁碟上執行轉換，而不連線至 Qlik Cloud。不需要 Qlik Cloud 租用戶或 API 金鑰。僅限本機模式會產生完整的轉換報告和建置輸出，以供評估、檢閱或離線使用。本地建置輸出不包含媒體上傳、背景影像解析度、替代狀態建立或工作表發佈 — 這些操作需要部署階段。若要完整部署，請使用建置至 Qlik Cloud 或匯出 QVF 模式。有關僅限本機限制的詳細資訊，請參閱轉換運作方式。將建置輸出目標設定為 QSECM 並未在所有版本中進行測試，也未獲官方支援。如需詳細資訊，請參閱 Qlik Sense Enterprise Client-Managed 相容性。
專案
設定輸入來源。執行下列其中一個動作：
- 單一專案 (預設)：提供 QVW 檔案 (必填)。自動產生 PRJ 預設為啟用，並自動從 QVW 檔案產生 PRJ 資料夾。停用此選項，即可手動提供 PRJ 資料夾或 ZIP 檔案。點擊 試用範例 以載入內建範例專案，無需瀏覽。此按鈕僅在 QVW 欄位為空時才可見。請參閱範例專案。
- 批次：提供一個或多個要掃描的資料夾（必填）。QV2QS 遞迴地探索所有匹配的 QVW 和 PRJ 配對。點擊 試用範例 以內建範例資料夾填入資料夾欄位。批次工作者 控制有多少個轉換平行執行 (預設：根據 CPU 核心自動偵測)。如需詳細資訊，請參閱 批次轉換。
始終將 QV2QS 指向本機工作資料夾中的來源文件副本，而非指向 QlikView Server 或共用網路磁碟機上的生產檔案。QlikView Desktop 引擎在 PRJ 產生期間會取得檔案鎖定，這可能會與作用中 QlikView 工作階段衝突。詳情請參閱 來源檔案安全性。
輸出
設定輸出根資料夾 (必填)。QV2QS 會在輸出根目錄中自動建立一個以專案命名的子資料夾 (例如，<outputDir>/Sales/)。如果兩個專案共用相同的名稱，則會附加_2、_3尾碼以避免衝突。啟用 清理日誌 以在執行前刪除現有的日誌檔案。
Qlik Cloud 驗證
此步驟僅出現在建置至 Qlik Cloud 和匯出 QVF 模式中。
選擇或建立 qlik-cli 內容，以驗證 Qlik Cloud 租用戶 (必要)。透過提供租用戶 URL 和 API 金鑰，建立新的上下文。精靈會在繼續之前驗證連線。
Qlik Cloud 應用程式
此步驟僅出現在建置至 Qlik Cloud 和匯出 QVF 模式中。
| 設定 | 描述 | 預設值 |
|---|---|---|
| 應用程式名稱 | Qlik Cloud 中 Qlik Sense 應用程式的名稱 | QVW 檔案名稱、PRJ 資料夾名稱或輸出資料夾名稱 |
| 載入 | 建置後重新載入應用程式以執行載入指令碼 | 開啟 |
| 自動二進位 | 暫時上傳 QVW 檔案以載入二進位資料，然後在重新載入後刪除該檔案。需要 重新載入。 | 開啟 |
| 二進位 AppId | 使用現有的 QVW 或 QVF 應用程式在 Qlik Cloud 中進行二進位載入，而非上傳。需要重新載入。點擊瀏覽按鈕以開啟 QVW 選擇器。 | — |
| 重複使用現有的應用程式 | 更新先前建立的應用程式，而不是建立新的應用程式。啟用後，QV2QS 會檢查輸出資料夾中是否有符合所選 QVW 檔案的先前部署，並自動填入應用程式 ID。如果找不到先前的部署，請手動輸入應用程式 ID 或按一下瀏覽按鈕以開啟 QVF 選擇器。 | 關閉 |
| 保留載入指令碼 | 保留目標應用程式中現有的載入指令碼。已轉換的指令碼未套用。需要 重複使用現有的應用程式。預設關閉 重新載入；重新啟用以執行現有的指令碼。 | 關閉 |
| 保留變數 | 保留目標應用程式中現有的變數。轉換後的變數未套用。需要重複使用現有的應用程式。 | 關閉 |
| 跳過部署前備份 | 在覆寫應用程式之前，請勿匯出 QVF 備份。依預設，無資料備份會儲存到 cloud/backups/。需要重複使用現有的應用程式。 |
關閉 |
| 發佈工作表 | 建置後，將所有轉換後的圖紙發佈為基礎圖紙。基本工作表可供所有有權存取該應用程式的使用者檢視。停用此設定，以將工作表保留為個人（未發佈）物件。當 重複使用現有應用程式 啟用時，此設定僅適用於新工作表。先前發佈的工作表會自動還原，無論此設定為何。 | 開啟 |
| 在沒有資料的情況下建置 | 跳過建置階段的資料載入。該應用程式在租用戶上組裝，且不含任何資料，以便在無需等待重新載入的情況下測試使用者介面結構。 | 關閉 |
| 匯出時不含資料 | 從匯出的 QVF 檔案中移除資料。此雲端應用程式可能仍包含來自組建的資料，但下載的 QVF 較小。僅限匯出 QVF 模式。 | 關閉 |
「二進位應用程式 ID」和「重複使用現有應用程式」欄位包含瀏覽按鈕，可開啟雲端應用程式選取器強制回應視窗。每個選取器都會從已連線的租用戶載入應用程式，並可透過名稱、擁有者、空間或應用程式 ID 進行搜尋篩選。QVW 選擇器也提供一個應用程式類型篩選器 (QVW、QVF 或全部)。選擇清單中的應用程式，以自動填入欄位。
表情調整
樣式
下列設定控制工作表外觀與版面配置行為。
佈景主題
| 設定 | 描述 | 預設值 |
|---|---|---|
| 應用程式佈景主題 | Qlik Sense 佈景主題已套用至轉換後的應用程式。下拉式清單列出四個內建的 Qlik 主題。當 Qlik Cloud 內容已設定時，按一下重新整理按鈕以擷取安裝在租用戶上的自訂佈景主題。Sense Classic 與 QlikView 之間具有最高的 1:1 擬真度。非經典佈景主題可能會變更物件邊框、背景顏色、字型和邊距。佈景主題僅設定預設值；使用者可以隨時在 Qlik Sense 用戶端中切換佈景主題。 | Sense 經典 |
背景
| 設定 | 描述 | 預設值 |
|---|---|---|
| 工作表背景圖片 | 擷取並套用 QlikView 工作表背景圖片 | 開啟 |
| 回退至文件背景 | 對於沒有背景的工作表，使用文件層級背景 | 開啟 |
| 背景色彩覆寫 | 純色填滿已套用至所有工作表 (#RRGGBB) |
— |
版面配置
| 設定 | 描述 | 預設值 |
|---|---|---|
| 顯示工作表標題 | 新增標頭區域至已轉換的工作表 | 關閉 |
| 略過隱藏工作表 | 省略顯示條件恆為假的工作表 | 關閉 |
清單方塊與排序
| 設定 | 描述 | 預設值 |
|---|---|---|
| 保留 QV 列表框顏色 | 套用原始 QlikView 列表框背景顏色和透明度 | 開啟 |
| 日期欄位排序防護 | 讓日期類型的清單方塊欄位 (年、季、月及類似欄位) 依時間順序排序，而非依選取狀態。如需更多資訊，請參閱引數參考。 | 開啟 |
進階
指令碼取代區段包含一個內嵌規則編輯器。切換主開關以啟用或停用所有指令碼處理。展開此區段以檢視、新增、編輯或刪除個別規則。每條規則都可以獨立開啟或關閉。點擊 重設為預設值 以還原八個內建規則。摘要徽章顯示已啟用規則的數量。
點擊規則上的上下箭頭按鈕，即可變更執行順序。執行順序較低的規則會先執行。點擊 Export，即可將所有規則下載為 JSON 檔案。點擊 匯入 以從 JSON 檔案載入規則，取代目前的設定。匯入的檔案必須包含一個 JSON 陣列，其中每個規則都具有 description、pattern 以及 search 欄位。
若要建立用於匯入的自訂規則檔案，請先按一下 匯出，以取得正確格式的內建規則。編輯匯出的檔案以新增、移除或修改規則，然後按一下匯入以載入更新後的設定。
當設定了自訂規則或停用的預設值時，命令預覽會顯示通知。複製的指令不包含自訂規則。匯出規則至 JSON 檔案並新增 --scriptReplacements <path> 至指令以在命令列中包含自訂規則。
如需了解規則的運作方式，包括兩階段比對程序和內建規則清單，請參閱引數參考。
開啟 Mockup Studio，從「進階」步驟互動式預覽固定畫布和動態格線版面配置、調整縮放比例，並將設定套用回精靈。
轉換報告
以下設定控制轉換報告輸出。
| 設定 | 描述 | 預設值 |
|---|---|---|
| 產生報告 | 產生一份主控台轉換報告 | 開啟 |
| Excel 報表 | 將報告匯出為 XLSX 檔案，包含每個物件的詳細資料以及自動化評分。輸入檔案名稱 (例如MyReport) 或完整路徑。.xlsx 延伸會自動新增。留空以在 reports/ 中自動命名。 |
開啟 |
| 包含選取項目和搜尋物件 | 在報表中包含目前的選取方塊和搜尋物件。這些是由 Qlik Sense 自動新增的，並預設為已排除。 | 關閉 |
檢閱
執行前請確認所有設定。審閱步驟會顯示專案、工作流程、雲端和輸出組態的摘要卡片。在批次模式中，表格會列出所有已探索的專案。
側邊欄中的必要動作清單會追蹤在執行前必須設定的項目。項目依類別分組：工作流程、輸入、輸出和雲端驗證。每個項目在配置完成時顯示 正常，或在缺少值時顯示 待設定。點擊項目以直接導覽至相關的精靈步驟。
一個 命令預覽 面板會顯示目前精靈組態的等效 CLI 命令。在 PowerShell 和 Bash 語法之間切換。按一下複製以將命令複製到剪貼簿。命令預覽對於學習 CLI 引數或儲存確切的命令以供指令碼重複執行很有用。
點擊 執行 以開始轉換。
執行
顯示轉換執行時的即時主控台輸出。停止執行中的轉換、追蹤即時記錄，並在執行完成時開啟輸出資料夾或 Qlik Cloud 應用程式。