# 快速入門

使用精靈或命令列，執行首次端對端轉換。

## 必要條件

* 一台 Windows 機器 (Windows 10、11，或 Windows Server 2019、2022、2025)
* QlikView 文件的一份 副本 (`.qvw` 或 QlikView 建立的 `.qvf` 檔案) 在本機工作資料夾中。Qlik Sense QVF 檔案不是有效的來源輸入。不要將 QV2QS 指向共用磁碟機或 QlikView Server 掛載點上的生產檔案。詳情請參閱[原始檔案安全性](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/getting-started/how-conversion-works.htm#source-file-safety)。或者，使用其中一個隨附的範例專案。請參閱 [範例專案](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/getting-started/example-projects.htm)。
* 一個已啟用 API 金鑰存取的 Qlik Cloud 租用戶 (適用於雲端部署)。如需設定指示，請參閱[設定 Qlik Cloud 存取](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/getting-started/setting-up-qlik-cloud-access.htm)。

## 使用精靈

請執行下列動作：

1. 按兩下 `QV2QS.exe`。首次啟動時，QV2QS 會顯示授權合約。接受協議以繼續。精靈會在預設瀏覽器中開啟。
2. 在設定步驟中，選取建置至 Qlik Cloud。
3. 在 專案 步驟中，選取 QVW 檔案。保持啟用 自動產生 PRJ (將 QVW 檔案解壓縮成一組 XML 和文字檔案，QV2QS 會在轉換期間讀取這些檔案)。
4. 在輸出步驟中，選取輸出根資料夾。QV2QS 會自動建立一個以 QVW 檔案名稱命名的子資料夾。
5. 在 Qlik Cloud 驗證 步驟中，輸入租用戶 URL 和 API 金鑰。精靈會驗證連線。
6. 在 Qlik Cloud 應用程式 步驟中，輸入應用程式名稱。啟用重新載入和自動二進位，以將資料填入應用程式。
7. 在 檢閱 步驟中，驗證組態摘要。此精靈還包含樣式、進階和轉換報告等步驟，並提供合理的預設值。在執行前，請視需要調整這些步驟。
8. 按一下執行。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 會對未在命令列中指定的選項套用預設值。控制台輸出在深色模式下使用豐富的格式，會自動產生轉換報告，並且會使用動態格線版面配置，除非啟用固定畫布模式。如需引數和預設值的完整清單，請參閱 [引數參考](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm)。

## 預期內容

單一應用程式轉換搭配雲端部署和資料重新載入，通常會在兩到五分鐘內完成端對端作業。本地轉換步驟 (PRJ 提取、XML 解析和 JSON 生成) 即使對於複雜的應用程式，也能在 30 秒內完成。雲端部署和應用程式建置會增加一到三分鐘。重新載入時間完全取決於資料量和資料來源組態。如需依管道步驟的詳細時序解析，請參閱[轉換運作方式](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/getting-started/how-conversion-works.htm)。

## 產生了什麼

成功轉換後，專案子資料夾（例如，`./output/Sales/`）包含已轉換的應用程式結構、擷取的媒體、轉換報告和診斷記錄。如需完整說明，請參閱[轉換的運作方式](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/getting-started/how-conversion-works.htm)。

## 了解更多

* [使用者介面](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/user-interface/index.htm)
* [常見工作流程](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/command-line-interface/common-workflows.htm)
* [轉換版面配置設定](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/conversion-layout-settings/index.htm)
* [轉換結果](https://help.qlik.com/zh-TW/migration/Content/Qv2qsMigration/conversion-results/conversion-outcomes.htm)