# 执行摘要仪表板

转换完成后，QV2QS 会显示一个交互式执行摘要仪表板。仪表板提供转化指标，识别需要跟进的项目，并按对象类型细分结果。相同的仪表板可在用户界面中查看，并可导出为两个文件。QV2QS 生成一个独立的 HTML 文件 (`reports/executive_summary.html`) 和一个机器可读的 JSON 文件 (`reports/executive_summary.json`)。

在单项目模式下，仪表板显示一个包含所有转换详细信息的面板。在批处理模式下，一个概览选项卡汇总所有项目的指标，并且各个项目选项卡提供每个项目的详细信息。有关批量报告的更多信息，请参阅[批量报告](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/batch-conversion/batch-reporting.htm)。

## 仪表板标题

页眉显示项目名称、生成时间戳以及总运行时间。对于云部署，总运行时间衡量从开始到结束的完整管道（转换、媒体上传、应用程序构建和重新加载）。对于仅限本地的运行，总运行时间等于转换持续时间。

## KPI 卡片

仪表板顶部显示八个关键绩效指标卡。每张卡片都可点击，并导航到相应的详细部分。

下表描述了每个 KPI 卡。

| KPI 卡 | 值 | Category |
| --- | --- | --- |
| 范围内的对象 | 符合转换条件的 QlikView 对象数量。内置对象 (当前选择, 搜索) 被排除。 | 信息性 |
| 自动转换 | 对象已转换为 Qlik Sense 格式，无需手动关注。显示为范围内的对象的计数和百分比。 | 信息性 |
| 已跳过 | 从转换评分中排除的内置或超出范围的对象。 | 信息性 |
| 错误 | 转换失败且需要手动修复的对象。 | 需要采取行动 |
| 占位符 | 创建为空白占位符的对象，因为没有直接的 Qlik Sense 等效项。这些对象必须手动重建。 | 需要采取行动 |
| 调整 | 已部分转换但可能需要手动审查或属性更正的对象。 | 需要采取行动 |
| 工作表 | 已发现并转换的 QlikView 工作表数量。 | 信息性 |
| 其他发现 | 分析期间检测到的其他 QlikView 功能和模式。主数字显示需要手动审核的项目。副标题提供了细分，包括评论计数、自动修复计数和总数。卡片在项目仍需审查时为琥珀色，或在所有表达式发现都已自动修复时为绿色。 | 需要采取行动 |

## 分诊卡

两张摘要卡显示在 KPI 行下方，用于区分自动化结果与需要关注的项目。

* 自动处理 — 显示自动转换对象的数量、QV2QS 在无需手动干预的情况下解决的维度或度量溢出调整的数量、自动修复的表达式发现、以及未使用的 VBScript 宏 (在 Module.txt 中定义但从未从任何对象调用的宏)。
* 所需操作 — 列出每个类别的后续工作，包含计数和指向详细信息部分的链接。类别包括占位符、调整、错误、开发者书签、宏调用、兼容性发现以及需要手动处理的表达式发现。只有具有跟踪调用的宏会显示在此处；未使用的宏会显示在“自动处理”中。仅显示项目数大于零的类别。

## 详细信息选项卡

六个详细信息选项卡组织了转换结果。每个选项卡都侧重于转换的一个特定方面。

概述

概览选项卡包含以下卡片。

* 清单 — 源 QlikView 应用程序中的关键计数：工作表、变量、组、唯一图像、引用的图像文件以及处理的溢出调整（如果有）。清单还显示数据模型字段计数、表计数以及总数据大小（以兆字节为单位）。
* 转化健康状况 — 一个表格，显示将范围内的对象细分为自动、跟进和跳过类别的情况。每行显示计数、范围内对象的百分比、总对象的百分比和上下文注释。这张卡片提供了转换完整性的主要衡量指标。
* 关注范围 — 一个水平条形图，显示了关注工作在调整、占位符和错误之间的分布。每个条形都可点击，并导航到相应的详细信息部分。也提供表格视图，其中包含计数和百分比。
* 按项目划分的对象（仅限批处理模式）— 一个堆叠式水平条形图，显示每个项目的自动、跟进和跳过计数。每行都可点击，并导航到单独的项目选项卡。表格视图显示按项目划分的列：范围、自动处理、自动处理百分比、待跟进、错误、已跳过和总计。

对象类型

对象类型选项卡包含两张卡片。

