UI Explorer

用户界面探测器是一个高级工具，使您可以为特定用户界面元素创建一个自定义选取器。它是独立工具，可以从 Automation Cloud 实例中的资源中心下载，也可以从 Studio 下载（仅限将 UiPath.UIAutomation.Activities 包作为项目的依赖项安装时）。

将 UI Explorer 用作独立工具时无需安装 Studio。如果您要确保可以使用选取器自动化应用程序，此工具非常方便。它可以让您简单地检查元素，无需构建流程。独立包还包含“SetupExtensions”实用程序，因此可以安装浏览器扩展程序和 JavaBridge 来检查您的所有自动化需求包含的元素。

要打开“用户界面探测器”窗口，请单击“设计”选项卡中“选取器”部分中的按钮，或在指定目标用户界面元素后，单击“目标”和“锚点”属性的所有选取器的选择屏幕中的高级编辑器中的按钮。

备注：

如果您没有将 UiPath.UIAutomation.Activities 包安装为当前项目的依赖项，那么功能区中不会显示用户界面探测器。

或者，也可以从 Studio 后台视图中的“工具”页面启动用户界面探测器。上下文菜单中的用户界面探测器使用当前版本的 Studio 附带的用户界面自动化库。

备注：

当前使用的“用户界面自动化”包版本显示在已打开的UI Explorer 的右下角。此版本各有不同，因为从“工具”页面启动UI Explorer使用的是您正在使用的 Studio 版本附带的默认用户界面自动化版本，而从功能区打开UI Explorer则是使用已经作为当前项目的依赖项安装的版本。

为确保选择最佳选取器，请记住：

• 添加或删除属性
• 添加父项或子项标签
• 使用通配符来替换变化值

用户界面探测器窗口字段说明

字段	描述
验证	正在验证选取器 有效选取器 无效选取器 修改的选取器，重新验证
指出元素	指出一个新的用户界面元素以替换前一个。
指出锚点	使您能够选择一个相对于目标用户界面元素的锚点。
修复	使您能够重新指定相同的目标用户界面元素并修复选取器。此操作并不完全替换以前的选取器。只有在选取器无效时，该按钮才可用。
高亮显示	将目标元素置于前台。高亮显示一直持续到被关闭为止。仅当选取器有效时才会启用该按钮。
检查事件	打开“事件检查工具” 。
选项	包含几个选项： “用户界面框架”- 更改用于确定用户界面元素及其选取器的技术。可选择以下选项： 默认 – UiPath 专有方法。通常可以很好地处理所有类型的用户界面。 首先尝试使用合适的 UiPath 扩展程序或连接器（例如 浏览器/远程/Java 扩展程序、SAP 连接器等）生成选取器。 如果无法实现，请尝试使用 Active Accessibility（大多数桌面应用程序的首选）或用户界面自动化（Office 应用程序的首选）生成选取器。 Active Accessibility - Microsoft 之前给出的让应用程序可访问的解决方案。建议您在旧版软件中使用此选项（前提是默认选项无效）。 尝试使用 Active Accessibility 生成选取器，并略过 UiPath 扩展程序或连接器。 要确定选取器是否使用 Active Accessibility 技术，您必须查找 Ctrl 标签。具体来说，子字符串<ctrl 。在 XAML 中，您可能会发现其被编码为&lt;ctrl 。 用户界面自动化 – 这是 Microsoft 的改进型辅助功能模型。默认项无效时，建议您在较新的应用程序中使用此选项。 尝试使用用户界面自动化生成选取器，然后略过 UiPath 扩展程序或连接器。 注意：目前，此框架不支持 Chrome 或 Edge 网页，而是会生成 wnd 选取器，而不是回退到扩展程序。 有关更多信息，请参阅“主动式辅助”和 “用户界面自动化” 。 延迟还原 - 在系统加载完选取器数据前，延迟还原 UiExplorer 窗口。当指出在焦点丢失时自动关闭的用户界面元素（如下拉列表或覆盖）时，请使用该选项。 触发器选取器 - 在增加用户界面元素监控准确度时，请确保此元素在其父项中的唯一性。为触发器活动生成选取器时，请使用此选项。

可视化树面板

显示用户界面层次结构的树，通过单击每个节点前面的箭头，用于在其中导航。

默认情况下，当您第一次打开“用户界面探测器”时，此面板中会显示所有打开的应用程序并以字母顺序排列。

双击树中的用户界面元素（或右击并选择“设置为目标元素”），填充“选取器编辑器”、“选取器属性”和“属性探测器”面板。

