使用热图

本页将指导您完成与热图交互的用户旅程。 该页面将引导您完成各个阶段，包括在 Studio 中创建测试用例、设置热图比率和配置、检查和测试事务以及运行测试集。 查看以下主题以开始使用热图。

您将使用两级热图视图：

• 应用程序组件：可视容器，将相关 SAP 事务分组到特定组件或模块下。
• 事务（可选） ：组件中的框，表示单个 SAP 事务或程序。Everybox 显示事务数据，例如：
  • 事务名称
  • SAP 代码
  • 测试状态和覆盖率

在 Studio 中创建测试用例

先决条件

• 要开始使用热图，您需要使用 UiPath Studio 为您的 SAP 事务创建测试用例。
• 为确保热图准确显示哪些事务已被测试覆盖及其状态，您需要将 Studio 项目的 Enable SAP monitoring（启用 SAP 监控）设置设为 True。

热图、测试用例和事务之间的联系和连接

热图中的所有事务都有在运行时自动获配的唯一标签。标签采用以下格式：TRAN:SAP_CODE 或 PROG:SAPPROGRAM。

在运行时收集有关实际执行的事务及其依赖项的信息。要允许测试用例链接到已执行的事务，请转到 Studio 项目设置，在“用户界面自动化传统”下，将“启用 SAP 监控”设置为“True” 。此设置仅适用于测试自动化项目。

备注：

在“用户界面自动化传统”下启用 SAP 监控还将链接适用于用户界面自动化新式活动的测试用例和事务。

例如，名为Create Purchase Order且其 SAP 代码为ME21N事务具有TRAN:ME21N标签。如果要为此事务创建测试用例，则系统会在“创建测试用例”对话框的“标签”字段中显示相同的标签。

配置热图比例和设置

在 UiPath Studio 中为 SAP 事务创建测试用例后，您可以配置热图将显示测试相关性和覆盖率的比率和设置。

更改热图设置

热图是根据五个 SAP 属性的值生成的。您可以配置分配比率，以确定与测试策略最相关的属性的优先级。

SAP 属性	描述	默认值
用户	使用事务的用户数量。	40
执行	每个事务的执行次数。	10
时间	执行事务所需的总处理时间。	10
对象	事务中使用的开发对象的数量，例如屏幕、功能模块、表格。	10
强度	事务类型： 高强度事务（事务类型：创建） 中强度事务（事务类型：更改） 低强度事务（事务类型：显示）	30

重要提示：

所有分配比率的总和必须等于100 。#### SAP FIORI 登录页面此外，您可以在热图中启用或禁用SAP Fiori 登录页面的可见性。

连接到 SAP 实例

调整热图分配比例和 SAP Fiori 着陆页面可见性设置，以自定义测试相关性和覆盖率的计算与显示方式。

1. 选择右上角的齿轮图标 ，打开“热图设置”。

2. 根据您的用例更改分配比率。

例如，要突出显示强度最高的事务（类型为“创建”），而不是最常用的事务，请将“用户比率”更改为10 ，然后将“强度比率”更改为60 。

3. 在“可见性”下，选择“显示 SAP FIORI 登录页面”开关，以在热图中显示 SAP FIORI 登录页面。

   

连接到 CSV 文件

运行Z_UIPATH_CUST_HEATMAP_DOWNLOAD程序后，转到“参数”选项卡并配置比率。

分析和测试事务

为 SAP 事务创建测试并配置热图比率后，您可以开始分析结果并测试特定事务。 请查看以下部分，了解有关如何利用热图的信息。

了解热图结果

热图结果分析包括查看事务的测试覆盖率、筛选测试覆盖率类型以及审核事务概述。 探索以下主题，以全面了解如何检查热图结果。

查看事务的测试覆盖率

要查看哪些事务具有自动化测试以及结果：

1. 在热图下选择“通过” ，查看通过测试结果的事务。

2. 在热图下选择“失败” ，查看未通过测试结果的事务。

3. 在热图下选择“未执行测试用例” ，查看未执行测试用例的事务。

4. 在热图下选择“未获配测试用例” ，查看未获配任何测试用例的事务。

5. 在热图下选择“显示全部” （默认为“选中”）以查看上述所有事务。

   

筛选热图事务

通过设置前 N 个事务、时间段、事务类型和界面类型筛选条件，缩小热图中显示的事务范围。

1. 打开“热图”，然后从“所有事务”下拉列表中选择要显示的事务数量：
   • 所有事务（默认）
   • 前 10 名事务
   • 前 20 名事务
2. 从“上周”下拉列表中选择事务的开始时间：
   • 上个月（默认）
   • Last Week
   • Last Day

事务的开始时间和结束时间显示在“时间段”下拉列表旁边。3. 从“所有事务类型”下拉列表中选择要显示的事务类型：

