- 入门指南
- 设置和配置
- 自动化项目
- 依赖项
- 工作流类型
- 控制流程
- 文件比较
- 自动化最佳实践
- 源代码控件集成
- 调试
- 日志记录
- 诊断工具
- 工作流分析器
- 变量
- 参数
- 导入的命名空间
- 编码自动化
- 基于触发器的 Attended 自动化
- 对象存储库
- ScreenScrapeJavaSupport 工具
- 扩展程序
- Studio 测试
- 故障排除
Studio 用户指南
本快速入门指南可帮助您踏上使用编码自动化的旅程。通过本教程，您将学习如何创建编码自动化，该教程演示了如何创建编码工作流，该工作流会生成 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)
{
// Check if a decimal number is even
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}");
// 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}");
您使用通过 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))
{
// 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}");
}
管理编码工作流流程
创建和设计编码工作流后，您可以使用“工作流分析器”对其进行验证，调试和运行工作流，然后将其发布到 Orchestrator。
-
在设计功能区中，依次单击“分析文件”和“验证文件”，以检查编码工作流文件中是否存在 C# 编译器错误。
访问“关于工作流分析器”，以阅读有关工作流分析器的信息。 2. 在“调试”功能区中，单击“调试文件”，以调试编码的工作流文件，并检查运行时的不一致问题。
3. Either in the Debug or Design ribbon, click Debug File then Run File, to run the coded workflow file that you created. 4. Select Publish in the Design ribbon. The Publish Process dialog appears. 5. In the Publish options tab, select where to publish the project. The available options depend on the type of project you are publishing.
流程：
- Orchestrator 租户流程订阅源、Orchestrator 个人工作区订阅源
- Assistant（机器人默认值）- 机器人和 Assistant 的默认包位置，
C:\ProgramData\UiPath\Packages。此处发布的项目会自动显示在 Assistant 中。如果 Studio 连接到 Orchestrator，则该选项不可用。 如果 Studio 已连接到 Orchestrator，则这些选项可用。 - 自定义 - 自定义 NuGet 订阅源 URL 或本地文件夹。添加 API 密钥是可选的。
- 单击“发布”。系统会创建一个 NUPKG 文件，并将其上传到 Orchestrator（自定义 NuGet 订阅源），或保存在本地目录中。
示例项目
要按照本教程中的步骤进行操作并自行尝试，您可以下载以下示例项目：第一次编码工作流。
后续步骤
访问以下资源，完善您在编码自动化方面的知识：