关于对象存储库

对象存储库通过将用户界面元素捕获为类似 DOM 的存储库中的对象（可跨项目共享）来确保用户界面元素的管理、可重用性和可靠性。它允许在自动化项目内部和之间创建和重用用户界面分类。使用对象存储库，您可以为您的应用程序构建用户界面 API，并在几分钟之内与团队共享。

“对象存储库”的主要功能包括：

• 从集中位置管理、更新和修改项目中的用户界面元素。
• 使用“对象存储库”面板中的“用户界面活动”选项卡查看流程中所有用户界面活动的列表。
• 使用“捕获元素”向导快速捕获自动化中所需的元素。
• 借助能够捕获元素及其锚点的“捕获元素”记录器，提升选取器的可靠性。
• 借助锚点使对象保持可靠性，以防应用程序收到略新的用户界面。
• 从“对象存储库”面板中拖放元素。
• 当打包为库时，对象可在本地项目中或不同项目之间重复使用。
• 一次性升级应用程序和流程用户界面元素以及用户界面库。
  注意：如果项目位于文件管理系统（例如 OneDrive）下，对象存储库可能无法按预期运行。
  
  

  

  
  

先决条件

The Object Repository works with UiPath.UIAutomation.Activities package versions 20.10.x and above in projects that use the Modern Design Experience. Note that UiPath.UIAutomationNext.Activities package has been deprecated as of 20.10. The activities from UI Automation Next are now found in the UI Automation package. The Object Repository is not available in cross-platform projects.

“为新项目使用新式设计体验”切换功能用于控制新项目的默认设计体验。新式体验是一种全新的自动化设计方式，使用为对象存储库支持而增强的向导、录制器和活动。此切换功能在全局级别发挥作用，这表示如果启用，所有新项目都将在新式设计体验环境中创建。

当“强制使用对象存储库”切换功能设置为“是”时，用户界面自动化包的活动部分需要引用对象存储库中的元素。

在项目级别上还有一个“新式体验”开关。如果启用，当前项目将在新式设计体验的环境中运行。在新式设计体验中，默认情况下隐藏传统用户界面自动化活动。可以使用“活动面板”中的筛选条件启用它们。另外，您始终可以从项目设置中为特定项目切换到传统体验。或者，您可以通过后台 Studio 设置切换新项目的行为。

关键概念

UI 描述符

用户界面描述符是选取器的超集。它包含屏幕上唯一标识元素的信息。

用户界面描述符是从工作流中的活动中提取的，并添加到结构化的架构中，该架构按应用程序、应用程序版本、屏幕和用于界面元素对其进行分组。在此分类结构中，只有屏幕和元素保存描述符信息。其余的用于分组，它们的作用是确保应用程序版本之间的升级。

用户界面描述符可以是以下内容的一部分：

• 一个广泛重用的项目。
• 用于测试目的的代码片段存储库。
• 用于全局跨项目共享的“用户界面库”。

用户界面元素

用户界面元素包含全部或部分元素选取器、锚点选取器、屏幕和元素图像捕获上下文以及描述屏幕上元素的其他元数据。

屏幕

屏幕是用户界面作用域，它要么从工作流中的活动中提取，要么在元素捕获时生成。屏幕将属于同一屏幕的多个元素组合在一起。

用户界面应用程序

用户界面应用程序是目标应用程序，可以具有多个版本，并且每个版本可以具有多个屏幕。应用程序可以有多种类型：

• 桌面/网页应用程序
• 移动应用程序

要定义移动应用程序，您需要使用 UiPath.MobileAutomation.Activities 包。

使用“对象浏览器”创建的用户界面库的结构具有以下层次结构：“应用程序”>“版本”>“屏幕”>“用户界面元素”。

用户界面库

用户界面库是按应用程序、应用程序版本和屏幕分组的元素的封装。您定义的元素可以提取为用户界面库，并可发布后可以作为依赖项安装到其他项目中。

用户界面库可能包含多个应用程序，但只能包含某个应用程序的一个版本。这种机制可确保在升级依赖项时，还可以升级项目中使用的应用程序版本。

请注意，在创建现有应用程序的新版本时，您需要重用现有元素。元素具有从活动中引用时使用的唯一标识符。您始终可以更改元素的内容（描述符和其他元数据）。

可重用性

对象存储库让您可以在项目之间重复使用用户界面元素：

• 所有本地存储的元素都可以在项目级别重用
• 用于测试时，您可以使用“代码片段”面板将应用程序保存到项目中并在项目之间传递应用程序。从代码片段中，您可以将应用程序添加到本地项目存储库中。

• 要在全局级别重用时，将元素提取到用户界面库中，并将它们作为依赖项安装到项目中。您也可以采用可重用性优先的方法，首先创建用户界面库，其中包含所有自动化项目中所需的元素。

  
  

  

  
  
  
  

  

  
  

对象存储库结构

对象存储库具有树结构，其中每个节点都是一个表示屏幕或元素的对象，所有对象都是应用程序下的分层对象。结构如下：

• 应用程序 - 可以是两种类型之一：移动或桌面/网页，具体取决于用户界面自动化时使用的技术。
• 版本 - 应用程序可以有多个版本
• 屏幕 - 只能在应用程序版本下创建的应用程序版本的顶层窗口。
• 用户界面元素 - 屏幕上具有描述符和元数据的对象。它可以具有多种类型。

用户界面元素可以在树结构中自由重新排列，只要它们一直处于指定的屏幕下即可。如要移动，只需将元素拖放到树内所需的位置即可。

元素也可以是其他元素的一部分，也可以在没有用户界面特定角色的容器下进行分组。这允许定义一个与用户在屏幕上看到的尽可能接近的用户界面结构。