向导步骤
上次更新日期：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 文件用于二进制数据加载，然后在重新加载后删除该文件。需要 重新加载。 | 开启 |
| 二进制应用ID | 使用 Qlik Cloud 中现有的 QVW 或 QVF 应用程序进行二进制加载，而不是上传。需要重新加载。点击浏览按钮以打开 QVW 选择器。 | — |
| 重用现有应用程序 | 更新一个之前创建的应用程序，而不是创建一个新的。启用后，QV2QS 会检查输出文件夹以查找与所选 QVW 文件匹配的之前的部署，并自动填充应用程序 ID。如果未找到之前的部署，请手动输入应用程序 ID 或点击浏览按钮以打开 QVF 选择器。 | 关 |
| 保留加载脚本 | 保留目标应用程序中现有的加载脚本。已转换的脚本未应用。需要 复用现有应用程序。默认关闭 重新加载；重新启用以执行现有脚本。 | 关 |
| 保留变量 | 保留目标应用程序中的现有变量。转换后的变量未应用。需要重用现有应用程序。 | 关 |
| 跳过部署前备份 | 在覆盖该应用程序之前，请勿导出 QVF 备份。默认情况下，无数据备份将保存到 cloud/backups/。需要重用现有应用程序。 |
关 |
| 发布工作表 | 构建后，将所有转换后的工作表发布为基础工作表。基础工作表对所有有权访问该应用程序的用户都可见。禁用此设置可将工作表保留为个人（未发布）对象。当 复用现有应用程序 启用时，此设置仅适用于新工作表。之前发布的表格会自动恢复，不受此设置影响。 | 开启 |
| 无数据构建 | 在构建阶段跳过数据加载。该应用程序在租户上组装，不带任何数据，从而可以在不等待重新加载的情况下测试 UI 结构。 | 关 |
| 不连同数据导出 | 从导出的 QVF 文件中剥离数据。云应用程序可能仍包含来自构建的数据，但下载的 QVF 更小。仅导出 QVF 模式。 | 关 |
“二进制应用程序 ID”和“重用现有应用程序”字段包含浏览按钮，这些按钮会打开云应用程序选择器模态窗口。每个选择器都会从连接的租户加载应用程序，并支持按名称、所有者、空间或应用程序 ID 进行搜索筛选。QVW 选择器还提供一个应用程序类型筛选器（QVW、QVF 或全部）。从列表中选择一个应用程序，即可自动填充该字段。
表达式调整
式样
以下设置控制工作表外观和布局行为。
主题
| 设置 | 描述 | 默认 |
|---|---|---|
| 应用主题 | Qlik Sense 主题已应用于转换后的应用程序。下拉列表列出了四个内置的 Qlik 主题。当 Qlik Cloud 上下文配置完成后，点击刷新按钮以获取安装在租户上的自定义主题。Sense 经典版 提供与 QlikView 最高的 1:1 还原度。非经典主题可能会改变对象边框、背景颜色、字体和填充。主题仅设置默认值；用户可以随时在 Qlik Sense 客户端中切换主题。 | Sense 经典 |
背景
| 设置 | 描述 | 默认 |
|---|---|---|
| 工作表背景图片 | 提取并应用 QlikView 工作表壁纸 | 开启 |
| 回退到文档背景 | 对于没有背景的图纸，使用文档级背景 | 开启 |
| 背景颜色覆盖 | 所有工作表均应用纯色填充 (#RRGGBB) |
— |
布局
| 设置 | 描述 | 默认 |
|---|---|---|
| 显示工作表标题 | 为转换后的工作表添加页眉区域 | 关 |
| 跳过隐藏工作表 | 忽略显示条件始终为假的工作表 | 关 |
列表框和排序
| 设置 | 描述 | 默认 |
|---|---|---|
| 保留 QV 列表框颜色 | 应用原始 QlikView 列表框背景颜色和透明度 | 开启 |
| 日期字段排序保护 | 保持日期类列表框字段（年、季度、月等）按时间顺序排序，而不是按选择项状态排序。有关更多信息，请参阅参数参考。 | 开启 |
高级
该 脚本替换 部分包含一个内联规则编辑器。切换主开关以启用或禁用所有脚本处理。展开该部分以查看、添加、编辑或删除单个规则。每条规则都可以独立开启或关闭。点击 重置为默认值 以恢复八个内置规则。摘要徽章显示已启用规则数。
点击规则上的向上和向下箭头按钮以更改执行顺序。执行顺序较低的规则会首先运行。点击 导出 以 JSON 文件格式下载所有规则。点击 Import 从 JSON 文件加载规则，替换当前规则集。导入的文件必须包含一个JSON数组，其中每个规则都具有description、pattern和search字段。
要创建用于导入的自定义规则文件，请首先点击 Export 以获取正确格式的内置规则。编辑导出的文件以添加、删除或修改规则，然后点击导入以加载更新后的设置。
当配置了自定义规则或禁用的默认值时，命令预览会显示一条通知。复制的命令不包含自定义规则。将规则导出到 JSON 文件，并添加 --scriptReplacements <path> 到命令中，以在命令行中包含自定义规则。
有关规则如何运作的说明，包括两阶段匹配过程和内置规则列表，请参阅参数参考。
打开Mockup Studio，从“高级”步骤中交互式预览固定画布和动态网格布局，调整缩放，并将设置应用回向导。
转化报告
以下设置控制转换报表输出。
| 设置 | 描述 | 默认 |
|---|---|---|
| 生成报告 | 生成控制台转换报告 | 开启 |
| Excel 报告 | 将报告导出为 XLSX 文件，包含按对象划分的详细信息和自动化评分。输入文件名 (例如MyReport) 或完整路径该 .xlsx 扩展 会自动添加。留空以在reports/中自动命名。 |
开启 |
| 包含选择和搜索对象 | 在报告中包含当前选择框和搜索对象。这些由 Qlik Sense 自动添加，并默认排除。 | 关 |
审核
运行前请确认所有设置。审核步骤会显示项目、工作流、云和输出配置的摘要卡片。在批处理模式下，一个表格列出了所有发现的项目。
侧边栏中的所需操作清单会跟踪在运行前必须配置的项目。项目按类别分组：工作流、输入、输出和云身份验证。每个项目在配置后显示正常，或在缺少值时显示未设置。点击一项以直接导航到相关的向导步骤。
一个 命令预览 面板显示当前向导配置对应的 CLI 命令。切换 PowerShell 和 Bash 语法。单击复制以将命令复制到剪贴板。命令预览有助于学习 CLI 参数，或保存确切的命令以便脚本化重复运行。
点击 运行 开始转换。
运行
显示转换执行时的实时控制台输出。停止正在运行的转换，实时关注日志，并在运行完成后打开输出文件夹或 Qlik Cloud 应用程序。