Recorder 包

录制器 package 将捕获进程中的一系列任务，然后将其自动化。 您可以使用 Recorder 捕捉在文本框、按钮、表、单选按钮、组合框和列表视图等应用程序对象上执行的 actions 以对您的业务应用程序（例如桌面、Web、SAP 和 Java 应用程序）实施自动化。

Automation 360 扩展程序设置

如果在使用 Recorder 自动处理在 Google Chrome 或 Microsoft Edge 浏览器上运行的静态页面时，bot 执行时间较长，请按照以下步骤在 Automation 360 扩展程序中启用设置：
  • 单击浏览器窗口右上角的扩展图标。
  • 单击 Automation 360 插件旁的垂直省略号，然后选择管理扩展。
  • 启用允许访问文件 URL 选项。
  • 重新启动浏览器并运行 bot。

使用 Recorder package 代替 SAP package 的好处

我们建议您使用 Recorder 自动运行 SAP 应用程序。 使用 Recorder 自动运行 SAP 应用程序时，将获得以下好处：
  • 可以在不创建会话的情况下自动化对象。 使用 SAP package 时，必须创建一个会话。
  • 可以直接自动化对象，而无需生成字段路径或事先了解字段路径。 使用 SAP package 时，如果搜索条件中的属性与 bot 在执行期间搜索的对象匹配，package 将直接在控制字段路径上执行 actions。
  • 如果 Recorder 运行时窗口与您要自动化的对象重叠，在您自动化该对象之前，Recorder 会隐藏运行时窗口。
  • Recorder 支持在 If、Loop 和 Wait packages 中执行操作，使您能够检查特定浏览器或窗口中是否存在对象。
注： 与 Recorder package 相比，SAP package 使您能够在不激活应用程序窗口的情况下自动化应用程序。

使用 Recorder 捕获

使用捕获 action 捕获与用户界面 (UI) 对象的交互。 此 action 使您能够在构建 bot 时添加单个交互。 请参阅 使用捕获 action
注：
  • 从 Version 11.3 开始捕获 action 将取代 Object Cloning 命令。
  • 如果使用与登录计算机时不同的用户账户启动任何受支持的浏览器或应用程序，Recorder 可能无法准确捕获和播放控件 actions。
  • 使用双显示器时，为了可靠捕获对象，请确保两个显示器的屏幕分辨率相同。
  • 当您将 Recorder package（版本 2.3.0-20210806-215200 或更早版本）与 Automation 360 v.29 发布的 Bot Agent（版本 21.250 或更高版本）一起使用时，可能会在捕获对象时遇到问题。 我们建议您使用 Recorder package（版本 2.4.0-20211118-080716 或更高版本）与 Bot Agent（版本 21.250 或更高版本）来成功捕获对象。
  • 当 Bot Agent 在用户级别安装时，即针对用户特定的安装类型，将不会配置 Citrix、Java 和 SAP，因为运行 Bot Agent 的会话可能没有所需的权限。 仅为当前用户配置 VMWare 插件。

在 Google Chrome 和 Microsoft Edge 浏览器上自动化网页时，如果目标对象在屏幕上可见，录制器 > 捕获 action 操作将不再向下滚动网页。 当网页上有固定的顶部窗格，而某些物理操作（例如鼠标单击）无法按预期运行时，该功能可改善用户体验和自动化的可靠性。

使用录制器 > 捕获 action 操作，当您的设备凭据以 UPN 格式输入时，可以成功自动运行对象。

当网页应用程序经常发生变化并且具有动态特性时，使用 Generative Recorder 实现自动化。 请参阅 Generative Recorder

macOS 平台上的 Safari 浏览器网页自动化

Recorder 支持在 Safari 浏览器上执行自动化，在 macOS 平台上提供基于对象的网页应用自动化。 由于 Safari 是 macOS 用户的默认浏览器，此功能将提升自动化的采用率和覆盖范围，使 macOS 用户能够实现网页应用的自动化。通过 Recorder，可以直接与 Safari 的网页元素（例如按钮、表单和链接）进行交互，无需第三方插件。

在 Safari 浏览器上执行自动化时：
  • 对象属性中的浏览器类型属性显示 Apple Safari。
  • 浏览器应用程序字段显示 Apple Safari。
  • 在录制期间，Safari 浏览器窗口会出现在窗口列表中，与 Google Chrome 和 Microsoft Edge 等其他浏览器组合显示。

macOS 支持的技术

