快速入门
上次更新日期：2026/10/14使用向导或命令行，运行首次端到端转换。
先决条件
- 一台 Windows 计算机 (Windows 10、11 或 Windows Server 2019、2022、2025)
- 在本地工作文件夹中，QlikView 文档（
.qvw或 QlikView 创建的.qvf文件）的一个 副本。Qlik Sense QVF 文件不是有效的源输入。不要将 QV2QS 指向位于共享驱动器上或 QlikView Server 挂载点上的生产文件。有关详细信息，请参阅源文件安全。或者，使用其中一个捆绑的示例项目。请参阅示例项目。 - 一个 Qlik Cloud 租户，已启用 API 密钥访问（用于云部署）。有关设置说明，请参阅设置 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 文件夹，转换 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 会为命令行中未指定的选项应用默认值。控制台输出在暗模式下使用富格式，自动生成转换报告，并使用动态网格布局，除非启用固定画布模式。有关参数和默认值的完整列表，请参阅 参数参考。
预期内容
一次包含云部署和数据重新加载的单应用程序转换，通常在两到五分钟内端到端完成。本地转换步骤（PRJ 提取、XML 解析和 JSON 生成）在 30 秒内完成，即使对于复杂的应用程序也是如此。云部署和应用程序构建会增加一到三分钟。刷新时间完全取决于数据量和数据源配置。有关按管道步骤的详细计时细分，请参阅转换的工作原理。
生产了什么
成功转换后，项目子文件夹（例如，./output/Sales/）包含已转换的应用程序结构、提取的媒体、转换报告和诊断日志。有关完整说明，请参阅转化如何运作。