使用 Activity Creator

活动是流程自动化的构建块。每个活动都包含一个最小操作，该最小操作与其他活动堆叠在一起构成工作流。

UiPath Studio 包含许多预构建的活动，您可以通过包管理器安装这些活动。

您还可以使用 UiPath适用于 Visual Studio 的 Activity Creator 扩展程序根据您的需求创建自定义活动。以下步骤将为您在 5 分钟内构建自定义活动奠定基础。在本节中，我们将创建一个活动包，并在下一节中为该包填充功能活动。

需要满足的条件

• 具有 *.NET 桌面开发功能的Visual Studio 社区版/专业版/企业版 2022
• 已安装的工作负载
• UiPath 的 UiPath Marketplace Feed ( https://Gallery.uipath.com/api/v3/index.json ) 作为 Visual Studio 中的包源。有关添加包来源的说明，请参阅此处。
• .NET 6
• UiPath Studio

重要提示：

请注意，Activity Creator 4.0 版仅适用于 Visual Studio 2022。 同样，生成的活动以 .NET 6 Windows 项目为目标。 要创建与旧版 Visual Studio 或 .NET 兼容的活动，请使用版本 3 的扩展程序。

此外，此扩展程序创建的活动依赖于 UiPath 制造的库，这些库当前可在 UiPath Marketplace 订阅源 ( https://Gallery.uipath.com/api/v3/index.json ) 上获取。在开发过程中，此订阅源在 Visual Studio 中必须可用，否则活动将无法成功构建。

步骤 1：将 UiPath Activity Creator 扩展程序添加到 Visual Studio

Open Visual Studio and click Extensions > Manage Extensions.

In the wizard that appears, click Online and then Search (Ctrl+E) for UiPath. Download the UiPath Activity Creator extension.

Close Visual Studio and, once the VSIX Installer appears, complete the installation.

步骤 2：创建 UiPath 项目

Reopen Visual Studio and double-click Create a new project on the home screen.

On the Create a new project screen, type "uipath" in the search bar, select UiPath Standard Activity Project, and click Next.

Give your project a name. The UiPath convention is <Your company's name>.<Your product's name> (e.g. UiPath.Orchestrator). Then click Create.

导航到解决方案资源管理器，您会发现，3 个项目、一个共享文件夹和许多文件现已添加到解决方案中。这是每个活动包的基础。用于添加第一个活动的简单活动。

简单活动

创建包后，我们可以向其中添加活动！ 在此示例中，您将创建如上所示的活动：将两个数字相加的简单活动。

您需要满足的条件

• Visual Studio 社区版/专业版/企业版（需要升级到 2019 年）
• UiPath Studio
• Using The Activity Creator

步骤 1：打开 Activity Creator

首先打开在上一部分中创建的 Visual Studio 解决方案，然后在解决方案资源管理器中选择任何主要项目（这些项目是标记为 MyCompany.MyProduct…的项目）。然后在工具栏中导航到“扩展程序”>“UiPath”>“添加活动” 。请注意，在选择其中一个项目之前，系统将禁用此菜单。

步骤 2：构建活动

这将打开一个新的“活动创建者”窗口。 第一个屏幕为您提供两个选项：

1. Create: Build one or more activities from scratch.
2. Import: Import a list of predefined activities that have been saved in a standard format.

For now, select Create.

步骤 3：定义活动

Click the Add button and fill in each field as shown below. This will prepare the creator to build an activity named Addition. When ready, click the Edit button to add properties to the Addition activity.

步骤 4：添加属性

这将打开一个新的“定义属性”窗口。使用“添加”按钮创建 3 个属性，如下所示。

确保前两个为输入，最后一个为输出。 这些属性将表示两个数字及其总和。

步骤 5：生成活动

在属性窗口中单击确定，然后在活动窗口中单击完成。然后，您将看到一些新文件添加到您的项目中。

步骤 6：添加功能

打开刚才创建的 Addition.cs 文件，然后展开其中的 Protected Methods 区域，以显示活动的 ExecuteAsync 方法。 每当在 UiPath Studio 中运行活动时都会调用此方法。

请注意，在步骤 4 中创建的两个输入（第一个数字和第二个数字）以及一个输出（Sum）已添加到此方法中。 最后一步是弥合它们之间的差距，方法是将注释块替换为将两个输入相加的代码，然后将结果设置为 Sum。 见下文：

步骤 7：构建包

在“解决方案资源管理器”中，右键单击“设计” 项目，然后选择“发布” 。此选项会构建您的项目，将其打包在一起，然后将包发送到您指定的任意位置。

在下一个屏幕中，输入要用于保存活动包的文件夹。最好从 UiPath Studio 中选择一个包来源（您可以在 Studio 主页上的“设置”>“管理来源”中找到），以便可以直接从 Visual Studio 发布到 UiPath Studio。

单击创建配置文件以继续。

在下一页上，将包来源重命名为“UiPath 包” （或任何您想要的名称），并将配置更改为“调试” 。然后单击“发布” 。

有关调试与发布配置的更多信息，请参阅包元数据。

然后，您的输出将显示所有三个项目都已成功构建并已发布生成的包。 您现在拥有一个有效的活动包！

步骤 8：在 UiPath Studio 中使用您的活动

打开 UiPath Studio，导航到包管理器，然后将活动集添加到工作流中。

请注意，“活动”窗格中已添加一个新类别。

就是这样！ 尝试新活动!

包元数据

查看本教程中构建的活动包，您会看到几个占位符，其中应包含作者、许可证、图标等信息。 让我们通过将这些占位符替换为真实信息来个性化包。

本节的重点是“设计”项目，该项目包含所有包信息。

需要满足的条件

• Visual Studio 社区版/专业版/企业版（需要升级到 2019 年）
• UiPath Studio
• Using The Activity Creator

步骤 1：打开“设计”项目

双击打开“MyCompany.MyProduct.Activities.Design ”项目，请注意，存在三个带标签的部分：

• Package Metadata
• 程序包版本
• 程序包图标

包元数据

字段	描述
PackageLicenseExpression	要使用的许可证的SPDX 标识符。默认情况下是Apache 2.0 。
Description	将显示在 UiPath Studio 包管理器中的活动的简短说明。
Authors and Company	包的作者和所有者。
Copyright	标准版权声明。
PackageTags	用户可以搜索以查找您的包的术语列表。
PackageProjectUrl	指向活动文档或公司主页的链接。
PackageIconUrl	指向用作包图标的图像文件的链接。 请注意，UiPath Studio 当前不支持 PackageIcon 标签。

<PropertyGroup>
    <PackageRequireLicenseAcceptance>true</PackageRequireLicenseAcceptance>
    <PackageLicenseExpression>Apache-2.0</PackageLicenseExpression>
    <Description>A package used to perform simple arithmetic operations in UiPath Studio.</Description>
    <Authors>My Company</Authors>
    <Company>My Company</Company>
    <Copyright>@ 2020 My Company</Copyright>
    <PackageTags>UiPath Activity MyCompany MyProduct Math Addition Arithmetic</PackageTags>
    <PackageProjectUrl>https://docs.uipath.com/integrations/docs/how-to-create-activities</PackageProjectUrl>
    <PackageIconUrl>https://raw.githubusercontent.com/NuGet/Samples/master/PackageIconNuspecExample/icon.png</PackageIconUrl>
    ...
</PropertyGroup>

程序包版本

请注意，此处有两个 PackageVersion 标签，分别对应于可构建包的两种模式（调试和发布）。

• “调试”在开发过程中很有用。版本会随每次内部版本而递增，因此可以在 UiPath Studio 中进行更新并立即进行测试。
• 发布用于创建准备发布的最终包。开发完成后，您可以在此处设置所需的版本。

  <PropertyGroup Condition="'$(Configuration)' == 'Debug'">
      <PackageVersion>0.2.0.$([System.DateTime]::UtcNow.ToString(MMddHmmss)) Version</PackageVersion>
  </PropertyGroup>
    
  <PropertyGroup Condition="'$(Configuration)' == 'Release'">
      <PackageVersion>0.2.0</PackageVersion>
  </PropertyGroup>
  

包图标

使用PackageIconUrl标签向活动包添加图标。在此示例中，使用了示例图标。

步骤 2：重新构建包

如上一节所述，重新构建包并将其导入到 UiPath Studio 中。打开包管理器，并注意您的包现在如何具有新的图标、描述和更新的元数据。