# 快速入门

使用向导或命令行，运行首次端到端转换。

## 先决条件

* 一台 Windows 计算机 (Windows 10、11 或 Windows Server 2019、2022、2025)
* 在本地工作文件夹中，QlikView 文档（`.qvw` 或 QlikView 创建的 `.qvf` 文件）的一个 副本。Qlik Sense QVF 文件不是有效的源输入。不要将 QV2QS 指向位于共享驱动器上或 QlikView Server 挂载点上的生产文件。有关详细信息，请参阅[源文件安全](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/getting-started/how-conversion-works.htm#source-file-safety)。或者，使用其中一个捆绑的示例项目。请参阅[示例项目](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/getting-started/example-projects.htm)。
* 一个 Qlik Cloud 租户，已启用 API 密钥访问（用于云部署）。有关设置说明，请参阅[设置 Qlik Cloud 访问](https://help.qlik.com/zh-CN/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 文件夹，转换 UI，将应用程序连同数据部署到 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-CN/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm)。

## 预期内容

一次包含云部署和数据重新加载的单应用程序转换，通常在两到五分钟内端到端完成。本地转换步骤（PRJ 提取、XML 解析和 JSON 生成）在 30 秒内完成，即使对于复杂的应用程序也是如此。云部署和应用程序构建会增加一到三分钟。刷新时间完全取决于数据量和数据源配置。有关按管道步骤的详细计时细分，请参阅[转换的工作原理](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/getting-started/how-conversion-works.htm)。

## 生产了什么

成功转换后，项目子文件夹（例如，`./output/Sales/`）包含已转换的应用程序结构、提取的媒体、转换报告和诊断日志。有关完整说明，请参阅[转化如何运作](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/getting-started/how-conversion-works.htm)。

## 了解更多

* [用户界面](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/user-interface/index.htm)
* [常见工作流程](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/command-line-interface/common-workflows.htm)
* [转换布局设置](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/conversion-layout-settings/index.htm)
* [转化结果](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/conversion-results/conversion-outcomes.htm)