• 标准事务
• 自定义事务

从“所有接口类型”下拉列表中选择要查看事务的接口类型：

• [T] - SAP WinGUI 中的事务
• [R] - SAP WinGUI 中的报告/程序
• [W] - SAP WebGUI 中的事务
• [F] - SAP FIORI 中的应用程序

检查事务的概述

查看在热图中选定的特定事务的名称和 SAP 代码，以便在为其创建测试用例或测试集之前确认其是否为目标事务。

1. 从热图中选择一个事务。
2. 在“所选事务的详细信息：维护事务代码”下，选择“概述”
3. 查看事务名称及其 SAP 代码。

事务的 SAP代码用于生成唯一标签

为特定事务创建测试用例

备注：

功能可用性取决于您使用的云平台。有关详细信息，请参阅Test Manager 功能可用性页面。

您可以使用 Autopilot 为作为热图一部分查看的事务生成手动测试。系统将为生成的测试用例分配以下标签：

• autopilot-generated
• TRAN:<transactionCode>

先决条件

（仅适用于 Cloud商业）如果要在生成测试时利用 RAG，则需要开始使用 RAG 所属的上下文锚定。要开始使用上下文锚定，请访问专用的最佳实践页面。

支持的文件类型

Autopilot 可以处理各种文件类型。 根据文件类型，Autopilot 可以处理其中的某些内容。 以下列表列出了您可以向 Autopilot 提供的文件类型，以及 Autopilot 可以处理的内容类型的详细信息：

• 仅处理文本内容 – Autopilot 仅处理以下文件类型中的文本内容：
  • TXT
  • BPMN
  • CSV
• 同时处理文本和图像内容 – Autopilot 可处理以下文件类型中的文本和图像：
  • DOCX
  • XLSX
  • PNG
  • JPG
  • PDF

步骤

1. 在热图中，选择所需的事务。

2. 选择“生成测试” 。系统将打开“提供其他上下文”窗口，重点显示“添加文档”，提示您提供生成测试用例所需的附件或其他文档。图 1.所选事务的“生成测试”按钮示例

   

3. 在“添加文档”部分中，选择其他附件。这些附件在生成测试时使用。您也可以自行上传其他文件。

图 2. 用于生成测试的“添加文档”部分（仅适用于 Cloud Business）

4. （仅适用于 Cloud Commercial）在 Provide additional context（提供附加上下文）窗口的 Leverage RAG（利用 RAG）部分中，选择一个存储您上传到上下文锚定的数据的索引。所选索引通过为 Autopilot 提供有关您尝试自动化的应用程序的上下文，帮助其生成更准确的测试。例如，当需求文档中的信息不完整或引用了其他部分中的附加详细信息时，您可以利用 RAG。在这种情况下，您可以利用 RAG 从已编制索引的参考资料中提取这些详细信息。

   备注：

   有关使用“上下文锚定”的最佳实践，请访问最佳实践。

   1. 从 Select folder（选择文件夹）下拉列表中，选择存储包含您希望与 Autopilot 共享的信息的索引所在的文件夹。

   2. 从 Select index（选择索引）下拉列表中，选择您希望 Autopilot 引用的特定索引。

   3. 对于 Number of results（结果数量），请输入您希望 Autopilot 根据所引用的信息生成的测试数量。

   4. 选择 Next（下一步），并提供 Autopilot 在生成测试用例时应使用的其他说明。从提示库中的提示中进行选择，或在 Provide additional guidance（提供额外指南）窗口中输入这些说明。以下是 Autopilot 可以遵循的部分说明：

      • 您可以指示 Autopilot 要生成的测试用例数量。测试用例的最大数量为 50 个。
      • 您可以指定 Autopilot 涵盖贷款请求需求中描述的所有用户步骤和验收标准。
      • 您可以指示 Autopilot 生成先决条件。
      • 您可以指定 Autopilot 为每个测试步骤生成预期结果。
      • 默认情况下，Autopilot 会考虑关联到需求的现有测试，以避免生成重复测试。但是，您可以指示 Autopilot 在生成新测试时忽略现有测试。您可以通过提供如下指令来实现这一点：“生成测试时，请勿考虑关联到此需求的测试”。图 4. 在 Provide additional guidance（提供附加指导）窗口中输入的附加说明。

   5. （可选）从“模型”下拉列表中，选择 Autopilot 应使用的 AI 模型。生成测试时，Autopilot 默认使用 Claude 3.7 Sonnet，这也是推荐的模型。

      备注：

      “模型”下拉列表中可用的模型取决于应用于组织和租户的AI Trust Layer 策略。如果启用了所有受支持的模型，则系统会推荐使用 Claude 3.7 Sonnet 选项。如果仅启用了一种模型类型（例如 Azure OpenAI），则系统仅显示和自动推荐 GPT 4o 模型。

   6. 选择“生成测试”以启动该流程。生成完成后，您将收到“测试用例生成完成”通知。根据您的通知首选项，您可以通过应用程序内通知和电子邮件接收通知。

   7. 选择 Test generation completed（测试生成已完成）通知以查看生成的测试用例。展开 Generate tests（生成测试）面板中的每个测试用例，并查看生成的测试用例。如果您对其内容满意，请选择 Create tests（创建测试）。

   8. 如果您对生成的测试用例不满意，请选择“优化测试” ，并提供有关用例的其他详细信息。

      • 附加更多相关文档，以供 Autopilot 使用。
      • 选择 Next（下一步），然后在 Provide instructions（提供说明）文本框中输入其他详细信息。
      • 优化步骤后，选择“重新生成测试” 。
      • 选择 Test generation completed（测试生成已完成）通知以访问重新生成的测试用例。
      • 展开每个测试用例并进行审核。
      • 选择您满意的测试用例，然后选择“创建测试” 。

   生成的测试用例将带有以下标签：

   • autopilot-generated
   • TRAN:<transactionCode>

   例如，如果所选事务的标签为TRAN:SE38 ，则相同的标签将应用于由此生成的所有测试用例。

