- 发行说明
- 入门指南
- 设置和配置
- 自动化项目
- 依赖项
- 工作流类型
- 文件比较
- 自动化最佳实践
- 源代码控件集成
- 调试
- 诊断工具
- 工作流分析器
- 变量
- 参数
- 导入的命名空间
- 录制
- 用户界面元素
- 控制流程
- 选取器
- 对象存储库
- 数据抓取
- 图像与文本自动化
- Citrix 技术自动化
- RDP 自动化
- Salesforce 自动化
- SAP 自动化
- VMware Horizon 自动化
- 日志记录
- ScreenScrapeJavaSupport 工具
- Webdriver 协议
- 测试套件 - Studio
- 扩展程序
- 故障排除
Studio 用户指南
用户界面
Studio 包含多个面板,便于您更轻松地访问特定功能。这些面板可以停靠,充当浮动窗口,您也可以在下拉列表中启用“自动隐藏”选项。
编号 |
名称 |
描述 |
---|---|---|
1 |
访问 Studio 的三个主要区域: | |
2 | ||
3 |
通过管理添加到当前工作流文件中的活动来构建自动化。 | |
4 |
使用可用的搜索栏在项目内执行搜索: | |
5 |
管理变量。 | |
6 |
管理参数。 | |
7 |
管理导入的命名空间。 | |
8 |
查看当前项目的内容,管理文件、文件夹和依赖项,以及调整项目设置。 | |
9 |
查看所有可用活动并将活动添加到自动化中。 | |
10 |
使用预先构建的工作流并添加您自己的可重复使用的自动化流程。 | |
11 |
查看和配置所选活动的属性。 | |
12 |
管理项目中的数据。 | |
13 |
查看当前工作流和所有可用节点的层次结构。 | |
14 |
在流程内部和跨流程创建和重用 UI 分类法。 | |
15 |
查看与测试自动化相关的信息。 | |
16 |
查看“日志消息”和“写入行”活动的输出、有关项目执行状态的信息、活动包生成的错误等。 | |
17 |
查看项目中引用元素的所有位置。 | |
18 |
查看运行工作流分析器时生成的所有错误。 | |
19 |
管理添加到项目中的断点。 | |
20 |
查看状态信息,并管理 Orchestrator 连接和源代码控件集成的状况。 |
功能区简单明了,可以通过单击“最小化/展开”按钮 将其最小化或展开。它由以下三个选项卡组成:
- 主页 - 创建和打开项目,配置 Studio,或从 Studio 后台视图访问帮助和许可证信息。
-
“设计” - 向项目中添加序列、流程图和状态机,安装和管理活动包,与用户界面元素构建交互,将工作流导出到 Excel,然后将您的工作发布到 OrcheStrator 或自定义订阅源。请记住,除非您安装
UiPath.UIAutomation.Activities
包,否则“功能区”中将不会显示“向导”和“UI Explorer”。 -
“调试”- 调试工作流,同时使用调试工具设置断点,逐步监视活动的执行,并调整调试速度。打开日志,查看有关项目执行以及对项目进行的任何更改的详细信息。如需有关调试的更多信息,请查看关于调试页面。
注意:不是在执行自动化项目期间创建的文件在发布到 Orchestrator 之后将变为只读文件。如果您的业务流程要求您在某个时候写入特定的文件,请确保在设计项目时创建该文件。
发送反馈
您可以直接从 Studio 中发送以下两类反馈:“提交产品建议”或“报告错误”。您可以单击功能区中的 图标访问这两类反馈。
“发送反馈”功能只能用于向产品团队发送匿名反馈。如需联系我们的技术支持团队,请使用联系技术支持表单。
提供以下信息,然后单击“提交”:
- 从“我希望”下拉菜单中,选择“提交产品建议”或“报告错误”。
- 从“对象”下拉菜单中,选择“UiPath 活动”、“UiPath Studio”、“UiPath 机器人”、“UiPath Orchestrator”或“UiPath 助理”。
- 从“这对您的重要性”下拉菜单中,选择“值得拥有”、“重要”或“关键”。
- 在“主题”字段中,添加简短的标题。
- 添加详细说明并附加最多 6 个图片、视频或文本文件,每个文件均需小于 10MB。发送反馈的阈值为 5 分钟内发送 3 次。
这是您首次打开 Studio 时看到的视图。您也可以通过单击窗口左上角的“主页”进入此视图。您可以在此处创建和打开项目、配置 Studio 或访问帮助和许可证信息。
此视图中提供以下按钮和选项卡:
-
“打开”- 浏览至本地自动化项目并打开它。默认情况下,项目的创建位置为 C:\Users\<current_user>\Documents\UiPath。
注意:无法在 Studio 中打开位于用户仅具有读取权限的网络文件夹上的项目。我们建议使用来源控件系统针对项目进行协作。 - 关闭 - 关闭当前打开的自动化项目。
- “开始”- 创建新的自动化项目或打开最近访问的项目。您可以从预定义的模板创建新项目,也可以打开您最近处理过的项目。可以从“打开最近的项目”列表中固定或删除项目,该列表显示每个项目的说明、目标框架、用于表达式的语言以及项目来源(本地、Studio Web 或 GIT/SVN/TFS 存储库)。将鼠标悬停在“打开最近的项目”列表中的条目上时,将显示
project.json
文件的路径以及上次打开项目的时间。 - 模板 - 基于模板创建新项目。在此选项卡中,您可以查看所有可用的项目模板,并可按来源搜索和筛选模板。有关更多信息,请参阅项目模板。
- “团队”- 管理自动化项目的“来源控件集成”。
-
工具 - 访问可增强 Studio 体验的工具。
- 选择“ 用户界面探测器” 、 “项目依赖项批量更新工具” 和“ Microsoft Office 修复工具”的“应用程序” 选项卡。
- 选择“UiPath 扩展程序”选项卡以安装或卸载以下扩展程序:Chrome、Firefox、Edge、Java、Silverlight、Citrix、Windows 远程桌面、VMware Horizon、Excel 加载项和 SAP 解决方案管理器。
- 选择“插件”选项卡以启用或禁用来源控件和测试自动化插件。
- “设置” - 更改 Studio 的外观、设置全局首选项以及管理活动包来源。 有关更多信息,请参阅 配置 Studio 设置。
-
您还可以在这里访问快速教程,该教程可以帮助您学习创建、发布和运行自动化的基础知识。
注意:为确保成功完成本教程,我们建议您暂停本教程,然后对未在本教程步骤中突出显示的工作流进行任何更改。有关产品版本和安装、许可可用性、更新通道和设备 ID 的信息也可以在“帮助”选项卡中找到,其中还有一个用于将详细信息快速复制到剪贴板的“复制信息”按钮。
使用 Ctrl + Shift + P、F3 键盘快捷键,或单击搜索按钮,以打开“命令面板”。该面板中包含“添加活动”、“通用搜索”、“转到文件”和“跳转到活动”搜索栏。
使用 Ctrl + Shift + T 键盘快捷键即可打开“添加活动”搜索栏。您可以在已安装的包中搜索活动,并将其添加到文件中选定的活动之后。该搜索栏会向前五个结果自动分配键盘快捷方式,并记住之前的搜索结果。
单击序列中某个活动顶部或底部的 图标即可打开“添加活动”搜索栏。
如果在 Studio 设计设置中选择了“启用 AI 活动建议”选项,UiPath AI 服务会分析您在工作流中打开“添加活动”搜索栏的位置,并根据当前上下文建议您接下来可能要添加的活动。如果没有上下文(例如,在“设计器”面板中未选择任何活动时按 Ctrl + Shift + T),则不会提供活动建议。
“通用搜索”栏使您可以查找当前项目中的代码片段、活动、变量、参数、导入、项目依赖项和文件。搜索从所有工作流文件(包括已关闭的文件)中返回结果。
选项 |
快捷方式 |
描述 |
---|---|---|
当前文件 |
Ctrl + 1 |
列出当前打开的文件中与搜索查询相匹配的结果。 |
所有文件 |
Ctrl + 2 |
列出当前项目的所有文件中与搜索查询相匹配的结果。 |
活动 |
Ctrl + 3 |
列出与搜索查询匹配的活动的结果。 |
变量 |
Ctrl + 4 |
查找当前项目中与搜索查询相匹配的变量。 |
参数 |
Ctrl + 5 |
查找项目中定义的与搜索查询相匹配的参数。 |
导入 |
Ctrl + 6 |
在项目中查找与搜索查询相匹配的已导入命名空间。 |
项目文件 |
Ctrl + 7 |
查找当前项目中与搜索查询相匹配的文件。 |
依赖项 |
Ctrl + 8 |
列出安装到项目的依赖项中的查询结果。 |
代码片段 |
Ctrl + 9 |
查找与搜索查询匹配的代码片段文件。 |
若使用“通用搜索”或“添加活动”,系统会在您下一次打开搜索栏之前一直保留搜索结果。若使用“转到文件”和“跳转到活动”,则不会保留之前的搜索查询。
双击活动或按 Enter 键,将活动添加至当前打开的文件。通过使用相同命令,您可以打开“所有文件”或“项目文件”类别下的文件,或聚焦所需的搜索结果。
调用工作流活动内的流程参数默认值不可使用“通用搜索”功能进行搜索。
.xaml
文件将在 Studio 的“设计器”面板中打开,其他文件(例如屏幕截图或 Excel 文件)则由计算机上的对应默认应用程序打开。双击或按 Enter 键即可打开文件。
dci
,系统将返回“双击图像”活动。
通过双击要查看的活动,可以在图表中导航。路径在“设计器”面板的标题中显示为面包屑导航。请注意,当使用缩放比例不同的多个显示器时,某些活动的输入字段部分中的文本可能会显示不当。
您可以使用“Ctrl + C”快捷键或上下文菜单将活动复制到文本编辑器,接收更改,然后将其复制回“设计器”面板。您可以使用 Studio 功能区中的按钮或按“Ctrl + Z”/“Ctrl + Y”来撤消/重做在面板中执行的操作。
如果活动出现验证错误,则“设计器”面板中活动标题栏的右侧会显示一个错误图标 ,同时该活动的所有父级活动中也会显示一个警告图标 。单击图标即可打开受问题影响活动的“属性”面板,并且错误消息将在“属性”面板的顶部显示。
单击 图标、按住空格键或按下鼠标中键,即可激活“全景模式”。使用缩放下拉菜单可更改缩放级别,单击 图标可将之重置回 100%。
“适应屏幕” 图标可更改缩放,使整个工作流适应“设计器”面板。单击 图标可获取整个项目的概述,并可通过调整焦点浏览各部分。
上下文菜单
上下文菜单用于在工作流上执行多个操作,无论是序列还是流程图。可以通过右击工作流中的某个活动来显示上下文菜单。
上下文菜单的字段描述
选项 |
描述 |
---|---|
查看父项 |
在“设计器”面板中显示目标活动的父项。 注意:只有在“设计器”面板中打开子活动时,才会对子活动显示此选项。
|
打开 |
在“设计器”面板中打开选定的活动。结果与双击相同。 |
折叠 |
折叠活动,从而将显示的详细信息减少到“双击查看”。您可通过单击“折叠”按钮 获得相同结果。 注意:仅对序列显示。
|
原地展开 |
展开活动的内容,显示其详细内容。您可通过单击“展开”按钮 获得相同结果。 注意:仅对序列显示。
|
剪切 |
删除选定的活动,并将其放在剪贴板上。 |
复制 |
复制选定的活动,并将其放在剪贴板上。只读文件中的活动现在可以复制到另一个工作流或
.txt 文件中。将多个活动复制到剪贴板时,其顺序会颠倒。
:warning: 将活动复制到具有不同兼容性的项目(例如,从 Windows - 旧版到跨平台)时,可能会导致执行目标工作流失败。 |
粘贴 |
在当前位置插入剪贴板的内容。 |
删除 |
删除目标活动。 注意:由于只有选择了单个活动时才会显示“上下文”菜单,因此您可以通过对应的键盘快捷方式 Delete 对更多个活动使用此命令。
|
批注 |
添加、编辑、删除、显示和隐藏添加到工作流中的活动的批注。 |
复制为图像 |
生成“设计器”面板中所显示内容的屏幕截图。 注意:如果您想要创建一个子活动的屏幕截图,请确保首先在“设计器”面板中打开该子活动。
|
保存为图像 |
生成“设计器”面板中所显示内容的屏幕截图,并提示用户设置详细信息以便保存(名称、类型和目标位置)。支持的格式:JPG、PNG、GIF 和 XPS。 |
创建变量 |
在“变量”面板中创建一个变量。 |
自动排列 |
在流程图中自动安排活动。 |
删除围绕的序列 |
从“设计器”面板中删除选定的“序列”活动。其包含的活动将移入父级序列。 |
用“Try Catch” (Ctrl+T)包围 |
在“Try Catch 异常处理”语句中插入活动。 注意:“Try Catch 异常处理”语句用于处理由数据或编程错误引起的异常。“Try”子句包括要检查异常的活动。“Catch”子句是异常处理程序。无论前两个子句的状态如何,“Finally”子句都用于执行活动。
|
提取为工作流 |
创建包含目标活动的新工作流,目的是将大型项目分解为较小的项目。在提取活动的位置上,将创建一个“调用
<new> 工作流”活动,用于编辑和导入新建工作流中的参数。系统会根据该活动中使用的变量自动创建参数。“调用 <new> 工作流”活动自动映射本地变量,以调用所提取工作流的参数。请注意,这仅适用于您创建的变量,参数并非根据父活动(如“遍历循环”)隐式创建的变量而创建。
|
打开工作流 |
打开使用上述选项创建的工作流。 |
启用活动 |
启用以前禁用的活动。 |
禁用活动 |
禁用一个活动,然后将该活动放置在“注释掉”活动中。 |
切换断点 |
将选定的活动标记为断点以进行调试。也可以通过单击“执行”选项卡中的“断点”按钮来切换断点。一次可以为一个活动触发一个断点。 |
编辑断点设置 |
打开“断点设置”窗口。 |
运行至此活动 |
调试项目并在执行此特定活动之前停止调试。 |
从此活动运行 |
从此活动开始调试。 |
显示所有条件 |
显示项目中定义的所有条件(“属性”面板 >“条件”)。 注意:仅当您在项目中右击空白空间时才会对流程图显示该选项;如果您在流程图中右击某个活动,那么不会显示该选项。
|
隐藏所有条件 |
隐藏显示的所有条件。 注意:仅当您在项目中右击空白空间时才会对流程图显示该选项;如果您在流程图中右击某个活动,那么不会显示该选项。
|
设置为开始节点 |
将所选活动与开始节点连接。 注意:仅对流程图显示。
|
设置为初始状态 |
将“状态机”特定活动连接到开始节点。 注意:仅对状态机显示。
|
还会对“设计器”面板中的选项卡显示上下文菜单。可选择以下选项:
选项 |
描述 |
---|---|
关闭 |
关闭活动选项卡。 |
关闭其他 |
关闭除活动选项卡之外的所有选项卡。 |
关闭所有文档 |
关闭所有选项卡。 |
浮动 |
取消停靠目标选项卡并将其更改为浮动状态。 |
固定选项卡 |
在“设计器”面板中固定目标选项卡。 注意:最后固定的选项卡总会移至所有其他现有选项卡之前(无论是否固定)。已固定的某个选项卡的位置只能相对于其他固定选项卡进行更改。
|
新建水平选项卡组 |
水平分割屏幕,使您能够在同一屏幕中查看“设计器”面板的两个或多个实例。目标项目将移动到右侧面板。 注意:只有当项目包含两个或更多选项卡以及隐含的工作流时,才会显示该面板。
|
新建垂直选项卡组 |
垂直分割屏幕,使您能够在同一屏幕中看到“设计器”面板的两个或多个实例。目标项目会移至底部面板上。 注意:只有当项目包含两个或更多选项卡以及隐含的工作流时,才会显示该面板。
|
移至上一个选项卡组 |
将目标选项卡移动到显示的前一个“设计器”面板上。 注意:只有以前使用过“新建垂直选项卡组”或“新建水平选项卡组”选项时,才会显示该面板。
|
移至下一个选项卡组 |
将目标选项卡移至显示的下一个“设计器”面板上。 注意:只有以前使用过“新建垂直选项卡组”或“新建水平选项卡组”选项时,才会显示该面板。
|
“项目”面板用于管理项目文件和依赖项,以及配置项目设置。有关更多信息,请参阅管理包。
“数据管理器”面板使您能够从一个集中位置管理变量、参数、常量、实体、Orchestrator 资源、连接和命名空间等数据。有关更多信息,请参阅使用数据管理器。
“活动”面板显示可添加到当前工作流的可用活动。您可以使用面板顶部的搜索框按名称或说明搜索活动,使用导航键浏览这些活动,然后按 Enter 将所选活动添加到当前打开的文件。
将鼠标悬停在面板中的活动上会显示该活动所属的包及其描述。要将活动添加到收藏夹列表,请右键单击它,然后选择“添加至收藏夹”。
右键单击面板中的活动,然后选择“ 创建测试台 ” 以测试一个或多个活动,然后再将其添加到项目中。 单击 此处了解详情。
自定义活动面板
单击面板顶部的“查看选项” 按钮,打开允许自定义面板的菜单。有关可用选项的列表,请参阅下表。
选项 |
描述 |
---|---|
显示收藏夹 |
显示包含收藏活动的部分。默认情况下,此选项处于选中状态。 |
显示最近的项目 |
显示包含最近使用的十个活动的部分。默认情况下,此选项处于选中状态。 |
显示可用 |
显示所有可用活动。默认情况下,此选项处于选中状态。 |
显示兼容性 |
当前未使用的选项。默认情况下未选中此选项。 |
显示传统/新式 |
显示使用传统设计体验的项目中的新式用户界面自动化活动,或显示使用新式体验的项目中的传统用户界面自动化活动。默认情况下未选中此选项。 |
显示目录 |
根据活动所属的类别对活动进行分组。默认情况下,此选项处于选中状态。 |
按程序包分组 |
根据活动所属的包对活动进行分组。默认情况下未选中此选项。
注意: 启用“ 按包分组” 视图选项时,包中版本高于 Studio 22.10 附带的版本的某些活动将分组到包的运行时版本下。
|
按描述搜索 |
在面板中搜索时,请搜索活动说明,而不仅仅是搜索活动名称。默认情况下未选中此选项。 |
固定收藏夹 |
在面板中搜索时,请始终保持收藏夹活动可见。如果选择了“显示收藏夹”,则可用。默认情况下未选中此选项。 |
“代码片段”面板使您可以轻松地重复使用自动化。默认情况下,它包括多个示例和代码片段。
要添加自己的示例和代码段,可以单击“添加文件夹”按钮并从硬盘驱动器中选择一个目录。不会显示空文件夹。
要删除某个文件夹,请右击该文件夹并选择“删除”。
“属性”面板包含上下文,用于查看和更改所选活动的属性。如果在相同工作流中选择两个活动,则仅可从“属性”面板修改通用属性。
在具有跨平台兼容性的项目中,所有活动属性都在“设计器”面板的活动卡中可用。这也适用于使用 Windows 兼容性的项目中的某些活动。
表达式编辑器
当用于活动输入字段时,可以使用 Ctrl + Shift + E 键盘快捷方式打开表达式编辑器。您还可从“属性”面板、需要输入文本的字段和活动主体中打开表达式编辑器,直接在所需字段中添加文本即可。
表达式编辑器包含智能代码完成功能。 表达式可以写在多行上。 提供了用于直接在表达式中创建变量和参数的键盘快捷方式 。
在编辑器中使用 Ctrl + F 打开搜索和替换功能。选择表达式的一部分,然后按 Ctrl + F3 将文本添加到搜索字段。按住 Ctrl 键使搜索窗格半透明,并查看其背后的文本。
当您关闭编辑器时,系统会保存该编辑器在显示器上的位置、窗口大小和文本缩放级别,并会在您下次打开编辑器时加以应用。
“输出”面板使您能够显示“日志消息”或“写入行”活动的输出等内容。此面板中也会显示包的例外情况。
在“输出”面板中,通过单击面板标题中的按钮,可以显示或隐藏具有不同日志级别(错误、警告)的消息。双击消息会显示关于此消息的更多详细信息,并包含用于复制信息的选项。
在“输出”面板中搜索日志并在搜索结果列表中选择项目时,相应日志将会高亮显示。
.txt
文件。该按钮还会导出时间戳和错误消息详情。此外还可导出筛选后的日志。例如,若想仅导出 Trace 级日志,您可筛选列表,然后使用“导出日志”按钮。
调试时,“输出”面板将显示日志,表示活动开始执行时间,直至结束的时间。您可通过“调试”选项卡中的“日志活动”选项启用此功能。
“ 错误列表” 面板显示验证过程中在文件或项目中发现的错误,以及 工作流分析器 规则生成的错误。
“全部清除”按钮会擦除“输出”面板中显示的所有信息。在运行工作流时,将擦除此面板中存储的日志和其他数据。“输出”面板一次最多显示 2,000 行。
“输出”面板不适用于生产监控,而应仅在开发自动化时使用。例如,在使用大量“日志消息”活动时,事件可能不会按预期显示。要监控生产运行,请使用 Orchestrator 日志。
“查找引用”面板显示您在项目中搜索的引用的结果。要查找项目中引用元素的每个位置,请右键单击该元素,然后选择“查找引用”。这适用于以下情况:
- “项目”面板中的文件
- “活动”面板中的活动
- “变量”面板中的变量
- “参数”面板中的参数
-
“对象存储库”面板中的描述符
在状态栏中,您可以查看与 Orchestrator 和来源控件相关的状态信息,并访问相关选项:
- Orchestrator/云连接 - 单击 以访问 Orchestrator 选项:登录到您的云帐户、断开与 Orchestrator 的连接(如果与计算机密钥连接),以及刷新资源。
- Orchestrator 状态 - 显示 Orchestrator 连接状态。连接到 Orchestrator 后,系统将显示当前选择的文件夹。您可以单击当前文件夹名称以查看可用文件夹列表,并选择要从中同步资源的其他文件夹。
- 源代码控件 - 根据项目是否连接到源代码控件存储库,可以使用不同的选项来帮助您管理源代码控件集成。 有关更多信息,请参阅 关于版本控制。
- Cloud 项目 - 对于使用 VB 语言的跨平台项目,提供了一个菜单,其中包含与在 Studio Web 中编辑项目相关的选项。如果项目尚未与 Studio Web 同步,则会显示“云兼容”标签。如果项目已与 Studio Web 同步,则会显示“云项目”标签。有关更多信息,请参阅设计跨平台项目。
- “项目语言”- 显示项目中的表达式所使用的语言(“VB”或“C#”)。
-
“项目兼容性”- 显示项目的兼容性、“Windows - 旧版”、“Windows”或“跨平台”。