在 macOS 平台上自动化时支持以下技术：
  • HTML 技术（Google Chrome 专用）
  • macOS 辅助功能技术
注： 不支持 Microsoft Active Accessibility (MSAA)、Microsoft UI Automation 和 Microsoft UI Automation (COM) 技术。

新的 macOS 辅助功能技术通过利用 macOS 内置的辅助功能，增强了自动化功能。 该技术允许录制器直接与 macOS 上应用程序的用户界面元素进行交互。 它可以执行创建自动化脚本所必需的操作，例如单击按钮、输入文本以及从屏幕读取数值。

此外，macOS 辅助技术支持广泛的 macOS 专用键盘输入，包括功能键和特殊按键组合，从而使您能够高效地创建、测试和部署自动化。

请参阅 ，查看录制器捕获的用于有效识别界面元素的属性列表。

手动配置 Silverlight 技术

将 Recorder package（版本 2.17.2 及更高版本）和随 Automation 360 v.31 发布的新 Bot Agent（版本 22.1.22）结合使用，将不再配置 Silverlight 技术。 如果您想配置 Silverlight 技术，请执行以下步骤手动运行 check.exe 文件。
注： 在运行之前，请确保将 check.exe 文件添加到允许列表中。
  1. 导航到 C:\ProgramData\AutomationAnywhere\GlobalCache\embedded-resources
  2. 搜索 ec0db824-25eb-4c57-ab44-f77ef67d2579。

    搜索结果显示 Recorder packages 的列表。

  3. 选择您使用的 Recorder package。
  4. 以管理员身份从该文件夹运行 check.exe 文件。
或者，您也可以执行以下步骤，从 Windows PowerShell 手动运行 check.exe 文件。
  1. 单击文件菜单。
  2. 导航到打开 Windows PowerShell > 以管理员身份打开 Windows PowerShell。

    打开 Windows PowerShell

  3. 在脚本中输入 .\Check.exe 并单击 Enter。
执行以下步骤以从命令提示符手动运行 check.exe 文件。
  1. 打开命令提示符并以管理员身份运行。
  2. 输入 C:\ProgramData\AutomationAnywhere\GlobalCache\embedded-resources\，然后输入您使用的 Recorder package 版本。
  3. 在脚本中输入 Check.exe 并单击 Enter。

支持的应用程序

可以在启用了 IE 模式的 Microsoft Edge Chromium 上自动运行以下应用程序：
  • Java 网页应用程序
  • 通过 Citrix Workspace 应用程序访问的应用程序。
  • Citrix Virtual Apps
    注： Citrix 虚拟应用程序和桌面版本 2303 已通过 Recorder package（版本 2.16.0-20231101-165457 及更高版本）的认证。
注：
  • 要准确捕获或自动执行 SAP 应用程序上的对象，我们建议您启用脚本。 如果未启用脚本，则在 bot 运行时窗口下方会显示以下提示消息：

    SAP 脚本已禁用： 请启用脚本，以进行更可靠的捕获

    如果不启用脚本，则 Recorder 会使用 MSAA 技术来捕获对象，而不是使用 SAP 技术。

  • 在自动化一个 Electron 应用程序时，Recorder 默认使用 Microsoft UI Automation (COM) 技术捕获应用程序上的特定控件。 这使您能够无缝自动化 Electron 应用程序，而无需使用特定技术重新捕获对象。
从添加背景和签名到轻松导航工具栏选项，您都可以可靠地自动控制 Adobe Acrobat PDF 阅读器。 在自动化时，Recorder 将在对文档执行任何操作之前自动启用 Adobe Acrobat 辅助功能。 在自动执行 Adobe Acrobat PDF 阅读器时支持以下技术：
  • Microsoft Active Accessibility (MSAA)
  • Microsoft UI Automation
  • Microsoft COM UI 自动化
要使用 COM UI 技术自动执行 PDF 文档，首先使用 MSAA 或 UI 自动化技术自动执行 PDF 元素，以启用 Adobe Acrobat 辅助功能。 然后，您可以使用 COM UI 自动化技术自动执行后续的 PDF 元素。

Citrix XenApp 支持

您可以从 Citrix XenApp 应用程序启动 Google Chrome 或 Microsoft Edge 浏览器窗口，从特定浏览器访问 Control Room，并自动处理其他作为 XenApp 运行的虚拟应用程序。 这使您能够在从同一系统部署和启动 Control Room 和业务应用程序作为虚拟应用程序时，实现可靠的基于对象的自动化。
注：
  • 确保在启动业务应用程序的同一台 Citrix XenApp 服务器上安装 Bot Agent。
  • 当您以 XenApp 启动 Control Room 时，不需要 Automation Anywhere remote agent for Citrix。
