Studio 用户指南

上次更新日期 2025年10月23日

API 测试自动化

Studio 通过“ 新建服务 ”向导支持 API 测试自动化。您可以使用各种 API 格式导入和测试 API 定义，包括 Swagger 等。Studio 的 API 测试自动化功能使您能够跨不同服务构建、管理和运行自动化测试。

导入后，您可以在测试自动化项目中使用服务定义来验证端点、响应和行为。您还可以将服务库作为 .nupkg 包发布到本地或 Orchestrator，并将其作为依赖项在测试工作流中重用。

Studio 还支持 Postman，将其作为导入 API 集合的附加选项。要导入集合，请在您的 Postman 帐户中生成API 密钥，并在“新建服务”向导中使用该密钥。Studio 与 Newman（Postman 的命令行运行程序）集成，因此您可以直接从命令行验证集合。有关 Postman 要求的更多详细信息，请访问Postman 集合。

使用“新建服务”向导进行 API 测试自动化

本示例显示了如何使用“ 新建服务” 向导，通过在 Studio 中加载 Swagger JSON 文件或 Swagger 链接，开始执行 API 测试自动化。

先决条件

要遵循此示例，您需要拥有以下资源之一：

从 Swagger 导出的 JSON 文件，该文件位于您的计算机上。
指向 Swagger 文件的链接。

步骤

在您的库项目中，从“设计”功能区中选择“新建服务”。
系统将显示“服务编辑器”窗口。
选择要使用的 Swagger 资源:
- 对于本地 JSON Swagger 文件，选择“文件或链接”字段旁边的“更多选项”菜单。浏览并打开所需的 Swagger 文件，以便导入。
- 如果您使用的是指向 Swagger 文件的链接，请直接在“文件或链接”字段中输入 Swagger 链接。
在“服务编辑器”中，选择“加载”。
Swagger 文件中定义的所有端点现已加载到“服务编辑器”中。
在“搜索操作”搜索框中键入您需要的方法或操作，并查看返回的结果。
对于 Swagger 文件，系统会使用不同的颜色标记您要加载的每个端点的方法。

命名空间是自动生成的，但您可以编辑它。
选择“保存”，将该服务集成到您的库中。

图 1. “服务编辑器”中加载的 Swagger 文件

使用 Postman 的 API 测试示例

以下示例使用 Postman 中定义的数据集合，即先将其导入 Studio 库，并使用该集合发布库，然后将其安装在测试项目中，并使用 UiPath.Testing.Activities 包中的测试活动部分来验证数据使用情况。

该测试用例旨在设计一项工作流，以便自动为银行客户申请贷款并检索贷款数据。

要检查 Postman 和 Newman 的安装先决条件，请阅读此页面。

定义数据集

在 Postman 中，定义数据集合或将现有数据集合导入当前工作区。我们创建了一个数据集合以申请贷款、检索和删除贷款详细信息。在 API 测试项目中使用时，此集合将检查我们的工作流逻辑是否正确。

导入集

要在 Studio 中导入集合，请创建一个库项目并使用“新建服务”窗口。通过 Postman API 密钥授予对集合的访问权限。在“文件或链接”字段中添加此密钥，然后单击“加载”。

仅选择要在项目中加载的端点，并在需要时添加新的“命名空间”。

选中“链接的集合”选框以便使用链接，从而在运行时执行最新版而不是本地存储版集合。完成后，单击“保存”。

使用数据集

将该集合导入 Studio 库后，其端点会自动转换为活动，您可以在先前设置的命名空间下的“活动”选项卡中找到该活动。

在此示例中，我们针对从端点生成的每项活动创建了单独的序列文件。

添加活动后，在“属性”面板中添加 Postman 环境（使用引号引用 ""）。

Postman 集合中定义的数据值将作为参数导入：

库可以作为 .nupkg 包在本地或在 Orchestrator 中发布。

API 测试项目中的加载库

使用“测试自动化”项目类型在 Studio 中创建测试项目。
使用“管理包”窗口将发布的库安装为依赖项。
现在，您可以在库命名空间下的“活动”面板中使用先前在库中定义的序列文件，以及从 Postman 导入生成的活动。
在 API 测试自动化项目中使用这些活动，并与 UiPath.Testing.Activities 包中的活动结合使用。我们创建了一个测试项目，以验证在演示应用程序中申请贷款时输入的数据。这项小型测试使用一组在“属性”面板中可见的硬编码变量：

这项简单的测试流程已经用于烟雾测试，以检查应用程序是否正确响应。您可以根据自动化需求，在 Studio 中创建多项此类测试。
要验证某个测试项目中的多个场景，请转到功能区，选择“新建”>“数据驱动测试用例”。按照此处的说明，导入数据集。以下是此类测试用例的示例。这些值现已存储到参数中，并在活动中映射。
选择“运行含数据变体的文件”或“调试含数据变体的文件”，然后选择要使用的数据。此方法非常适用于测试包含多个数据集的多个场景。
运行该流程后，结果将显示在“输出”面板中。