使用热图

This page guides you through the user journey of interacting with the Heatmap. The page leads you through various stages, including creating test cases in Studio, setting up Heatmap ratios and configurations, examining and testing transactions, and running test sets. Check the following topics to start using the Heatmap.

Create test cases in Studio

To get started with the Heatmap, you need to create test cases for your SAP transactions with UiPath Studio. To ensure the Heatmap accurately shows which transactions are covered by tests and their status, you need to set the Studio project Enable SAP monitoring setting to True.

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

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

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

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

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

Configure Heatmap ratios and settings

After you create test cases in UiPath Studio for your SAP transactions, you can configure the ratios and settings based on which the Heatmap will display the test relevance and coverage.

热图比率

热图是根据以下 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 属性和分配比率。

Analyze and test transactions

After you create tests for your SAP transactions, and configure the Heatmap ratios, you can start analyzing the results and testing specific transactions. Check the following sections for information on how to leverage the Heatmap.

Understanding the Heatmap results

The analysis of Heatmap results involves viewing the test coverage of your transactions, filtering test coverage types, and reviewing transaction overviews. Explore the following topics to gain a comprehensive understanding of how to examine Heatmap results.

查看事务的测试覆盖率

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

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 代码 用于生成唯一标签

为特定事务创建测试用例

You can generate manual tests using Autopilot^TM for transactions viewed as part of the Heatmap. The generated test cases will have the following labels assigned:

• Autopilot 生成的
• TRAN：<transactionCode>

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

   “提供支持文档”窗口将打开，提示您提供生成测试用例所需的附件或其他文档。

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

   

   
   
3. 在“提供支持文档”窗口中，选择其他附件。

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

   图 2.在“提供支持文档”窗口中选择一个文档
   

   

   
   
4. 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.

   For instance, you can specify Autopilot^TM the number of test cases that you want to generate. The maximum number of test cases is 50.

   图 3.在“提供其他指导”窗口中输入的其他说明
   

   

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

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

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

   

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

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

• Autopilot 生成的
• TRAN：<transactionCode>

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

Creating test cases and test sets

After you analyze the results displayed in the Heatmap, you can start improving your testing portfolio, by creating test cases and test sets for uncovered or failed transactions. Check the following pages for steps on creating test cases and test sets for a specific transaction.

为特定事务创建测试用例

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

   重要提示：

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

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

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

为特定事务创建测试集

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

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

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

   

   
   
4. After you create the test set, navigate to Test Sets in Test Manager.
5. 搜索您创建的测试集并将其打开。
   您可以使用在步骤 3 中添加的标签搜索测试集。
6. 选择“任务”>“分配测试用例”>“静态分配”。
7. 搜索您在步骤 1 中创建的测试用例，并将其分配给此测试集。
   
   

   

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

将 Orchestrator 测试集链接到事务

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

Execute test sets for a transaction

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

热图附件

The SAP data that generates the heatmap can be found in Test Manager's Dashboard, under Attachments:

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