使用热图

本页将指导您完成与热图交互的用户旅程。 该页面将引导您完成各个阶段，包括在 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. 根据您的用例更改分配比率。

For example, to highlight the most intense transactions (of type Create), rather than the most used ones, change the User ratio to 10, and then the Intensity ratio to 60. 3. Under Visibility, select the Display SAP FIORI landing pages toggle, to display SAP FIORI landing pages in the heatmap.

连接 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

The start and end time of transactions is displayed next to the Time Period dropdown. 3. Select the types of transactions that you want to appear from the All transaction types dropdown:

1. 标准事务
2. 自定义事务
3. 从“所有接口类型”下拉列表中选择要查看事务的接口类型：
   1. [T] - SAP WinGUI 中的事务
   2. [R] - SAP WinGUI 中的报告/程序
   3. [W] - SAP WebGUI 中的事务
   4. [F] - SAP FIORI 中的应用程序

检查事务的概述

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

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

为特定事务创建测试用例

备注：

Feature availability depends on the cloud platform you use. For details, refer to the Test Manager feature availability page.

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

• autopilot-generated
• TRAN:<transactionCode>

Prerequisites: (For Cloud Commercial only) 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. 选择“生成测试” 。系统将打开“提供其他上下文”窗口，重点显示“添加文档”，提示您提供生成测试用例所需的附件或其他文档。图 1.所选事务的“生成测试”按钮示例

   

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

Figure 2. The Add documents section for generating tests (For Cloud Commercial only)

2. (For Cloud Commercial only) In the Leverage RAG section of the Provide additional context window, select an index which stores your data uploaded to Context Grounding. 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. :::note For best practices on working with Context Grounding, visit Best practices. ::: 1. From the Select folder dropdown list, select the folder where you store the indexes storing the desired information you want to share with Autopilot. 2. From the Select index dropdown list, select the specific index that you want Autopilot to reference. 3. For Number of results, enter the number of tests you want Autopilot to generate based on the referenced information.

Figure 3. The Leverage RAG section for generating tests

3. Select Next and provide additional instructions that Autopilot^TM should use when generating test cases. Choose from a prompt from the Prompt library or type these instructions in the Provide additional guidance window. These are some of the instructions that Autopilot can follow:

• 您可以指示 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

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

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

2. 选择“生成测试”以启动该流程。生成完成后，您将收到“测试用例生成完成”通知。根据您的通知首选项，您可以通过应用程序内通知和电子邮件接收通知。
3. 选择“测试生成已完成”通知以查看生成的测试用例。
   1. 展开“生成测试”面板中的每个测试用例，并查看生成的测试用例。
   2. 如果您对其内容感到满意，请选择“创建测试” 。

Figure 5. Selecting the tests that you want to create and expanding a test case

6. If you are not satisfied with the generated test cases, select Refine tests, and provide additional details about your use case.

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

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

• autopilot-generated
• 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. 搜索您创建的测试集并将其打开。

You can search for the test set using the label that you added at Step 3. 6. Select Tasks > Assign Test Cases > Static Assignment. 7. Search for the test cases that you created at Step 1 and assign them to this test set.

8. Navigate back to the Heatmap page, select the transaction, and check out the test set assigned to it.

为事务执行测试集

1. 将测试集链接到事务。
2. Select More Options inline with the test set that you want to execute.
3. 选择以下选项之一：
   • 手动执行
   • 自动化执行
4. 在热图中查看测试结果。

热图附件

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

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