创建对象存储库

重要提示： 在启用了新式设计体验的项目中， 对象存储库 可与 UiPath.UIAutomation.Activities 或 MobileAutomation.Activities 包版本 20.10 及更高版本一起使用。

对象存储库是按应用程序、版本和屏幕分组的元素的集合，这些元素可以来自：

• 本地项目，即本地资源库。
• 库，即当前项目的用户界面库依赖项。

可以通过以下方式创建本地存储库：

• 使用“捕获元素”记录器捕获用户界面描述符；
• 手动创建，即直接在“对象存储库”面板中创建应用程序、屏幕和元素。

用户界面库可以通过以下方式创建：

• 将本地存储库从任何项目中提取到库项目中，并将其作为 NuGet 包发布。

• 从新建库开始，在那里建立存储库，然后将其作为 NuGet 包发布。

  然后，您可以使用用户界面库 NuGet 包并将它们作为依赖项添加到您的流程中。

  重要事项“捕获元素”记录器仅记录对象以供在项目中重用，该记录器不会在“设计器”面板中生成工作流。

通过捕获元素创建存储库

在库或流程中，单击“对象存储库”中的“捕获元素” 按钮，开始录制对象。

捕获元素录制器使用 UIAutomation.Activities 包（20.10 版及更高版本）中的统一目标技术来为每个选取器、图像或锚点捕获目标和锚点，同时确保一定的准确度。

捕获的用户界面元素带有“选取器”、“模糊选取器”和“图像”属性，同时可确保一定的准确度。您可以选择只保留一个或保留所有目标元素。同样的方法也适用于与应用程序中的每个用户界面元素相关联的锚点元素。

描述符属性

应从“捕获元素”记录器中为应用程序、屏幕和元素提供描述性名称，使其在“对象存储库”中易于识别。

元素类型

应用程序中的选取器可以表示按钮、复选框、文本字段、切换选项、列表框，以及可与机器人交互的任何类型的元素。可以从“捕获元素”记录器中定义捕获的元素。

从“类型”下拉列表中搜索并选取适合每个元素的类型。在“对象存储库”中，该元素会收到特定于其类型的图标，从而使对象更加容易区分。

捕获元素后，单击“将对象保存到库”按钮，将对象添加到“对象存储库”中。

备注：

• 若要添加其他元素，请右键单击存储库中的屏幕或元素，然后选择“创建元素”。要添加其他屏幕，只需右键单击应用程序，选择“创建屏幕”即可。
• 要直接在应用程序或屏幕下录制对象，请右键单击任何应用程序或屏幕，然后选择“捕获元素”。

从“对象存储库”面板创建存储库

您可以通过手动定义应用程序、每个屏幕和元素，在“对象存储库”面板中创建自己的存储库。

创建用户界面应用程序

在“对象存储库”面板中，单击“描述符”选项卡中的加号，或右键单击同一选项卡中的“项目描述符”，然后选择“创建应用程序”。“创建应用程序”窗口随即打开：

添加唯一的应用程序名称、版本和说明。单击“创建应用程序”。您的应用程序在“项目用户界面描述符”下的“描述符”选项卡中可见。

创建屏幕

在“描述符”选项卡中，选择您的应用程序，单击加号或右键单击您的应用程序，然后选择“创建屏幕”。“添加屏幕”窗口随即打开：

为屏幕添加唯一名称和说明。指示要自动化的屏幕，并使用“统一目标”编辑捕获的元素：

• 如果需要，请更改应用程序路径。

• 添加应用程序参数。

  完成后，单击“创建屏幕”。

创建用户界面元素

在“描述符”选项卡中，选择您的应用程序屏幕，单击加号或右键单击该屏幕，然后选择“创建元素”。“添加元素”窗口随即打开：

从“描述符类型”部分单击“指定元素”，以使用“统一目标”从屏幕中指定和捕获元素。

在“元素名称”字段中添加一个直观名称，然后从“类型”下的下拉列表中选择元素的类型。完成后单击“保存”。

备注：

• 要编辑对象存储库中的元素，请右键单击它，然后选择“编辑元素”，或双击树中的元素。
• 要编辑元素的描述符，请使用“编辑描述符”窗口中的“编辑描述符”选项，或右键单击树中的元素，然后选择“编辑描述符”。

使用对象存储库与录制器

如果在您的 Studio 实例中强制执行对象存储库（按照关于对象存储库页面中的说明），则在使用应用程序/网页录制器时，生成的活动不会自动引用存储库中的描述符。

在活动级别，内容丰富的工具提示会通知您将描述符添加到对象存储库或使用现有的描述符。

为此，请单击活动内的图标，然后按照添加或重用描述符的步骤进行操作，或选择"选项" >“添加到对象存储库”，将元素添加到对象存储库中。

将活动中的元素添加到存储库

创建对象存储库后，可以直接从“设计器”面板添加更多用户界面元素。

在“设计器”面板中添加支持选取器的活动，如“单击”或“输入信息”。确保添加的活动位于“使用应用程序/浏览器”活动中。