图 3.“利用 RAG部分生成测试”

图 4. 指导窗口中的附加说明

图 5. 选择您想要创建并展开测试用例的测试

创建测试用例和测试集

分析热图中显示的结果后，您可以通过为未覆盖或失败的事务创建测试用例和测试集来开始改进您的测试组合。 请查看以下页面，了解为特定事务创建测试用例和测试集的步骤。

为特定事务创建测试用例

热图中的所有事务都有在运行时自动获配的唯一标签。标签采用以下格式：TRAN:SAP_CODE 或 PROG:SAPPROGRAM。

在运行时收集有关实际执行的事务及其依赖项的信息。要允许测试用例链接到已执行的事务，请转到 Studio 项目设置，在“用户界面自动化传统”下，将“启用 SAP 监控”设置为“True” 。此设置仅适用于测试自动化项目。

备注：

在“用户界面自动化传统”下启用 SAP 监控还将链接适用于用户界面自动化新式活动的测试用例和事务。

例如，名为Create Purchase Order且其 SAP 代码为ME21N事务具有TRAN:ME21N标签。如果要为此事务创建测试用例，则系统会在“创建测试用例”对话框的“标签”字段中显示相同的标签。

1. 从热图中选择一个事务。
2. 在“所选事务的详细信息：维护事务代码”下，选择“测试用例” 。
3. 选择“创建测试用例” ，然后配置要创建的测试用例。

您可以在已分配给测试用例的标签旁边添加其他标签。

重要提示：

为特定事务创建测试用例时，请确保令已分配给事务的标签保持不变。否则，您创建的测试用例将不会链接到事务。 在此示例中，已分配的标签为 TRAN:SE16。

为特定事务创建测试集

为特定热图事务创建测试集，以便您能够分组并执行涵盖该事务的测试用例。

1. 为特定事务创建测试用例。

2. 选择您为其创建测试用例的事务。

3. 在“所选事务的详细信息：维护事务代码”下，选择“测试集” ，然后配置要创建的测试集。

   提示：

   要简化将测试集链接到事务的过程，请将事务的标签添加到要链接的测试集。这样，您可以使用该特定标签搜索刚才创建的测试集。在此示例中，我们使用与创建测试用例相同的标签 ( TRAN:SE16 ) 来添加到测试集中。

   

4. 创建测试集后，在 Test Manager 中导航到“测试集” 。

5. 搜索您创建的测试集并将其打开。您可以使用在步骤 3 中添加的标签搜索测试集。

6. 选择“任务” > “分配测试用例” > “静态分配” 。

7. 搜索您在步骤 1 中创建的测试用例，并将其分配给此测试集。

   

8. 返回到“热图”页面，选择该事务，然后查看分配给该事务的测试集。

为事务执行测试集

运行关联到特定热图事务的测试集，以便测试结果作为该事务的测试覆盖率反映回热图中。

1. 将测试集链接到事务。
2. 选择“更多选项”与您要执行的测试集内联。
3. 选择以下选项之一：
   • 手动执行
   • 自动化执行
4. 在热图中查看测试结果。

热图附件

生成热图的 SAP 数据可以在 Test Manager 的仪表板中的附件下找到：

• 如果将连接 SAP 实例用作数据源：附加三个 JSON 文件（分别代表天、周和月）
• 如果将从 CSV 上传作为数据源：附加上传的 CSV 文件。

结果

测试集会针对选定的事务执行，结果会反映在热图中。测试通过的事务会显示在相应的覆盖状态下，测试用例日志在项目的 Execution（执行）部分中提供。