* 按 QlikView 对象类型划分的结果 — 一个分段条形图，显示了每种 QlikView 对象类型的转换方式。每个条形被分为自动、调整、占位符、错误和跳过段。默认显示前 10 种类型。点击 显示所有 以显示所有类型。表格视图提供相同的数据，其中包含每个结果类别的数字列。
* 已转换的 Qlik Sense 可视化类型 — 一个水平条形图，显示了生成的 Qlik Sense 可视化类型的分布。每个条形显示计数和百分比份额。此卡片可快速查看哪些 Qlik Sense 类型主导已转换的应用程序。

需要关注的对象

需要关注的对象选项卡包含用于每种后续工作类别的子选项卡。仅显示项目数大于零的类别。每个子选项卡徽章都是橙色的，以指示项目需要手动操作。

* 占位符 — 需要在 Qlik Sense 中从头开始构建的对象。图表视图按 QlikView 类型聚合占位符计数。表格视图单独列出每个对象，包含以下列：工作表、对象 ID、对象（标题）、类型和原因。在批处理模式下，会添加一个App列。
* 调整 — 已转换但需要人工审核的对象。图表和表格布局与“占位符”子选项卡匹配。
* 书签 — 来自 QlikView 文档的开发者创建的书签，必须在 Qlik Sense 中手动重新创建。表格列出了每个书签，包含以下列：ID、名称、字段、字段名称、范围、布局对象、布局状态和选择项。
* 宏 — 在 QlikView 文档中检测到的 VBScript 宏定义和调用。显示三张表。第一个列出了宏定义，包含以下列：名称、类型、行数、对象、工作表、调用来源和状态。第二个列表显示宏调用，包含以下列：宏名称、源对象、工作表和触发器。第三个交叉引用宏被调用，但未在`Module.txt`中定义。

图表调整

图表调整选项卡显示对象，其中 QV2QS 自动调整了维度、度量或网格设置，以适应 Qlik Sense 可视化限制。该表列出了每个受影响的对象，包含以下列：对象 ID、可视化类型、原始（维度和度量计数）、原因以及已执行的操作。在批处理模式下，会添加一个App列。原因列解释了为何需要进行调整（例如，维度过多，不兼容的组合，或一个格子网格小于不同维度值的数量）。“已执行操作”列描述了所采取的操作（例如，将多余的维度移至备选项，截断以适应限制，或展开 trellis 网格以显示所有维度值）。

其他发现

“其他发现”选项卡包含两个子选项卡：兼容性和表达。仅显示项目数大于零的子选项卡。当只有一个子选项卡有项目时，子选项卡条形会被隐藏，内容会直接显示。选项卡徽章和子选项卡徽章使用双色：橙色计数表示需要手动审查的项目，灰色计数表示自动修复的项目。兼容性子选项卡徽章始终是橙色的，因为所有兼容性发现都需要手动操作。当两者都存在时，表达式子选项卡徽章会显示橙色计数（表示需要审核的项目）和灰色计数（表示自动修复的项目）。

兼容性子选项卡显示在分析期间检测到的额外 QlikView 功能和模式。有些发现是信息性的，例如二进制加载语句或 INCLUDE 引用。其他方面则识别出在 Qlik Cloud 中工作方式不同或需要手动配置的功能。该表列出了每个发现，包含以下列：来源、发现、描述、置信度和详细信息。在批处理模式下，会添加一个App列。置信度值采用颜色编码：高（绿色）、中（琥珀色）和低（红色）。有关更多信息，请参阅[分析](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/conversion-results/analysis.htm)。

表达式子选项卡显示集合分析引用发现、不支持的函数调用、裸字段引用和裸未加括号的值。表格上方的图例解释了三种状态徽章。自动修复（绿色）表示在转换过程中已应用的修正。审查 (琥珀色) 表示需要人工关注的项目。无法修复（红色）表示必须手动重写的内容。不支持的函数、裸字段引用和裸未加括号的值会收到无法修复状态，因为 QV2QS 无法自动更正这些模式。无法自动修复的发现会在“表达式”列中以红色突出显示有问题的文本。筛选器开关提供三种视图：所有（所有发现）、自动修复（仅已更正的项目）和 需要关注（仅需要手动操作的项目）。表格首先按自动修复项排序，然后按问题类型分组。该表列出了每个发现，包含以下列：来源、对象 ID、类型、工作表、字段、设置字段、匹配文本、影响、状态、规则、描述、已应用修复和和表达式。在批处理模式下，会添加一个App列。源列指示发现是源自变量定义还是图表对象表达式。状态列指示 QV2QS 是否已自动更正表达式。“应用修复”列显示了在转换过程中应用的修正后的表达式。表达式列显示紧凑的单行视图，并去除注释；复制按钮保留原始格式，包括换行符、缩进和注释。当一个发现有多个匹配文本的相同出现时，“匹配文本”列会显示带有计数值的值（例如，`GetCurrentField() (×4)`）。该值未重复。包含 URL 的描述值会被渲染为可点击的链接。有关更多信息，请参阅[分析](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/conversion-results/analysis.htm)。

