使用 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

打开 Visual Studio，然后单击“扩展” > “管理扩展” 。

在出现的向导中，单击“在线”，然后单击“搜索 ( Ctrl+E ) UiPath”。下载UiPath Activity Creator扩展程序。

关闭 Visual Studio，并在出现 VSIX 安装程序后完成安装。

步骤 2：创建 UiPath 项目

重新打开 Visual Studio，然后在主屏幕上双击“创建新项目” 。

在“创建新项目”屏幕的搜索栏中键入“uipath”，选择“UiPath 标准活动项目”（活动项目） ，然后单击“下一步” 。

为您的项目命名。UiPath 约定为<Your company's name>.<Your product's name> （例如UiPath Orchestrator).然后单击“创建” 。

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

简单活动

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

您需要满足的条件

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

步骤 1：打开 Activity Creator

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

步骤 2：构建活动

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

1. 创建: 从头开始构建一个或多个活动。
2. 导入: 导入以标准格式保存的预定义活动的列表。

现在，选择“创建” 。

步骤 3：定义活动

单击“添加”按钮并填写每个字段，如下所示。这将使创建者准备好构建名为“添加”的活动。准备就绪后，单击“编辑”按钮，向“添加”活动添加属性。

步骤 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
• 使用 Activity Creator

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

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

• 包元数据
• 程序包版本
• 程序包图标

包元数据

字段	描述
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 中。打开包管理器，并注意您的包现在如何具有新的图标、描述和更新的元数据。