您还可以在 Citrix XenApp 环境中使用远程坐席，自动处理窗口标题中在 \Remote 后带有额外字符或包含 Remote 非英文文本的应用程序。 另外，启用了通配符 (*) 支持，以便在指定窗口标题时具有更高的灵活性。
注：
  • 使用旧版本 package 创建的自动化与新的远程坐席 3.5.2 版本完全兼容。 您可以继续运行您现有的自动化，无需进行任何更改。
  • 在将 package（版本 5.0.5-20250903-100026 或更高版本）与旧版远程坐席一起使用时，您的自动化将与旧版远程坐席保持完全相同的运行方式。

    这可确保不同 package 和远程坐席版本之间的兼容性，因此您可以放心更新，并保持一致的自动化性能。

您可以在 Citrix XenApp 环境中成功执行使用不同版本 Recorder package 的父和子 bots。
注： 要在 bot 中有效地使用和执行多个版本的 Recorder 包，请确保您的 bots（包括父和子）使用的是 Recorder package （版本 2.16.0-20231101-165457 及更高版本）。 使用较早版本可能不支持此功能，并可能在 Citrix 环境中的 bot 执行期间导致不一致或错误。

支持的控制类型

当您在 Google Chrome、Microsoft Edge Chromium 或 Mozilla Firefox 浏览器上自动化网页时，可以自动化以下控件类型：
  • 弹出窗口
  • 警示对话框
  • 确认对话框
  • 提示对话框
注： 当您想在网页上自动显示警报对话框时，我们建议您在录制器 > 捕获 action 之前添加延迟，因为有时，警报对话框会在应用程序窗口延迟后出现。

跨域支持

您可以在跨域 iFrame 内部捕获对象及实施自动化，该 iFrame 具有多个使用同一框架源的 iFrame，以及在运行时在 Google Chrome 和 Microsoft Edge Chromium 浏览器中动态加载的 iFrame。 在您捕获跨域 iFrame 内部的对象之后，默认情况下该框架的路径存储于 FrameDOMXPath 属性中。

使用 FrameDOMXPath 属性进行捕获

新的 FrameDOMXPath 属性标识了对象所在的框架。 您必须选择此属性来成功运行 bot 以对跨域 iFrame 中的对象实施自动化。
注：
  • 当您从搜索条件中选择 FrameDOMXPath 属性时，请不要更改此属性的值。
  • 如果从搜索条件中清除 FrameDOMPath 属性，则 Recorder 无法识别框架。
重要： 在 Google Chrome 浏览器中，您可以捕获跨域内部的对象并实施自动化，以及使用具有相同框架源的多个框架。

自动运行以管理员身份运行的应用程序

您可以通过从 Bot editor 中选择以管理员权限捕获并运行选项，捕获以管理员身份运行的应用程序上的对象。

在以管理员用户身份自动化应用程序之前，请确保以下事项：
  • Bot Agent 安装在系统配置文件中。
  • Bot Creators 和 Bot Runners 在设备上拥有管理员权限以自动化应用程序。
当您在 Bot editor 中选择开始录制选项以录制多个应用程序，并在提升和非提升模式下切换应用程序时，bot可能无法识别模式之间的变化。 在这种情况下，对于在提升模式下的应用程序的所有捕获，选择以管理员权限捕获并运行选项，然后重新捕获对象。
注： 提升模式允许您以管理员身份运行应用程序。
重要： 当您尝试使用提升模式下的 Recorder 自动化任何未提升的 Java 或 SAP 应用程序时，bot 会遇到错误。

要避免此错误，请从 Bot editor 取消选择以管理员权限捕获并运行选项，然后在非提升模式下运行 Recorder 以捕获 Java 或 SAP 应用程序。

自动运行需要多用户访问的应用程序

现在可以在同一自动化工作流中成功自动化运行于同一用户会话的浏览器应用程序，但需要不同应用程序级别的访问权限。 例如，非管理员用户可以执行创建和验证记录操作，而管理员用户现在可以在相同的流程自动化中提供批准。
注：
  • 此功能支持自动化在 Google Chrome、Microsoft Edge 和带 IE 模式浏览器的 Microsoft Edge 上运行的网页应用程序。
  • 此功能支持 Recorder package（版本 3.2.1-20240606-105427 及更高版本）和 Bot Agent（版本 22.60.23 及更高版本）。
  • 在自动化使用其他用户权限打开的浏览器应用程序时，确保在提升模式下捕获和运行自动化。
  • 更新 Bot Agent 后，必须重新启动浏览器应用程序。
  • 目前不支持高级超时选项。

