# 精靈步驟 使用者介面是一個精靈式介面，引導使用者完成整個轉換過程。精靈會在預設瀏覽器中開啟，在雙擊 `QV2QS.exe` 或執行可執行檔並使用 `--ui` 旗標。目前的版本號碼會顯示在「關於」對話方塊中。一個佈景主題切換按鈕位於右上角，可在淺色和深色模式之間切換。如需更多資訊，請參閱 [深色模式](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/user-interface/index.htm#dark-mode)。 此精靈依序呈現下列步驟。不適用於所選工作流程模式的步驟會自動隱藏。 ## 設定 選擇工作流程模式 (必填)。所選模式決定了哪些後續步驟可用。 * 建置至 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 相容性](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/known-limitations/qsecm-compatibility.htm)。 * 僅限本機 — 在磁碟上執行轉換，而不連線至 Qlik Cloud。不需要 Qlik Cloud 租用戶或 API 金鑰。僅限本機模式會產生完整的轉換報告和建置輸出，以供評估、檢閱或離線使用。本地建置輸出不包含媒體上傳、背景影像解析度、替代狀態建立或工作表發佈 — 這些操作需要部署階段。若要完整部署，請使用建置至 Qlik Cloud 或匯出 QVF 模式。有關僅限本機限制的詳細資訊，請參閱[轉換運作方式](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/getting-started/how-conversion-works.htm#local-only-mode)。將建置輸出目標設定為 QSECM 並未在所有版本中進行測試，也未獲官方支援。如需詳細資訊，請參閱 [Qlik Sense Enterprise Client-Managed 相容性](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/known-limitations/qsecm-compatibility.htm)。 ## 專案 設定輸入來源。執行下列其中一個動作： * 單一專案 (預設)：提供 QVW 檔案 (必填)。自動產生 PRJ 預設為啟用，並自動從 QVW 檔案產生 PRJ 資料夾。停用此選項，即可手動提供 PRJ 資料夾或 ZIP 檔案。點擊 試用範例 以載入內建範例專案，無需瀏覽。此按鈕僅在 QVW 欄位為空時才可見。請參閱[範例專案](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/getting-started/example-projects.htm)。 * 批次：提供一個或多個要掃描的資料夾（必填）。QV2QS 遞迴地探索所有匹配的 QVW 和 PRJ 配對。點擊 試用範例 以內建範例資料夾填入資料夾欄位。批次工作者 控制有多少個轉換平行執行 (預設：根據 CPU 核心自動偵測)。如需詳細資訊，請參閱 [批次轉換](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/batch-conversion/index.htm)。 警告備註 始終將 QV2QS 指向本機工作資料夾中的來源文件副本，而非指向 QlikView Server 或共用網路磁碟機上的生產檔案。QlikView Desktop 引擎在 PRJ 產生期間會取得檔案鎖定，這可能會與作用中 QlikView 工作階段衝突。詳情請參閱 [來源檔案安全性](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/getting-started/how-conversion-works.htm#source-file-safety)。 ## 輸出 設定輸出根資料夾 (必填)。QV2QS 會在輸出根目錄中自動建立一個以專案命名的子資料夾 (例如，`/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 或全部)。選擇清單中的應用程式，以自動填入欄位。 表情調整 | 設定 | 描述 | 預設值 | | --- | --- | --- | | 修正單引號搜尋值 | 在集合分析運算式中，將單引號萬用字元和比較轉換為雙引號。如需更多資訊，請參閱[引數參考](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm)。 | 開啟 | | 修正未加引號的設定值 (實驗性) | 在集合分析表達式中，將未加引號的裸字串值用單引號括起來。如需更多資訊，請參閱[引數參考](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm)。 | 關閉 | ## 樣式 下列設定控制工作表外觀與版面配置行為。 佈景主題 | 設定 | 描述 | 預設值 | | --- | --- | --- | | 應用程式佈景主題 | Qlik Sense 佈景主題已套用至轉換後的應用程式。下拉式清單列出四個內建的 Qlik 主題。當 Qlik Cloud 內容已設定時，按一下重新整理按鈕以擷取安裝在租用戶上的自訂佈景主題。Sense Classic 與 QlikView 之間具有最高的 1:1 擬真度。非經典佈景主題可能會變更物件邊框、背景顏色、字型和邊距。佈景主題僅設定預設值；使用者可以隨時在 Qlik Sense 用戶端中切換佈景主題。 | Sense 經典 | 背景 | 設定 | 描述 | 預設值 | | --- | --- | --- | | 工作表背景圖片 | 擷取並套用 QlikView 工作表背景圖片 | 開啟 | | 回退至文件背景 | 對於沒有背景的工作表，使用文件層級背景 | 開啟 | | 背景色彩覆寫 | 純色填滿已套用至所有工作表 (`#RRGGBB`) | — | 版面配置 | 設定 | 描述 | 預設值 | | --- | --- | --- | | 顯示工作表標題 | 新增標頭區域至已轉換的工作表 | 關閉 | | 略過隱藏工作表 | 省略顯示條件恆為假的工作表 | 關閉 | 清單方塊與排序 | 設定 | 描述 | 預設值 | | --- | --- | --- | | 保留 QV 列表框顏色 | 套用原始 QlikView 列表框背景顏色和透明度 | 開啟 | | 日期欄位排序防護 | 讓日期類型的清單方塊欄位 (年、季、月及類似欄位) 依時間順序排序，而非依選取狀態。如需更多資訊，請參閱[引數參考](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm)。 | 開啟 | ## 進階 | 設定 | 描述 | 預設值 | | --- | --- | --- | | 固定工作表畫布 | 啟用像素級精確的 QlikView 樣式定位。顯示縮放比例、最小尺寸和畫布裁切選項。畫布比例和物件比例預設為連結；按一下鏈條圖示以設定獨立值。如需詳細資訊，請參閱[轉換版面配置設定](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/conversion-layout-settings/index.htm)。 | 開啟 | | 自動延伸動態工作表 | 允許工作表垂直成長，超出預設的格線高度 | 開啟 | | 媒體上傳工作者 | 上傳媒體檔案 (桌布和影像) 到 Qlik Cloud 的平行工作者數量。適用於建置至 Qlik Cloud 和匯出 QVF 模式。 | `2` | | 指令碼取代 | 開啟或關閉指令碼替換處理，並管理個別規則。如需更多資訊，請參閱[引數參考](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm)。 | 開啟 | 指令碼取代區段包含一個內嵌規則編輯器。切換主開關以啟用或停用所有指令碼處理。展開此區段以檢視、新增、編輯或刪除個別規則。每條規則都可以獨立開啟或關閉。點擊 重設為預設值 以還原八個內建規則。摘要徽章顯示已啟用規則的數量。 點擊規則上的上下箭頭按鈕，即可變更執行順序。執行順序較低的規則會先執行。點擊 Export，即可將所有規則下載為 JSON 檔案。點擊 匯入 以從 JSON 檔案載入規則，取代目前的設定。匯入的檔案必須包含一個 JSON 陣列，其中每個規則都具有 `description`、`pattern` 以及 `search` 欄位。 提示備註 若要建立用於匯入的自訂規則檔案，請先按一下 匯出，以取得正確格式的內建規則。編輯匯出的檔案以新增、移除或修改規則，然後按一下匯入以載入更新後的設定。 資訊備註 當設定了自訂規則或停用的預設值時，命令預覽會顯示通知。複製的指令不包含自訂規則。匯出規則至 JSON 檔案並新增 `--scriptReplacements ` 至指令以在命令列中包含自訂規則。 如需了解規則的運作方式，包括兩階段比對程序和內建規則清單，請參閱[引數參考](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm)。 提示備註 開啟 Mockup Studio，從「進階」步驟互動式預覽固定畫布和動態格線版面配置、調整縮放比例，並將設定套用回精靈。 ## 轉換報告 以下設定控制轉換報告輸出。 | 設定 | 描述 | 預設值 | | --- | --- | --- | | 產生報告 | 產生一份主控台轉換報告 | 開啟 | | Excel 報表 | 將報告匯出為 XLSX 檔案，包含每個物件的詳細資料以及自動化評分。輸入檔案名稱 (例如`MyReport`) 或完整路徑。`.xlsx` 延伸會自動新增。留空以在 `reports/` 中自動命名。 | 開啟 | | 包含選取項目和搜尋物件 | 在報表中包含目前的選取方塊和搜尋物件。這些是由 Qlik Sense 自動新增的，並預設為已排除。 | 關閉 | ## 檢閱 執行前請確認所有設定。審閱步驟會顯示專案、工作流程、雲端和輸出組態的摘要卡片。在批次模式中，表格會列出所有已探索的專案。 側邊欄中的必要動作清單會追蹤在執行前必須設定的項目。項目依類別分組：工作流程、輸入、輸出和雲端驗證。每個項目在配置完成時顯示 正常，或在缺少值時顯示 待設定。點擊項目以直接導覽至相關的精靈步驟。 一個 命令預覽 面板會顯示目前精靈組態的等效 CLI 命令。在 PowerShell 和 Bash 語法之間切換。按一下複製以將命令複製到剪貼簿。命令預覽對於學習 CLI 引數或儲存確切的命令以供指令碼重複執行很有用。 點擊 執行 以開始轉換。 ## 執行 顯示轉換執行時的即時主控台輸出。停止執行中的轉換、追蹤即時記錄，並在執行完成時開啟輸出資料夾或 Qlik Cloud 應用程式。 ## 了解更多 * [執行摘要儀表板](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/user-interface/executive-summary-dashboard.htm) * [命令列介面](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/command-line-interface/index.htm) * [轉換版面配置設定](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/conversion-layout-settings/index.htm) * [部署至 Qlik Cloud](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/deploying-to-qlik-cloud/index.htm)