使用热图

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

在 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 实例

可以根据客户需求在热图的右上角调整设置 。

连接 CSV 文件

从 SAP 下载 CSV 文件时，您可以在“参数”选项卡中配置这些参数。

更改热图设置

更改热图设置涉及更改用于生成热图的 SAP 属性的分配比率，以及切换其对 SAP FIORI 登录页面的可见性。

直接连接到 SAP 实例

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

连接 CSV 文件

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

请访问热图比率，详细了解 SAP 属性和分配比率。

分析和测试事务

为 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>

Prerequisites: If you want to leverage RAG when generating tests, you need to start using Context Grounding, which RAG is a component of. To get started with Context Grounding, visit the dedicated Best practices page.

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

   The Provide additional context window opens, focused on the Add documents prompting you for attachments or other documents necessary for generating test cases.

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

   

   
   
   1. In the Add documents section, select additional attachments.

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

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

      

      
      
   2. 在“提供其他上下文” 窗口的“利用 RAG” 部分中，选择一个索引，用于存储已上传到“上下文基础” 的数据。
      The selected index helps Autopilot in generating more accurate tests by giving it context about the applications that you are trying to automate. For example, you can leverage RAG when a requirement document has incomplete information or refers to additional details in other sections. In this case, you can leverage RAG to draw those details from indexed references.

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

      

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

   • 您可以为Autopilot ^TM指示要生成的测试用例的数量。 测试用例最大数量为 50。
   • 您可以指定Autopilot ^TM涵盖贷款请求需求中描述的所有用户步骤和验收标准。
   • 您可以指示Autopilot ^TM生成先决条件。
   • 您可以指定Autopilot ^TM为每个测试步骤生成预期结果。
   • By default, Autopilot considers existing tests linked to a requirement to prevent duplicating tests. However, you can instruct Autopilot to disregard existing tests during new test generation. You can do this by providing an instruction like: "Do not consider tests that are linked to this requirement when generating tests".
   Figure 4. Additional instructions entered in the Provide additional guidance window
   

   

   
   
4. 选择“生成测试”以启动该流程。

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

5. 选择“测试生成已完成”通知以查看生成的测试用例。
   1. 展开“生成测试”面板中的每个测试用例，并查看生成的测试用例。
   2. 如果您对其内容感到满意，请选择“创建测试”。
   Figure 5. Selecting the tests that you want to create and expanding a test case
   

   

   
   
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

创建测试用例和测试集

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

为特定事务创建测试用例

1. 从热图中选择一个事务。
2. 在 所选事务的详细信息：维护事务代码下，选择 测试用例。
3. 选择“创建测试用例”，然后配置要创建的测试用例。
   您可以在已分配给测试用例的标签旁边添加其他标签。

   重要提示：

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

   在此示例中，已分配的标签为 TRAN:SE16。

在此处了解有关将测试用例链接到事务的更多信息。

为特定事务创建测试集

1. 为特定事务创建测试用例。
2. 选择您为其创建测试用例的事务。
3. 在 “所选事务的详细信息：维护事务代码”下，选择“ 测试集”，然后配置要创建的测试集。
   提示：

   为了简化将测试集链接到事务的流程，请将事务的标签添加到要链接的测试集。 这样，您就可以使用该特定标签搜索刚刚创建的测试集。

   在此示例中，我们我们使用相同的标签来创建添加到测试集中的测试用例 (TRAN:SE16)。
   
   

   

   
   
4. 创建测试集后，在 Test Manager 中导航到“测试集”。
5. 搜索您创建的测试集并将其打开。
   您可以使用在步骤 3 中添加的标签搜索测试集。
6. 选择“任务”>“分配测试用例”>“静态分配”。
7. 搜索您在步骤 1 中创建的测试用例，并将其分配给此测试集。
   
   

   

   
   
8. 导航回“ 热图 ” 页面，选择事务，然后签出分配给它的测试集。

将 Orchestrator 测试集链接到事务

1. 选择一个事务，然后在 所选事务的详细信息：维护事务代码下，选择 测试集。
2. 选择“链接”，选择要链接的 Orchestrator 测试集，然后选择“链接”。

为事务执行测试集

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

热图附件

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

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