使用热图

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

您将使用两级热图视图：

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

在 Studio 中创建测试用例

要开始使用热图，您需要使用 UiPath Studio 为 SAP 事务创建测试用例。 为确保热图准确显示测试涵盖哪些事务及其状态，您需要将 Studio 项目的“启用 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 实例

1. 选择右上角的齿轮图标 ，打开“热图设置”。
2. 根据您的用例更改分配比率。
   例如，要突出显示强度最高的事务（类型为创建），而不是最常用的事务，请将用户比率更改为 10，然后将强度比率更改为 60。
3. 在“可见性”下，选择“显示 SAP FIORI 登录页面”开关，以在热图中显示 SAP FIORI 登录页面。

连接 CSV 文件

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

分析和测试事务

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

了解热图结果

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

查看事务的测试覆盖率

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

1. 在热图下选择“通过”，查看通过测试结果的事务。
2. 在热图下选择“失败”，查看未通过测试结果的事务。
3. 在热图下选择“未执行测试用例”，查看未执行测试用例的事务。
4. 在热图下选择“未获配测试用例”，查看未获配任何测试用例的事务。
5. 在热图下选择“显示全部”（默认选中），查看上述所有事务。

筛选热图事务

1. 打开“热图”，然后从“所有事务”下拉列表中选择要显示的事务数量：
   1. 所有事务（默认）
   2. 前 10 名事务
   3. 前 20 名事务
2. 从“上周”下拉列表中选择事务的开始时间：
   1. 上个月（默认）
   2. Last Week
   3. Last Day
      事务的开始时间和结束时间显示在“ 时间 段”下拉列表旁边。
3. 从“所有事务类型”下拉列表中选择要显示的事务类型：
   1. 标准事务
   2. 自定义事务
4. 从“所有接口类型”下拉列表中选择要查看事务的接口类型：
   1. [T] - SAP WinGUI 中的事务
   2. [R] - SAP WinGUI 中的报告/程序
   3. [W] - SAP WebGUI 中的事务
   4. [F] - SAP FIORI 中的应用程序

检查事务的概述

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

为特定事务创建测试用例

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

• Autopilot 生成的
• TRAN：<transactionCode>

先决条件：如果要在生成测试时利用 RAG，则需要开始使用 RAG 所属的上下文基础。 要开始使用上下文基础，请访问专用的最佳实践页面。

Leverage RAG only when:

• Requirements contain ambiguous terms or abbreviations
• Need to pull the ambiguous context from multiple sources dynamically

This is an example when you should leverage RAG: “Enable SSO for the CR, BH and FI modules and sync with the BI dashboard.” In this example scenario, documents should be uploaded for RAG, referencing the ambiguous abbreviations.

Attach documents when:

• Requirements do not contain ambiguous terms
• The files contain crisp information about the requirement
• You can define custom prompts and instruct LLMs to extract the context which is relevant for the requirement

1. 在热图中，选择所需的事务。
2. 选择“生成测试”。

   “提供其他上下文”窗口将打开，重点显示“添加文档”，提示您提供生成测试用例所需的附件或其他文档。

   图 1.所选事务的“生成测试”按钮示例
   

   

   
   
   1. 在“添加文档”部分中，选择其他附件。

      这些附件在生成测试时使用。您也可以自行上传其他文件。

      图 2.用于生成测试的“添加文档”部分
      

      

      
      
   2. 在“提供其他上下文” 窗口的“利用 RAG” 部分中，选择一个索引，用于存储已上传到“上下文基础” 的数据。
      选定索引通过为 Autopilot 提供有关您尝试自动化的应用程序的上下文，帮助 Autopilot 生成更准确的测试。 例如，当需求文档中的信息不完整或引用其他部分中的其他详细信息时，您可以利用 RAG。 在这种情况下，您可以利用 RAG 从已索引的引用中提取这些详细信息。

      注意：有关使用上下文基础的最佳实践，请访问最佳实践。
      1. 从“选择文件夹”下拉列表中，选择存储索引（这些索引存储了要与 Autopilot 共享的所需信息）的文件夹。
      2. 从“选择索引”下拉列表中，选择要 Autopilot 引用的特定索引。
      3. 对于结果数量，根据引用的信息输入您希望 Autopilot 生成的测试数量。
      图 3.利用 RAG部分生成测试
      

      

      
      
3. 选择“下一步” ，并提供Autopilot ^TM在生成测试用例时应使用的其他说明。 从“提示词库”的提示词中选择，或在“提供其他指导”窗口中输入这些说明。
   以下是 Autopilot 可以遵循的一些说明：

   • 您可以为Autopilot ^TM指示要生成的测试用例的数量。 测试用例最大数量为 50。
   • 您可以指定Autopilot ^TM涵盖贷款请求需求中描述的所有用户步骤和验收标准。
   • 您可以指示Autopilot ^TM生成先决条件。
   • 您可以指定Autopilot ^TM为每个测试步骤生成预期结果。
   • 默认情况下，Autopilot 会考虑链接到需求的现有测试，以防止重复测试。 但是，您可以指示 Autopilot 在新测试生成期间忽略现有测试。 为此，您可以提供如下说明：“生成测试时，请勿考虑与此需求相关联的测试”。
   图 4.在“提供其他指导”窗口中输入的其他说明
   

   

   
   
   1. （可选）从“模型”下拉列表中，选择 Autopilot 应使用的 AI 模型。

      生成测试时，Autopilot 默认使用 Claude 3.7 Sonnet，这也是推荐的模型。

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

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

5. 选择“测试生成已完成”通知以查看生成的测试用例。
   1. 展开“生成测试”面板中的每个测试用例，并查看生成的测试用例。
   2. 如果您对其内容感到满意，请选择“创建测试”。
   图 5.选择您要创建的测试并展开测试用例
   

   

   
   
6. 如果您对生成的测试用例不满意，请选择“优化测试”，并提供有关用例的其他详细信息。
   1. 附加更多相关文档，以供 Autopilot^TM 使用。
   2. 单击“下一步”，然后在“提供说明”文本框中输入其他详细信息。
   3. 优化步骤后，选择“重新生成测试”。
   4. 单击“测试生成已完成”通知以访问重新生成的测试用例。
   5. 展开每个测试用例并进行审核。
   6. 选择您满意的测试用例，然后选择“创建测试”。

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

• Autopilot 生成的
• TRAN：<transactionCode>

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

支持的文件类型

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

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

创建测试用例和测试集

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

为特定事务创建测试用例

热图中的所有事务都有在运行时自动获配的唯一标签。标签采用以下格式：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 文件。