在活动主体中，单击“对象存储库”图标以打开“选取选项”窗口。捕获元素，选择“确认”，“将元素添加到对象存储库”窗口随即会打开。向元素添加名称，然后单击“保存”。请注意，该元素将添加到“对象存储库”面板中。

在当前项目中使用对象

在“对象存储库”中，将应用程序、屏幕或元素拖放到工作流中的活动之上。对象的图像、参数和其他详细信息将自动添加到活动中。

在下面的示例中，我们将 MyAppScreen 对象拖动到“使用应用程序/浏览器”活动之上。应用程序路径将自动添加到活动中。

或者，将一个对象拖到工作流内加号上面，以打开兼容活动的列表。选择活动，对象将自动添加。在流程内部，活动收到以下标签：活动名称和对象名称。

添加对象后，活动从对象存储库接收描述符属性，相关属性在活动的“属性”面板中可见。

• 要编辑描述符，请单击“属性”面板顶部的“ 显示 ”以转到“ 对象存储库 ”，您可以在其中使用“ 编辑描述符” 选项。

• 要删除活动和对象存储库之间的链接，请单击“属性”面板顶部的“取消链接”。强制执行对象存储库时，取消链接会将目标从活动中删除。

  
  

  

  
  

将对象添加到工作流后，“对象存储库”面板中的“用户界面活动”选项卡将按层级顺序显示活动及其包含的对象。如果它们不可见，请保存项目并再次查看。

标记工作流：

• 如果工作流文件中至少有一个活动从“对象”面板中引用了用户界面描述符，则使用灰色圆点进行标记。
• 如果工作流中的所有活动都引用了“对象”面板中的用户界面描述符，则使用蓝色圆点进行标记；

标记用户界面活动：

• 如果活动未从“对象”面板中引用用户界面描述符，则使用空心圆点进行标记。
• 如果活动从“对象”面板中引用了用户界面描述符，则使用蓝色圆点进行标记。

编辑描述符

可以在两种模式下从“对象存储库”中编辑描述符，我们将这两种模式称为“在线”和“离线”编辑：

• 在线编辑 - 应用程序或浏览器可以在当前计算机上访问。应用程序/浏览器显示在屏幕上，允许再次选择或修改元素。
• 离线编辑 - 当前计算机上无法访问应用程序或浏览器。应用程序未安装，或者计算机处于离线状态。元素的选取器可见，允许进行更改。

在线编辑

在“描述符”选项卡中，右键单击某个元素，然后选择“编辑描述符”。选取屏幕随即打开，您可在此屏幕中捕获其他元素、编辑选取器和锚点。

单击“编辑元素”窗口中的“编辑描述符”按钮可以实现相同的效果。

注意：在运行时，如果活动引用此类“用户界面描述符”，则从“对象存储库”面板解析“用户界面描述符”。

离线编辑

在线编辑步骤同样适用于此处。在“描述符”选项卡中，右键单击屏幕或元素，然后选择“编辑描述符”。

离线编辑提供直接对元素描述符设置进行更改的选项，但您不能指定新元素。为此，请确保应用程序/浏览器以正确的状态打开。

解析用户界面描述符

每当在“项目用户界面描述符”或“用户界面库”下指定已在“对象存储库”中引用的屏幕或“用户界面元素”时，系统都将自动检测匹配项，并弹出以下窗口：

可用的选项如下：

• 重用 - 将“对象存储库”中的匹配描述符添加到当前活动。
• 新建 - 打开选项窗口以创建新屏幕/元素或更新“对象存储库”中的现有屏幕/元素。
• 取消 - 将当前指定的选取器保留在活动内，而不对存储库中的对象进行任何更改。

指示屏幕搜索相应的用户界面描述符，同时指示目标元素搜索匹配的用户界面描述符。使用“录制器”时，系统将在项目用户界面描述符的本地用户界面库中或从用户界面库导入的依赖项中搜索屏幕和元素的相应匹配项。

注意：在运行时，如果活动引用此类“用户界面描述符”，则从“对象浏览器”面板解析“用户界面描述符”。

描述符中的变量

为了提高其可重用性，可以在描述符中使用变量。

您可以编辑目标，向其中添加变量，然后将其添加到对象存储库，或者可以将变量添加到现有屏幕或对象存储库中元素中的选取器。每当将包含变量的描述符添加到流程时，请确保在流程中创建变量，否则无法读取表达式。

要将变量添加到描述符选取器，请右键单击“对象存储库”中的元素，然后选择“编辑描述符”，然后从“选择选项”窗口中添加变量。

选取器中添加的变量必须用双大括号括起来。例如，如下图所示，<name='{{VarNumber}}'/> 将变量 VarNumber 的值添加到选取器中的 name 属性。

在下面的示例中，我们在“使用应用程序/浏览器”活动的“浏览器 URL”字段内使用了一个变量，然后将该目标作为屏幕对象添加到对象存储库中。这样，我们确保描述符说明了 URL 更改的情况。

高亮显示元素

在“对象存储库”面板中，右键单击屏幕或元素，然后选择“高亮显示”以突出显示应用程序内的元素，前提是应用程序在计算机上启动或浏览器中已打开网页。