字段	描述
高亮显示	实时高亮显示可视化树中的选定元素。高亮显示一直持续到被关闭为止。
显示搜索选项	显示搜索框和搜索过滤器选项。
搜索框	使您可以查找特定字符串。如果找不到精确匹配项，则显示包含最接近匹配项的节点。 支持通配符。 根据从“搜索依据”下拉列表中选择的属性，搜索内容可能区分大小写。 注意：搜索仅在所选用户界面对象下的树结构中查找匹配项。
搜索方式	过滤搜索结果，以仅显示选定属性或选取器。此下拉列表的内容根据所选用户界面元素而变化。 注意：如果“搜索依据”设置为“选取器”，则只能以 <attribute name1='value1' ... /> 格式输入一个节点。
仅子项	将搜索限制在所选节点的第一级子节点。默认情况下，该复选框是未选中状态。

选取器编辑器面板

显示指定用户界面对象的选取器，使您能够对其进行自定义。

面板的底部显示了必须在项目中使用的实际 XML 片段。找到所需的选取器后，可以从这里复制，然后将其粘贴到活动的“属性”面板中的“选取器”字段中。

此面板的顶部用于查看选取器中的所有节点，并通过清除前面的复选框来清除不必要的节点。当启用或禁用属性或编辑底部面板中的选取器时，选取器节点列表中的元素将变为活动元素。一次只能有一个节点处于活动状态。

如果在此处选择节点，那么将在“选取器属性”和“属性探测器”面板中显示其属性。

也可借助变量来编辑选取器；您可以使用 CTRL+K 热键在选取器本身中创建变量，或通过 CTRL+Space 组合指定已创建的变量。通过使用 CTRL+K 热键，您可以为变量指定值和名称。请注意，只能使用 string 变量。

选取器属性面板

显示选定节点的所有可用属性（来自“选取器编辑器”面板）。

您可以通过选中或清除每个属性前面的复选框来添加或消除某些节点属性。

此外，您可以更改每个属性的值，但只有当新的选取器指向最初选定的用户界面对象时，才会保留此修改。

属性探测器面板

显示指定用户界面对象可以具有的所有属性，包括选取器中没有出现过的属性。这些属性无法更改。

事件检查工具

在基于触发器的 Attended 自动化的上下文中，事件检查工具可用于识别与应用程序中的某些用户界面元素交互时触发的原生事件的类型，然后可用于配置“应用程序事件触发器”活动。该工具可捕获并监控所有选定的事件类型，例如单击、按键、获得焦点、失去焦点和其他相关交互，使您能够分析执行的操作，并在适用时诊断问题。

选择有效的用户界面元素后，通过单击“检查事件”工具栏按钮，即可从“UI Explorer”打开事件检查工具。

工具栏包含以下选项：

• 记录 - 记录通过与用户界面元素交互而生成的事件并将其添加到事件列表中。
• 暂停 - 不再记录与用户界面元素交互时生成的事件。
• 高亮显示 - 显示目标元素的轮廓，并将其置于前台几秒钟。一直高亮显示，直到禁用为止。
• 在 UI Explorer 中打开 - 在 UI Explorer 中打开受监控的元素，您可以在其中观察该元素的选取器。

开始事件记录后，还有两个选项可用：

• 清除 - 删除所有记录的事件。
• CSV - 可以将捕获的事件导出到.csv文件中以进行进一步分析。

“事件检查工具”窗口分为两个主要部分：

• 事件筛选器 - 允许选择您想要监视目标元素的事件类型。
• 事件列表 - 显示有关已捕获事件的信息。

您可以通过启用或禁用事件类型列表中的复选框来筛选要捕获的事件类型。该列表可能因所选元素技术而异。

默认情况下，禁用特定于 Web 或 Java 用户界面元素的所有鼠标事件类型（ “鼠标” 、 “已按下鼠标” 、 “已释放鼠标” 、 “鼠标已进入”、 “鼠标已退出”），因为在这种情况下，事件列表可能会变得非常大。我们的建议是，仅在您有监控鼠标事件类型的特定需求时才启用它们。

还值得一提的是，即使在开始事件记录之后，也可以启用或禁用事件类型。

事件列表包含三列：

• 事件名称 - 事件类型。
• 时间戳 - 执行事件时的日期和时间（小时）。
• 事件数据 - 特定事件的关联数据和参数。

每一列都可以按升序或降序排序。默认情况下，事件按执行顺序显示。

找到“消失”类型事件后，您将无法再继续监控，并且屏幕上会显示错误消息。单击工具栏中的任何选项时，屏幕上都会显示相同的错误消息。唯一可用的选项是清除数据或将其导出为.csv文件。要再次开始监控，请关闭窗口并打开事件检查工具的另一个实例 。