# 向导步骤

用户界面是一个向导式界面，用于完整的转换过程。向导会在默认浏览器中打开，在双击`QV2QS.exe`或使用`--ui`标志运行可执行文件后。当前版本号显示在“关于”对话框中。一个主题切换按钮位于右上角，可在浅色模式和深色模式之间切换。有关更多信息，请参阅[深色模式](https://help.qlik.com/zh-CN/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-CN/migration/Content/Qv2qsMigration/known-limitations/qsecm-compatibility.htm)。
* 仅限本地 — 在磁盘上执行转换，不连接到 Qlik Cloud。不需要 Qlik Cloud 租户或 API 密钥。本地模式生成完整的转换报告和构建输出，用于评估、审查或离线使用。本地构建输出不包括媒体上传、背景图像解析、备用状态创建或工作表发布 — 这些操作需要部署阶段。对于完整的部署，请使用构建到 Qlik Cloud 或导出 QVF 模式。有关仅限本地的限制的详细信息，请参阅[转换的工作原理](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/getting-started/how-conversion-works.htm#local-only-mode)。以构建输出为目标 QSECM 未在所有版本中进行测试，也未获得官方支持。详情请参阅 [Qlik Sense Enterprise Client-Managed 兼容性](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/known-limitations/qsecm-compatibility.htm)。

## 项目

配置输入源。执行以下选项之一：

* 单个项目 （默认）：提供一个 QVW 文件（必需）。自动生成 PRJ 默认启用，并自动从 QVW 文件生成 PRJ 文件夹。禁用此选项，以便手动提供 PRJ 文件夹或 ZIP 文件。点击尝试示例以加载捆绑的示例项目，无需浏览。此按钮仅当 QVW 字段为空时可见。请参阅[示例项目](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/getting-started/example-projects.htm)。
* 批量：提供一个或多个要扫描的文件夹（必填）。QV2QS 递归发现所有匹配的 QVW 和 PRJ 对。点击 尝试示例 以使用捆绑的示例文件夹填充文件夹字段。批处理工作器 控制并行运行的转换数量（默认值：根据CPU核心数自动检测）。有关更多信息，请参阅[批量转换](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/batch-conversion/index.htm)。

警告注释

始终将 QV2QS 指向本地工作文件夹中的源文档副本，而不是指向 QlikView Server 或共享网络驱动器上的生产文件。QlikView Desktop 引擎在 PRJ 生成期间获取文件锁，这可能会与激活的 QlikView 会话冲突。有关详细信息，请参阅[源文件安全](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/getting-started/how-conversion-works.htm#source-file-safety)。

## 输出

设置输出根文件夹（必填）。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 或全部）。从列表中选择一个应用程序，即可自动填充该字段。

表达式调整

| 设置 | 描述 | 默认 |
| --- | --- | --- |
| 修复单引号引用的搜索值 | 在集合分析表达式中，将单引号通配符和比较转换为双引号。有关更多信息，请参阅[参数参考](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm)。 | 开启 |
| 修复未加引号的设置值 (实验性) | 在集合分析表达式中，将未加引号的裸字符串值用单引号括起来。有关更多信息，请参阅[参数参考](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm)。 | 关 |

## 式样

以下设置控制工作表外观和布局行为。

主题

| 设置 | 描述 | 默认 |
| --- | --- | --- |
| 应用主题 | Qlik Sense 主题已应用于转换后的应用程序。下拉列表列出了四个内置的 Qlik 主题。当 Qlik Cloud 上下文配置完成后，点击刷新按钮以获取安装在租户上的自定义主题。Sense 经典版 提供与 QlikView 最高的 1:1 还原度。非经典主题可能会改变对象边框、背景颜色、字体和填充。主题仅设置默认值；用户可以随时在 Qlik Sense 客户端中切换主题。 | Sense 经典 |

背景

| 设置 | 描述 | 默认 |
| --- | --- | --- |
| 工作表背景图片 | 提取并应用 QlikView 工作表壁纸 | 开启 |
| 回退到文档背景 | 对于没有背景的图纸，使用文档级背景 | 开启 |
| 背景颜色覆盖 | 所有工作表均应用纯色填充 (`#RRGGBB`) | — |

布局

| 设置 | 描述 | 默认 |
| --- | --- | --- |
| 显示工作表标题 | 为转换后的工作表添加页眉区域 | 关 |
| 跳过隐藏工作表 | 忽略显示条件始终为假的工作表 | 关 |

列表框和排序

| 设置 | 描述 | 默认 |
| --- | --- | --- |
| 保留 QV 列表框颜色 | 应用原始 QlikView 列表框背景颜色和透明度 | 开启 |
| 日期字段排序保护 | 保持日期类列表框字段（年、季度、月等）按时间顺序排序，而不是按选择项状态排序。有关更多信息，请参阅[参数参考](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm)。 | 开启 |

## 高级

| 设置 | 描述 | 默认 |
| --- | --- | --- |
| 固定工作表画布 | 启用像素级精确的 QlikView 样式定位。揭示缩放因子、最小尺寸和画布裁剪选项。画布缩放和对象缩放默认关联；点击链条图标可设置独立值。更多信息，请参阅 [转换布局设置](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/conversion-layout-settings/index.htm)。 | 开启 |
| 自动扩展动态工作表 | 允许工作表垂直增长，超出默认网格高度 | 开启 |
| 媒体上传工作器 | 用于将媒体文件（壁纸和图像）上传到 Qlik Cloud 的并行工作器数量。适用于构建到 Qlik Cloud 和导出 QVF 模式。 | `2` |
| 脚本替换 | 开启或关闭脚本替换处理，并管理单独的规则。有关更多信息，请参阅[参数参考](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/command-line-interface/argument-reference.htm)。 | 开启 |

该 脚本替换 部分包含一个内联规则编辑器。切换主开关以启用或禁用所有脚本处理。展开该部分以查看、添加、编辑或删除单个规则。每条规则都可以独立开启或关闭。点击 重置为默认值 以恢复八个内置规则。摘要徽章显示已启用规则数。

点击规则上的向上和向下箭头按钮以更改执行顺序。执行顺序较低的规则会首先运行。点击 导出 以 JSON 文件格式下载所有规则。点击 Import 从 JSON 文件加载规则，替换当前规则集。导入的文件必须包含一个JSON数组，其中每个规则都具有`description`、`pattern`和`search`字段。

提示注释

要创建用于导入的自定义规则文件，请首先点击 Export 以获取正确格式的内置规则。编辑导出的文件以添加、删除或修改规则，然后点击导入以加载更新后的设置。

信息注释

当配置了自定义规则或禁用的默认值时，命令预览会显示一条通知。复制的命令不包含自定义规则。将规则导出到 JSON 文件，并添加 `--scriptReplacements <path>` 到命令中，以在命令行中包含自定义规则。

有关规则如何运作的说明，包括两阶段匹配过程和内置规则列表，请参阅[参数参考](https://help.qlik.com/zh-CN/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-CN/migration/Content/Qv2qsMigration/user-interface/executive-summary-dashboard.htm)
* [命令行界面](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/command-line-interface/index.htm)
* [转换布局设置](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/conversion-layout-settings/index.htm)
* [部署到 Qlik Cloud](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/deploying-to-qlik-cloud/index.htm)