Studio 用户指南

上次更新日期 2024年12月19日

快速入门指南

本快速入门指南可帮助您踏上使用编码自动化的旅程。通过本教程，您将学习如何创建编码自动化，该教程演示了如何创建编码工作流，该工作流会生成 1 到 100 之间的随机数，并根据数字是偶数还是奇数执行加法或减法运算。

什么是编码自动化？

编码自动化是使用代码而不是拖放活动创建的自动化。开发编码自动化时，您可以使用 UiPath 服务（相当于活动包）、API（类似于活动）、外部 .NET NuGet 包和 UiPath Studio 中的自定义 C# 类。这样可以轻松与外部系统、数据库、API 和其他服务集成。编码自动化可以分为三种类型：

编码工作流 - 用于以代码形式设计工作流。
编码测试用例 - 用于设计测试用例。
代码源文件 - 用于创建稍后可以在其他编码文件类型中调用的代码。

要了解更多信息，请访问编码自动化简介。

场景

在本教程中，我们使用 RandomNumber API 生成指定范围内的随机十进制数字。然后，我们使用名为 IsEven 的自定义方法检查生成的数字是否为偶数，并根据该条件执行加法或减法。

创建编码工作流。

在 Studio 项目中创建编码工作流，并安装必要的依赖项。

安装 Testing.Activities 23.10，因为该场景涉及使用测试服务中的 RandomNumber API。
通过选择“新建”，然后从“文件”组中选择“编码工作流”，创建一个编码工作流。
编码自动化由命名空间、帮助程序类和入口点方法构成。基类 CodedWorkflow 用于编码工作流和测试用例，并提供对必要接口和服务的访问权限。名为 Execute() 的入口点方法对于运行这些自动化至关重要，支持使用输入参数和输出参数进行自定义。

设计编码工作流

在 Studio IDE 中编写代码，Studio IDE 由专用的代码编辑器、文件选项卡和便于导航的面包屑导航组成。

在编码工作流中，在 Execute() 方法外部创建一个名为 IsEven 的自定义方法。
此方法会返回一个 boolean 值，该值表示输入的 decimal 变量是否为偶数。
请查看下面的代码示例：
```
private bool IsEven(decimal number)
        {
           // Check if a decimal number is even
        return (number % 2 == 0);
        } private bool IsEven(decimal number)
        {
           // 检查十进制数字是否为偶数
        return (number % 2 == 0);
        }
```
提示：如果您不想在单独的代码源文件中创建自定义方法，则可以在编码工作流或编码测试用例中，在 Execute() 方法外部创建该方法。
在 Execute 方法内部，使用 RandomNumber API 创建两个具有随机值的 decimal 变量，并使用 Console.WriteLine 在控制台中输出对应结果。
请查看下面的代码示例：
```
// Generate random numbers within a specified range (e.g., 1 to 100)
        decimal num1 = testing.RandomNumber(1, 100);
        decimal num2 = testing.RandomNumber(1, 100);
            
        Console.WriteLine($"Generated numbers: {num1} and {num2}");// 生成指定范围的随机数（例如 1 到 100）
        decimal num1 = testing.RandomNumber(1, 100);
        decimal num2 = testing.RandomNumber(1, 100);
            
        Console.WriteLine($"Generated numbers: {num1} and {num2}");
```
注意：您可以像编写代码一样编写编码自动化，使用由 UiPath 服务提供的 API 和其他自定义 C# 类，或 nuget.org 订阅源中提供的 .NET 类库。在编码自动化中，服务相当于低代码自动化中使用的活动包。这些服务（例如 System.Activities、UiAutomation.Activities 和 Testing.Activities）附带可用于构建编码自动化的 API。

创建一个 If 语句，并使用条件：如果两个数字是偶数，则自动化应将它们相加。如果至少有一个数字为奇数，则应在 Else 字句中指示系统应减去对应数字。应使用 Console.WriteLine 在控制台中输出这两个结果。

请查看下面的代码示例：

if (IsEven(num1) && IsEven(num2))
        {
            // Both numbers are even, so add them together
            decimal sum = num1 + num2;
            Console.WriteLine($"Both numbers are even. Sum: {sum}");
        }
        else
        {
            // At least one number is odd, so subtract them
            decimal difference = num1 - num2;
            Console.WriteLine($"At least one number is odd. Difference: {difference}");
        } if (IsEven(num1) && IsEven(num2))
        {
            // 这两个数字都是偶数，因此对其求和
            decimal sum = num1 + num2;
            Console.WriteLine($"Both numbers are even. Sum: {sum}");
        }
        else
        {
            // 至少一个数字是奇数，因此对其求差
            decimal difference = num1 - num2;
            Console.WriteLine($"At least one number is odd. Difference: {difference}");
        }

管理编码工作流流程

创建并设计编码工作流后，您可以使用工作流分析器对其进行验证，调试，运行，然后发布到 Orchestrator。

在“设计”功能区中，依次单击“分析文件”和“验证文件”，以检查编码工作流文件中是否存在 C# 编译器错误。

请访问关于工作流分析器，了解有关工作流分析器的信息。
在“调试”功能区中，单击“调试文件”以调试编码的工作流文件，并在运行时检查不一致问题。
在“调试”或“设计”功能区中，依次单击“调试文件”和“运行文件”，以运行您创建的编码工作流文件。
在“设计”功能区中选择“发布”。
系统将显示“发布流程”对话框。
在“发布选项”选项卡中，选择项目的发布位置。可用选项取决于您要发布的项目类型。
流程：
- Orchestrator 租户流程订阅源、Orchestrator 个人工作区订阅源
- “Assistant（机器人默认值）”- 机器人和 Assistant 的默认包位置，C:\ProgramData\UiPath\Packages。此处发布的项目会自动显示在 Assistant 中。如果 Studio 连接到 Orchestrator，则该选项不可用。如果 Studio 已连接到 Orchestrator，则这些选项可用。
- 自定义 - 自定义 NuGet 订阅源 URL 或本地文件夹。添加 API 密钥是可选的。
单击“发布”。
系统会创建一个 NUPKG 文件，并将其上传到 Orchestrator（自定义 NuGet 订阅源），或保存在本地目录中。