studio
2022.4
false
- 发行说明
- 入门指南
- 设置和配置
- 自动化项目
- 依赖项
- 工作流类型
- 文件比较
- 自动化最佳实践
- 源代码控件集成
- 调试
- 诊断工具
- 工作流分析器
- 变量
- 参数
- 导入的命名空间
- 录制
- 用户界面元素
- 控制流程
- 选取器
- 对象存储库
- 数据抓取
- 图像与文本自动化
- Citrix 技术自动化
- RDP 自动化
- Salesforce 自动化
- SAP 自动化
- VMware Horizon 自动化
- 日志记录
- ScreenScrapeJavaSupport 工具
- Webdriver 协议
- 测试套件 - Studio
- 扩展程序
- 故障排除
Studio 用户指南
Last updated 2024年11月18日
关于库
库是一个项目,其中包含一个或多个工作流,这些工作流可在其他项目中作为活动重用。 库在发布时会另存为 NUPKG 文件,并且可以从 包管理器作为依赖项进行安装。
例如,您可以创建一个库,使其从 Excel 电子表格中收集数据,并将所收集的数据附加到另一个电子表格,如创建基本库页面所述。接着便可将库打包,并将其作为活动用于其他流程。
要添加工具提示并帮助链接到活动,请在“项目”面板中右键单击工作流文件,然后选择“属性”。当您在安装了库的项目中,将鼠标悬停在“活动”和“设计器”面板中的活动上时,则可以看到该工具提示。当您在“设计器”面板中选择活动并按 F1 时,“帮助链接”将打开。
您在库中定义的参数将成为将库作为依赖项安装的项目中的活动属性。在“设计器”面板的活动主体中提供了标记为必需的参数。添加到库中参数的注释将在生成的活动的“属性”面板中显示为该属性的工具提示。有关参数的更多信息,请参见“参数面板”。
备注:
- 就库而言,建议使用
Nothing
(而非""
)将 null 值分配给变量。如此一来,在将打包的库作为依赖项用于项目中时,便能避免发生任何不一致的情况。 - 不支持
System.Activities.ActivityBuilder
对象的“实现版本”属性。为该属性设置值将导致参数无法保存。当您选择“设计器”面板的空白区域,该对象显示在“属性”面板中。
要配置库项目的设置,请单击“项目”面板中的“设置”,打开“项目设置”窗口。
“常规”选项卡中提供以下选项:
- 名称 - 编辑项目的名称。
- 描述 - 编辑项目的描述。
- Automation Hub URL - 链接到项目的 Automation Hub 概念的 URL。有关详细信息,请参阅将项目链接到 Automation Hub 中的概念。
-
项目图标 -(可选)定义项目的自定义图标。您可以浏览并选择一个文件,或者为大小至多 1MB 的
ico
、jpeg
、jpg
或png
文件输入路径或公共 URL。项目发布后,该图标将在 Studio 中“管理包”窗口中程序包旁显示。
- 包含源 - 设为“是”以包含库包中的所有
.xaml
源,包括先前设为私有的工作流。对于 Windows - 旧版库,这些文件保存在生成的程序集文件和.nupkg
文件的lib\net45
文件夹中。对于 Windows 和跨平台库,文件将保存在.nupkg
文件的content
文件夹中。 - 编译活动表达式 - 设置为“是”以编译所有活动表达式并将其与库打包。这可缩短执行时间。可用于 Windows - 仅旧版库。
- 准备运行 - 设置为“是”以优化生成的程序集,以便在运行时更快地进行 JIT 编译。仅可用于 Windows - 旧版库。
- 新式设计体验 - 设置为是以实现使用用户界面自动化的新式体验,包括新活动和改进的活动、录制器和向导,以及对象存储库。
发布库类似于发布流程。有关更多信息,请参见关于发布自动化项目。
发布库时,请考虑以下限制:
-
由于 NuGet 的限制:
- 您无法使用 Windows 环境路径变量将库发布到包含用户受限的子文件夹所在的位置。
- 已发布库的发行说明仅在 Orchestrator 中可见。
- 如果库中
.xaml
文件的名称中包含特殊字符,则该库可能无法成功发布。 - 如果库包含名称相同的
.xaml
文件和参数,则无法发布该库。 - 具有 Windows - 旧版兼容性的库项目如果包含已选中“隔离”选项的“调用工作流文件”活动,则无法发布。尝试发布时,“输出”面板中会显示一条错误消息。此限制不适用于使用 Windows 或跨平台兼容性的库。
- 在使用“调用工作流文件”活动时,请确保所调用的文件与库项目位于同一个文件夹中。
- 库不支持“启动工作流交互”活动。
- 不支持在库中使用“调用工作流文件”来引用库本身。
- 如果库包含接受文件路径作为输入的活动,则在项目中使用组件时,包含环境变量的路径将解释为相对于库文件夹的路径。要解决此问题,请使用
Environment.GetEnvironmentVariable
方法或“获取环境文件夹”活动来检索文件夹路径,然后使用输出来构建传递到可重用组件的绝对路径。 - 如果将放置在库文件夹中的工作流文件用作项目中的命名空间,则在项目中更改文件夹名称、重新发布和安装更新的库会导致未知活动。
- 打开现有项目,或创建一个新项目。
- 在“所有包”类别下,选择保存库的订阅源并安装包。
- 选择“确定”,然后包将被添加到项目定义中。
- 该活动位于“活动”面板中的自定义类别中。
在项目中安装库的注意事项
- 库只能安装在具有相同兼容性的项目中。
- 如果跨平台库包含具有用户界面自动化活动的工作流,则在跨平台项目中添加生成的活动会导致执行项目时出现验证错误。
- 当您运行的项目包含自定义活动的项目时,可能会发生错误,这些自定义活动来自在 2019.10.1 之前的 Studio 版本中创建并通过 Studio 2019.10.1 或更高版本发布的库中。在这种情况下,您必须重新创建并重新发布库。
- 在库项目中,当使用“导入工作流”来添加包含库的工作流时,不会导入库中引用的依赖项。
- 将同一自定义库的两个版本导入项目时,仅包含在第二个库中的额外自定义活动在“活动”面板中不可见,除非您删除第一个导入的库。