自动运行 Chromium Embedded Framework (CEF) 桌面应用程序

开发人员在其桌面应用程序中使用嵌入式 Chromium 浏览器，以添加网页浏览器功能。Recorder 支持此类桌面应用程序的基于对象的自动化，确保增加自动化覆盖范围。

Recorder 将这些 CEF 桌面应用程序检测为 HTML 技术。

重要： 要自动化使用 CEF 框架的桌面应用程序，您必须在提升模式下开发和运行自动化程序。 请参阅 自动运行以管理员身份运行的应用程序。

要在桌面 CEF 应用程序中运行 JavaScript 代码段或调用 JavaScript 函数，请参阅 运行 JavaScript action | 调用 JavaScript 函数 action。

重要： 此功能在 Recorder 软件包 版本 3.5.0-20241129-105732 及更高版本中可用。
支持性
  • 支持所有现有的 HTML 控件及其对应的 actions。
  • 支持使用 CEF Sharp 库和 WinForms 开发的 CEF 应用程序。
  • 支持跨域 IFrame。
  • 支持使用 CSS 选择器识别元素。 请参阅 Automate web apps that use the shadow DOM standard。
已知行为
  • 目前不支持 32 位 CEF 应用程序。
  • 目前不支持使用 WPF 和 .NET Core 开发的 CEF 应用程序。
  • 不支持在单个 CEF 应用程序中自动运行多个浏览器控件。
  • 不支持使用 Generative Recorder 自动运行基于 CEF 的应用程序。
  • 目前不支持 CEF 应用程序的高级超时选项。
  • 不支持自动化使用影子 DOM 标准的网页应用程序。

自动运行 Java 应用程序

在自动运行具有相似属性的 Java 应用程序控件时，例如 Oracle EBS 应用程序，路径属性会发生显著变化，因此不可靠。 要在这种情况下可靠地自动运行控件，请使用 Occurrence 对象属性。

使用 Occurrence 属性时，将检测到具有相似属性的控件，并按照从上到下、从左到右的格式排列，并检测到基于 occurrence 值的特定控件。
注：
  • Occurrence 属性不是默认搜索条件的一部分。
  • 仅在运行时获取 Occurrence 属性，而不是在捕获时获取。
  • Occurrence 属性的最大值将取决于屏幕上可见的相似控件的数量。 例如，如果屏幕上显示了 15 个 Description 类型的控件，则出现的最大值将是 15。 即使您在屏幕上滚动控件，出现的最大值仍将保持为 15。
  • 出现值的范围从 1 到 999。
可以使用 Frame name 属性，通过定位对象所在的特定框架自动运行控件。 这提高了自动化的性能和可靠性。
注：
  • 如果内部框架中的特定控件的框架名称为空，则捕获对象的框架名称属性将显示为空白，并且不会作为默认搜索条件添加。
  • 如果对象不在内部框架内，则该属性将不会出现在列表中。
  • 框架名称属性支持通配符和变量。
  • 我们建议您使用通配符 (*) 字符来识别内部框架对象，因为某些窗口的框架名称可能会更改。
注：
  • 对于您现有的自动化流程，如果您想使用新属性，请确保重新捕获控件。
  • 请注意，此功能对现有 bots 没有影响，将继续无变化地运行。

对象属性

当您选择要捕获的对象时，Universal Recorder 会收集对象属性上的数据，以便在运行期间识别对象。 您可以使用对象属性执行以下操作：
  • 验证捕获的对象属性是否与预期对象匹配。

    例如，当从网站捕获表时，请确保控件类型和 HTML 标签值为 TABLE。

    控件类型表的属性

  • 检索属性值。 使用获取属性 action 并在 属性名称字段中输入属性名称或从可用属性列表中选择一个对象属性。 列表中包含对象属性表中搜索条件的建议属性名称。 要从属性列表中选择对象属性，请将鼠标指针移动到属性名称字段的右侧并单击箭头。

    例如，要检索链接的文本，请使用获取属性 action 并在属性名称字段中输入 HTML InnerText，或从属性列表中选择 HTML InnerText。

  • 您可以选择 bot 的属性组合，在您的业务应用程序窗口中唯一地搜索对象。

