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.

例如,您可以创建一个库,使其从 Excel 电子表格中收集数据,并将所收集的数据附加到另一个电子表格,如创建基本库页面所述。接着便可将库打包,并将其作为活动用于其他流程。

管理可重用的组件活动

可重用组件活动表示打包为一个 .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 即可打开帮助链接。

从模板创建新库时,“设计器”面板不会自动打开 .xaml 文件,除非库模板中含有 Main.xaml 文件。

Add an annotation to a used argument in the library to have it displayed later as a tooltip in the activity's Properties panel. Read the Arguments Panel to find out more about adding annotations to arguments.

Note:

就库而言,建议使用 Nothing(而非 "")将 null 值分配给变量。如此一来,在将打包的库作为依赖项用于项目中时,便能避免发生任何不一致的情况。

调整库设置

A set of individual settings can be established for a library project. Such settings are available in the Project Settings window, which can be opened by clicking the settings_icon in the Project panel.

“项目设置”窗口可用于更改库的名称和说明。将“包含的源”开关设为“是”,可将所有 .xaml 来源打包到生成的程序集文件中,包括之前设为私有的工作流。

发布库

  1. 在“设计”功能区选项卡中,选择“发布”。“发布库”窗口将打开。
  1. In the Publish Location category, set the library to be published to Orchestrator, a custom NuGet feed or on the local machine. The API key can be used for authentication to the custom NuGet feed.
    Once the library has reached Orchestrator, it is stored either in the host feed or in the tenant feed, as configured on the Settings page. Details about libraries feeds here.

Note:

由于 NuGet 限制,您无法使用 Windows 环境路径变量将库发布到包含用户受限的子文件夹的位置中。

  1. 在“发行说明”类别中,键入有关版本的详细信息以及其他相关信息。已发布项目的发行说明可在 Orchestrator 的“包”部分中查看。请注意,“发行说明”字段最多可接受 10,000 个字符。
  2. Add a New Version to the project, and check the Is Prerelease box to mark the version as alpha if needed. Please note that this automatically changes the project’s version schema to semantic. When publishing a new version of the file locally, make sure that the custom location does not already include a file with the same proposed version number. For more details about project versioning, check the About Automation Projects page.

Note:

由于 NuGet v3 的限制,已发布库的发行说明仅在 Orchestrator 中可见。

  1. 在“库设置”类别中,为“活动根类别”设置一个名称或保留默认库名。这将为“活动”面板中的可重用组件创建一个新的类别。请注意,先前设置的根类别已存储到下拉列表中。
  2. 选中“包含源”旁边的复选框,以打包生成的程序集文件中的所有 .xaml 源,包括以前已设为私有的工作流。这在调试工作流时很有帮助。
  3. In the Certificate Signing section, add a local Certificate Path next to the Certificate box. Furthermore, add Certificate Password and Optional Certificate Timestamper if needed. For more details, check out the Signing Packages page.

Note:

目前,系统仅接受使用 .pfx.p12 证书扩展程序为项目签名。

  1. 选择“发布”。整个项目文件夹被归档到一个 .nupkg 文件中,并上传到 Orchestrator、自定义 NuGet 订阅源或保存在本地目录中。
  2. 如果项目已成功发布,则将显示“信息”对话框,其中包含:
    • 包发布到 Orchestrator 或本地时采用的名称;
    • 包发布时采用的版本号。
    • 项目的发布位置(如果项目是在本地发布)。
    • “复制到剪贴板”选项。

发布库时的限制

以下限制将导致库无法发布:

  • Libraries with special characters in the names of .xaml files they contain may not be successfully published.
  • 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. 该活动位于“活动”面板中的自定义类别中。

Note:

库是向前兼容的,这意味着它们只能用于使用 Studio v2018.3 及更高版本创建的项目。库不能发布到版本低于 2018.3 的 Orchestrator。

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

When importing two versions of the same custom library to a project in Studio, the extra custom activities contained only in the second library are not visible in the Activities panel unless you remove the first imported library.

Updated 11 days ago



关于库


Suggested Edits are limited on API Reference Pages

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