应用信息

应用信息选项卡显示有关源 QlikView 应用程序的元数据以及计时指标。此选项卡包含四个子选项卡：

* 应用程序元数据 — 源目录、QVW 文件路径、PRJ 文件夹路径、项目输出文件夹、基本 RAM（MB 和 GB，如果可用）、上次重新加载时间以及计时指标。
* 字段 — 具有基数、字节大小和标签的数据模型字段。
* 表 — 包含行数、字段数和字节大小的数据模型表。
* 数据世系 — 在加载脚本中检测到的数据连接类型。

时间指标（在应用元数据子选项卡中）：

* 转换持续时间 — 解析 QlikView PRJ 并生成 Qlik Sense 构建文件夹所花费的时间。这仅衡量本地转换阶段，且不包括云部署。
* 应用构建时间 — 在 Qlik Cloud 中执行 `qlik app build` 操作所花费的时间。此标签指示构建是否包含重载。此字段仅在完成云部署后显示。
* 总运行时间 — 从开始到结束的实际时间，包括身份验证、本地转换、云部署、媒体上传和重新加载。此字段仅在云部署已执行时显示。对于本地运行 (`--unbuildOnly`)，总运行时间等于转换持续时间。

## 批量项目选项卡

在批处理模式下，执行摘要会为批处理中的每个项目添加一个选项卡。每个项目选项卡都提供该项目的独立摘要。

每个项目选项卡包含以下部分。

* 标题 — 项目名称、工作表计数、范围内的对象计数和自动转换百分比。一个 打开应用程序 按钮在可用时链接到 Qlik Cloud 应用程序。
* KPI 卡片 — 四张卡片：在范围内、自动转换、跟进和错误。
* 按 QlikView 类型划分的结果 — 一个分段条形图，显示了针对该项目的前 10 种 QlikView 对象类型及其转换结果。
* Qlik Sense 类型 — 显示该项目生成的前 8 种 Qlik Sense 可视化类型的水平条形图。
* 占位符 (如有) — 一个列出占位符对象的表格，包含以下列：工作表、对象 ID、对象、类型和原因。
* 调整（如有）— 一个列出调整对象的表格，具有相同的列布局。
* 项目元数据 — 项目路径、输出路径、转换持续时间、应用程序构建时间（带重新加载标志）和总运行时间。应用构建时间和总运行时间仅当云部署完成时才显示。

## 独立 HTML 导出

QV2QS 会生成一个独立的 HTML 文件（`reports/executive_summary.html`）以及 JSON 文件。HTML 导出重现完整的交互式仪表板，其中所有 CSS 和 JavaScript 都内联嵌入。此文件没有外部依赖项，可以在任何现代浏览器中打开，通过电子邮件共享，或与转换输出一起存档。

独立的 HTML 文件在通过 在新标签页中打开 生成时，会继承用户界面的激活颜色主题（浅色或深色）。一个主题切换按钮显示在仪表板标题中，用于独立切换模式。所选主题直接嵌入到 HTML 文件中，因此，保存或共享的文件会显示正确的主题，而无需 QV2QS 服务器。

在批处理模式下，聚合文件将保存到批处理输出根目录中，文件名为`batch_summary.html`。每个独立项目还会收到一个项目专属的 `executive_summary.html`，位于项目 `reports/` 子文件夹中。

## 了解更多

* [转化结果](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/conversion-results/conversion-outcomes.htm)
* [转化报告](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/conversion-results/conversion-report.htm)
* [分析](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/conversion-results/analysis.htm)
* [批量报告](https://help.qlik.com/zh-CN/migration/Content/Qv2qsMigration/batch-conversion/batch-reporting.htm)