TOP 对象属性

当您想要使用单击、右击、双击、设置文本或获取属性 actions 时，可使用顶部对象属性。

顶部对象属性如何显示数据的示例

在设计时，通过从 DOM 区域的顶部 (3) 和左侧 (1) 计算文档点，确定元素的位置。 例如，当您捕获 Last Name 元素时，TOP 属性值将记录为 131，该值从 DOM 的顶部 (3) 计算得出。 但是，在运行时，此 Last Name 元素的 TOP 属性值显示为 216。 出现这种差异的原因是，在运行时，扩展程序会根据导航栏 (2) 而不是 DOM 顶部 (3) 计算元素的位置。

搜索算法

Recorder package 的搜索算法将确保，当您运行 bot 时，只有在对象的属性与您在对象属性表中选择的精确搜索条件相匹配的情况下，该对象才会被捕获。 如果该对象的属性与搜索条件不完全匹配，那么该 bot 将会失败并显示错误消息。 然而，如果搜索条件包括一个通配符，那么 bot 将捕获符合该条件的第一个对象。

例如，要从带有三个文本框（文本框的名称分别为 firstname1、firstname2 和 firstname3）的应用程序中捕捉一个文本框，如果您选择 HTML 名称作为搜索条件，然后在 HTML 名称字段中输入 firstname，并运行 bot，那么该 bot 就会失败并显示错误消息，因为并不存在一个带有 HTML 名称为 firstname 的文本框。 然而，如果您在 HTML 名称字段中输入 firstname*，并运行 bot，那么该 bot 将捕获第一个符合条件的文本框。

注： 此功能适用于您使用从 Automation 360 v.23 开始的 Recorder package 2.4.0-20211016-070100 版本（及以后版本）创建的机器人。 如果您使用以前版本的 Recorder package 创建 bots，则必须重新捕获对象才能使用此功能。

对捕获的对象执行的操作

捕获对象后，指定运行期间 bot 要对对象执行的操作。 例如，当您捕获超链接时，您可以选择单击链接或检索链接文本。 要查看所有对象和可能操作的表格，请参阅 对使用 Universal Recorder 捕获的对象执行的操作。
注： 如果在运行从 bot 捕获对象的 Internet Explorer 时遇到错误，且错误信息与 Google Chrome 有关，请参见 Your Chrome Plug-in is either not installed or disabled (A-People login required)。

后台处理

后台处理可让涉及在前台与应用程序互动的自动化（如鼠标单击）在后台运行。 我们建议您使用该选项以在后台运行，从而增加目标对象的可见性并提高 bot 准确性。 以下 actions 支持后台处理：
  • 单击
  • 设置文本
  • 获取文本

安全记录

启用安全录制模式后，bots 不会在捕获后显示目标对象图像。 这可确保敏感数据不会显示。
注： 虽然 bots 不会在捕获后显示目标图像，但图像仍然存储在 Control Room，因为它们是运行 bots 所必需的。

在安全记录模式下录制任务时，预览窗口会临时显示捕获区域的图像。 此图像在您离开 Bot editor 窗口浏览或刷新时隐藏。

对于新的自动化，当您在安全录制模式下捕获对象时，可通过启用保存时自动删除未使用的对象属性选项，来选择自动删除未使用对象属性的值。 当您启用此选项时，不属于搜索条件的对象属性值将在您保存和刷新自动化时被丢弃。 这确保了个人身份信息 (PII) 不会被意外存储在自动化中。 有关如何启用安全录制设置的更多信息，请参阅 安全记录。
注： 如果您使用 Generative Recorder 自动运行任务，并且启用了保存时自动删除未使用的对象属性选项，则不支持生成式 AI 回退。
注：
  • 此功能支持 Recorder package（版本 3.2.1-20240606-105427 及更高版本）和 Bot Agent（版本 22.60.23 及更高版本）。
  • 如果您想在现有的自动化中使用此选项，必须重新捕获控件。
  • 左、右、高度和宽度属性的值将不会被丢弃。

具有管理员权限的用户必须启用此设置。 请参阅 配置设置。

代理支持

如果您的设备配置了代理，则来自此 package 的所有出站请求将通过代理服务器路由。 请参阅 使用代理将 Bot Agent 连接到设备。

关于如何使用录制器的场景

使用这些示例任务来熟悉在构建 bots 中是如何使用录制器的。