执行摘要仪表板
上次更新日期:2026/10/14转换完成后,QV2QS 会显示一个交互式执行摘要仪表板。仪表板提供转化指标,识别需要跟进的项目,并按对象类型细分结果。相同的仪表板可在用户界面中查看,并可导出为两个文件。QV2QS 生成一个独立的 HTML 文件 (reports/executive_summary.html) 和一个机器可读的 JSON 文件 (reports/executive_summary.json)。
在单项目模式下,仪表板显示一个包含所有转换详细信息的面板。在批处理模式下,一个概览选项卡汇总所有项目的指标,并且各个项目选项卡提供每个项目的详细信息。有关批量报告的更多信息,请参阅批量报告。
仪表板标题
页眉显示项目名称、生成时间戳以及总运行时间。对于云部署,总运行时间衡量从开始到结束的完整管道(转换、媒体上传、应用程序构建和重新加载)。对于仅限本地的运行,总运行时间等于转换持续时间。
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列。置信度值采用颜色编码:高(绿色)、中(琥珀色)和低(红色)。有关更多信息,请参阅分析。
表达式子选项卡显示集合分析引用发现、不支持的函数调用、裸字段引用和裸未加括号的值。表格上方的图例解释了三种状态徽章。自动修复(绿色)表示在转换过程中已应用的修正。审查 (琥珀色) 表示需要人工关注的项目。无法修复(红色)表示必须手动重写的内容。不支持的函数、裸字段引用和裸未加括号的值会收到无法修复状态,因为 QV2QS 无法自动更正这些模式。无法自动修复的发现会在“表达式”列中以红色突出显示有问题的文本。筛选器开关提供三种视图:所有(所有发现)、自动修复(仅已更正的项目)和 需要关注(仅需要手动操作的项目)。表格首先按自动修复项排序,然后按问题类型分组。该表列出了每个发现,包含以下列:来源、对象 ID、类型、工作表、字段、设置字段、匹配文本、影响、状态、规则、描述、已应用修复和和表达式。在批处理模式下,会添加一个App列。源列指示发现是源自变量定义还是图表对象表达式。状态列指示 QV2QS 是否已自动更正表达式。“应用修复”列显示了在转换过程中应用的修正后的表达式。表达式列显示紧凑的单行视图,并去除注释;复制按钮保留原始格式,包括换行符、缩进和注释。当一个发现有多个匹配文本的相同出现时,“匹配文本”列会显示带有计数值的值(例如,GetCurrentField() (×4))。该值未重复。包含 URL 的描述值会被渲染为可点击的链接。有关更多信息,请参阅分析。
应用信息
应用信息选项卡显示有关源 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/ 子文件夹中。