studio
2024.10
true
UiPath logo, featuring letters U and I in white
Studio 用户指南
Last updated 2024年11月18日

快速入门指南

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

什么是编码自动化?

编码自动化是使用代码而不是拖放活动创建的自动化。开发编码自动化时,您可以使用 UiPath 服务(相当于活动包)、API(类似于活动)、外部 .NET NuGet 包和 UiPath Studio 中的自定义 C# 类。这样可以轻松与外部系统、数据库、API 和其他服务集成。编码自动化可以分为三种类型:
  1. 编码工作流 - 用于以代码形式设计工作流。
  2. 编码测试用例 - 用于设计测试用例。
  3. 代码源文件 - 用于创建稍后可以在其他编码文件类型中调用的代码。

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

场景

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

创建编码工作流。

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


设计编码工作流

在 Studio IDE 中编写代码,Studio IDE 由专用的代码编辑器、文件选项卡和便于导航的面包屑导航组成。
  1. 在编码工作流中,在 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() 方法外部创建该方法。
  2. 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.ActivitiesUiAutomation.ActivitiesTesting.Activities)附带可用于构建编码自动化的 API。
  3. 创建一个 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。
  1. 在“设计”功能区中,依次单击“分析文件”和“验证文件”,以检查编码工作流文件中是否存在 C# 编译器错误。


    请访问关于工作流分析器,了解有关工作流分析器的信息。
  2. 在“调试”功能区中,单击“调试文件”以调试编码的工作流文件,并在运行时检查不一致问题。


  3. 在“调试”或“设计”功能区中,依次单击“调试文件”和“运行文件”,以运行您创建的编码工作流文件。
  4. 在“设计”功能区中选择“发布”。
    系统将显示“发布流程”对话框。
  5. 在“发布选项”选项卡中,选择项目的发布位置。可用选项取决于您要发布的项目类型。
    流程
    • Orchestrator 租户流程订阅源Orchestrator 个人工作区订阅源
    • “Assistant(机器人默认值)”- 机器人和 Assistant 的默认包位置,C:\ProgramData\UiPath\Packages。此处发布的项目会自动显示在 Assistant 中。如果 Studio 连接到 Orchestrator,则该选项不可用。 如果 Studio 已连接到 Orchestrator,则这些选项可用。
    • 自定义 - 自定义 NuGet 订阅源 URL 或本地文件夹。添加 API 密钥是可选的。
  6. 单击“发布”
    系统会创建一个 NUPKG 文件,并将其上传到 Orchestrator(自定义 NuGet 订阅源),或保存在本地目录中。

示例项目

要按照本教程的步骤自行尝试,您可以下载以下示例项目:第一个编码工作流

后续步骤

访问以下资源,完善您在编码自动化方面的知识:

  • 什么是编码自动化?
  • 场景
  • 创建编码工作流。
  • 设计编码工作流
  • 管理编码工作流流程
  • 示例项目
  • 后续步骤

此页面有帮助吗?

获取您需要的帮助
了解 RPA - 自动化课程
UiPath Community 论坛
Uipath Logo White
信任与安全
© 2005-2024 UiPath。保留所有权利。