订阅

UiPath Studio

UiPath Studio 指南

关于库

A Library is a package which contains multiple reusable components. Libraries are saved as .nupkg files and can be installed as dependencies to workflows using Package Manager.

For example, you could create a library that collects data from an Excel spreadsheet and appends it to another, as explained in the Creating a Basic Library page. Next, the library can be packaged and used in other processes as an activity.

管理可重用的组件活动

可重用组件活动表示打包为一个 .nupkg 文件并可在其他流程中使用的一个或多个工作流。

创建库

  1. 转到“Studio 后台视图”>“开始”>“库”。这将打开新建空白库窗口。
  2. 填写库的名称并为库选择一个位置。默认位置为 C:\Users\<current_user>\Documents\UiPath。添加描述,然后选择“创建”。系统将创建新库并将其保存在本地计算机上。
    注意:库名称不能超过 128 个字符,描述不能超过 500 个字符。
  3. 项目面板显示包含实际工作流的树状视图,其中带有项目文件夹、依赖项和 NewActivity.xaml
    库中的每个工作流文件都可作为项目中的活动提供,而在此类项目中,库作为依赖项安装。如果要将某个文件设为私有,请右键单击该文件,然后选择“从发布中忽略”。在这种情况下,该文件包含在库包中,但是在“活动”面板中不能作为可重用组件使用。

📘

Note:

默认情况下,新库可以使用的依赖项与空白新项目可以使用的依赖项相同,即 UiPath.Excel.ActivitiesUiPath.Mail.ActivitiesUiPath.System.ActivitiesUiPath.UIAutomation.Activities(“最低适用版本”规则有效)。

要添加工具提示并帮助链接到活动,请在“项目”面板中右键单击工作流文件,然后选择“属性”。当您在安装了库的项目中,将鼠标悬停在“活动”和“设计器”面板中的活动上时,则可以看到该工具提示。当您在“设计器”面板中选择活动并按 F1 时,“帮助链接”将打开。

Arguments you define in the library become activity properties in the projects where the library is installed as a dependency. Arguments that are marked as required are available in the body of the activity in the Designer panel. Annotations you add to an argument in the library are displayed as a tooltip for the property in the resulting activity's Properties panel. For more information about arguments, see Arguments Panel.

📘

Notes:

  • 就库而言,建议使用 Nothing(而非 "")将 null 值分配给变量。如此一来,在将打包的库作为依赖项用于项目中时,便能避免发生任何不一致的情况。
  • 不支持 System.Activities.ActivityBuilder 对象的“实现版本”属性。为该属性设置值将导致参数无法保存。当您选择“设计”面板的空白区域,该对象显示在“属性”面板中。

调整库设置

要配置库项目的设置,请在“项目”面板中单击“设置”settings_iconsettings_icon,打开“项目设置”窗口。

“常规”选项卡中提供以下选项:

  • 名称 - 编辑项目的名称。
  • 描述 - 编辑项目的描述。
  • Project Icon - optionally, define a custom icon for the project. You can browse to and select a file, or enter a path or public URL to an ico, jpeg, jpg, or png file up to 1MB in size.
    After the project is published, the icon is displayed next to the package in the Manage Packages window in Studio..
  • 包含源 - 设置为“是”以打包生成的程序集文件中的所有 .xaml 源,包括以前已设为私有的工作流。这在调试工作流时很有帮助。
  • 编译活动表达式 - 设置为“是”以编译所有活动表达式并将其与库打包。这可缩短执行时间。
  • 新式设计体验 - 设置为“是”以实现使用用户界面自动化的新式体验,包括新活动和改进的活动、录制器和向导,以及对象存储库。

发布库

发布库类似于发布流程。有关更多信息,请参见关于发布自动化项目

发布库时的限制

发布库时,请考虑以下限制:

  • 由于 NuGet 的限制:
    • 您无法使用 Windows 环境路径变量将库发布到包含用户受限的子文件夹所在的位置。
    • 已发布库的发行说明仅在 Orchestrator 中可见。
  • 如果库中 .xaml 文件的名称中包含特殊字符,则该库可能无法成功发布。
  • Libraries containing Invoke Workflow File activities with the Isolated option selected cannot be published. An error message is displayed in the Output panel.
  • 在使用“调用工作流文件”活动时,请确保所调用的文件与库项目位于同一个文件夹中。
  • The Launch Workflow Interactive activity is not supported for libraries.
  • Using Invoke Workflow File inside a library to reference the library itself is not supported.

向自动化项目中添加可重用组件

  1. 打开现有项目,或创建一个新项目。
  2. 在“所有包”类别下,选择保存库的订阅源并安装包。
  3. 选择“确定”,然后包将被添加到项目定义中。
  4. 该活动位于“活动”面板中的自定义类别中。

📘

Notes:

  • 库是向前兼容的,这意味着它们只能用于使用 Studio v2018.3 及更高版本创建的项目。库不能发布到版本低于 2018.3 的 Orchestrator。
  • 当您运行的项目包含自定义活动的项目时,可能会发生错误,这些自定义活动来自在 2019.10.1 之前的 Studio 版本中创建并通过 Studio 2019.10.1 或更高版本发布的库中。在这种情况下,您必须重新创建并重新发布库。

请注意,在库项目中,当使用“导入工作流”来添加包含库的工作流时,不会导入库中引用的依赖项。

将同一自定义库的两个版本导入 Studio 中的项目时,只有第二个库中包含的额外自定义活动在“活动”面板中不可见,除非您删除第一个导入的库。

Updated about a month ago



关于库


建议的编辑仅限用于 API 参考页面

You can only suggest edits to Markdown body content, but not to the API spec.