- 发行说明
- 入门指南
- 设置和配置
- 自动化项目
- 依赖项
- 工作流类型
- 控制流程
- 文件比较
- 自动化最佳实践
- 源代码控件集成
- 调试
- 日志记录
- 诊断工具
- 工作流分析器
- 变量
- 参数
- 导入的命名空间
- 编码自动化
- 基于触发器的 Attended 自动化
- 录制
- 用户界面元素
- 选取器
- 对象存储库
- 数据抓取
- 图像与文本自动化
- Citrix 技术自动化
- RDP 自动化
- VMware Horizon 自动化
- Salesforce 自动化
- SAP 自动化
- macOS 用户界面自动化
- ScreenScrapeJavaSupport 工具
- Webdriver 协议
- 扩展程序
- 测试套件 - Studio
- 故障排除
关于库
库是一个项目,其中包含一个或多个工作流,这些工作流可在其他项目中作为活动重用。 库在发布时会另存为 NUPKG 文件,并且可以从 包管理器作为依赖项进行安装。
例如,您可以创建一个库,使其从 Excel 电子表格中收集数据,并将所收集的数据附加到另一个电子表格,如创建基本库页面所述。接着便可将库打包,并将其作为活动用于其他流程。
您在库中定义的参数将成为将库作为依赖项安装的项目中的活动属性。
要配置在项目中使用活动时的外观和行为,请右键单击库“项目”面板中的工作流文件,然后选择“活动布局”。根据库的兼容性(Windows - 旧版、Windows 或跨平台),活动属性窗口将显示不同的选项。
在左侧菜单中选择“活动属性”,然后输入以下内容:
- 显示名称 - “活动”面板中显示的活动名称。
- 工具提示 - 在安装了库的项目中,将鼠标悬停在“活动”和“设计器”面板中的活动上时可见的工具提示。
- 帮助链接 - 在“设计器”面板中选择活动并按键盘上的 F1 时打开的帮助链接。
- SVG 图标 - 显示在活动名称旁边的 SVG 图标。
- 颜色 - 在“设计器”面板中为活动显示的高亮显示颜色。
工作流文件中定义的参数列在左侧菜单的“活动属性”下。
-
要自定义生成的属性,请选择该属性并配置以下内容:
- 显示名称 - 活动中显示的属性标签。
- 工具提示 - 将鼠标悬停在活动属性上时可见的工具提示。
-
输入类型 - 属性的输入类型。您可以使用属性类型的默认输入,也可以根据类型选择输入选项:
- 布尔值 - 使用默认值、切换(默认)、条件构建器、单选按钮。
- 数字(int、double、decimal、long、short、sbyte、byte、ulong、ushort、unit、float)- 使用默认值、数字编辑器、下拉列表。对于下拉列表,在“值”字段中,通过按键盘上的 Enter 键输入每个单独的值。
- 字符串 - 使用默认值、文本编辑器(默认)、富文本编辑器、下拉列表、自动完成、单选按钮。对于下拉列表、自动完成和单选按钮,在“值”字段中,通过按键盘上的 Enter 键输入每个单独的值。
- String[] - 使用默认值、字符串数组。
- 日期时间 - 使用默认值、日期时间。
- 时间跨度 - 使用默认值、时间跨度。
- - 使用默认值、字典。
- 所有其他类型 - 使用默认值、输入。
- 占位符 - 未选择任何值时在输入处显示的占位符文本。
- 必需 - 是否需要该属性。
- 仅限高级 - 是否应仅在活动的高级选项部分中显示属性。高级选项部分中的属性也可以按类别进行组织。
- 要添加用于对多个相关属性进行分组的类别,请选择窗口左下方的“新建类别”。类别仅在所生成活动的高级选项部分中可用,并且可以展开或折叠。如果类别为空,则单击“保存”以关闭窗口时,系统会将其删除。
-
要更改属性和类别的顺序,或向类别添加属性,请拖放列表中的项目。
- 如果库包含 Integration Service 活动或调用的工作流包含 Integration Service 活动,则在配置活动布局时,这些活动中使用的连接以及其他活动属性将显示为单独的实体。您可以重新排序和分类 Integration Service 连接和属性,并编辑属性的“显示名称”和“工具提示”。
备注:
- 在调用会调用编码工作流的工作流时,配置连接和属性可能不起作用。
-
在包含使用连接的库活动的流程中,如果将不属于该库的活动但使用相同连接的活动添加到流程中,则第二个活动将覆盖库活动的设置。
在左侧菜单中选择“活动属性”,然后输入以下内容:
- 工具提示 - 在安装了库的项目中,将鼠标悬停在“活动”和“设计器”面板中的活动上时可见的工具提示。
- 帮助链接 - 在“设计器”面板中选择活动并按键盘上的 F1 时打开的帮助链接。
工作流文件中定义的参数显示在左侧菜单的“活动属性”下。
-
要自定义生成的属性,请选择该属性并配置以下内容:
- 显示名称 - 活动中显示的属性标签。
- 工具提示 - 将鼠标悬停在活动属性上时可见的工具提示。
- 必需 - 是否需要该属性。
- 仅限高级 - 是否应仅在“属性”面板中显示属性。如果选中,则所生成活动的“设计器”面板中不会显示该属性。
-
要更改属性在活动中的显示顺序,请将其拖放到列表中。
备注:- 就库而言,建议使用
Nothing
(而非""
)将 null 值分配给变量。如此一来,在将打包的库作为依赖项用于项目中时,便能避免发生任何不一致的情况。 - 不支持
System.Activities.ActivityBuilder
对象的“实现版本”属性。为该属性设置值将导致参数无法保存。当您选择“设计器”面板的空白区域,该对象显示在“属性”面板中。
- 就库而言,建议使用
要配置库项目的设置,请单击“项目”面板中的“设置”,打开“项目设置”窗口。
“常规”选项卡中提供以下选项:
- 名称 - 编辑项目的名称。
- 描述 - 编辑项目的描述。
- 项目标签 - 您可以通过创建新标签或重用 Orchestrator 中已定义的标签来向项目添加一个或多个标签。标签有两种类型:标签和属性(键值对)。标签包含在已发布的包中,它们有助于描述项目并对其进行分类。有关更多信息,请参阅关于自动化项目。
- Automation Hub URL - 链接到项目的 Automation Hub 概念的 URL。有关详细信息,请参阅将项目链接到 Automation Hub 中的概念。
-
包图标 -(可选)定义项目的自定义图标。您可以浏览并选择一个文件,或者为大小至多 1MB 的
ico
、jpeg
、jpg
或png
文件输入路径或公共 URL。项目发布后,该图标将在 Studio 中“管理包”窗口中程序包旁显示。
- 编译活动表达式 - 设置为“是”以编译所有活动表达式并将其与库打包。这可缩短执行时间。可用于 Windows - 仅旧版库。
- 准备运行 - 设置为“是”以优化生成的程序集,以便在运行时更快地进行 JIT 编译。仅可用于 Windows - 旧版库。
- 单独的 Runtime 依赖项 - 为了提高机器人性能并缩小已发布包的大小,现在将库分为设计包和运行时包。设计包由 Studio 使用,更精简的执行包由机器人使用。
- 包含来源 - 设为“是”以打包已发布包中的所有
.xaml
源,包括先前设为私有的工作流。对于 Windows - 旧版库,这些文件保存在生成的程序集文件和.nupkg
文件的lib\net45
文件夹中。对于 Windows 和跨平台库与流程,文件将保存在.nupkg
文件的content
文件夹中。
- 由于设计时包和运行时包之间存在分离,不保证在 Studio 2023.4 中发布的自定义库与早期的 Studio 版本兼容。
- 您只能在项目中安装设计时包,因为在发布时设计时包会替换为运行时包。仅安装运行时包将导致 Studio 中出现意外问题。
- Starting with Studio 2023.10.0, the separation between design time and runtime packages occurs only if:
- A
ViewModels.dll
file is generated during the compilation process. TheViewModels.dll
file is generated for Windows and cross-platform libraries when configuring viewmodel activity properties for at least one workflow file inside the library. - The Separate Runtime Dependencies option is enabled.
- A
使用库时,请考虑以下限制:
-
由于 NuGet 的限制:
- 您无法使用 Windows 环境路径变量将库发布到包含用户受限的子文件夹所在的位置。
- 已发布库的发行说明仅在 Orchestrator 中可见。
- 如果库中
.xaml
文件的名称中包含特殊字符,则该库可能无法成功发布。 - 如果库包含名称相同的
.xaml
文件和参数,则无法发布该库。 - 具有 Windows - 旧版兼容性的库项目如果包含已选中“隔离”选项的“调用工作流文件”活动,则无法发布。尝试发布时,“输出”面板中会显示一条错误消息。此限制不适用于使用 Windows 或跨平台兼容性的库。
- 在使用“调用工作流文件”活动时,请确保所调用的文件与库项目位于同一个文件夹中。
- 库不支持“启动工作流交互”活动。
- 不支持在库中使用“调用工作流文件”来引用库本身。
-
如果库包含接受文件路径作为输入的活动,为确保在安装了库的项目中正确解析路径,请在引用路径时添加 UiPath.Constants.Project.Location 全局常量(使用确切的大写字母)。这将禁止在开始执行库活动时将
Environment.CurrentDirectory
更改为库文件夹,并改用常量。例如,如果在“读取文件”活动中使用库项目的 InputData 子文件夹中名为 Employee.txt 的文件,请提供如下路径:
UiPath.Constants.Project.Location+"InputData\Employee.txt"
注意:不得在库内的“调用工作流文件”活动中使用该常量。 - 要从安装库的项目文件夹中引用位置,请将库的路径作为参数传递。
- 打开现有项目,或创建一个新项目。
- 在“所有包”类别下,选择保存库的订阅源并安装包。
- 选择“确定”,然后包将被添加到项目定义中。
- 该活动位于“活动”面板中的自定义类别中。
在项目中安装库的注意事项
- 具有跨平台兼容性的库可以安装在跨平台项目和 Windows 项目中。Windows - 旧版库和 Windows 库只能安装在具有相同兼容性的流程中。
- 当您运行的项目包含自定义活动的项目时,可能会发生错误,这些自定义活动来自在 2019.10.1 之前的 Studio 版本中创建并通过 Studio 2019.10.1 或更高版本发布的库中。在这种情况下,您必须重新创建并重新发布库。
- 在库项目中,当使用“导入工作流”来添加包含库的工作流时,不会导入库中引用的依赖项。
- 将同一自定义库的两个版本导入项目时,仅包含在第二个库中的额外自定义活动在“活动”面板中不可见,除非您删除第一个导入的库。
-
在活动面板中查看库时,使用库名称中的句点 (
.
) 将库分为多个嵌套的组。