使用捕获 action

使用捕获 action 通过对象控件捕获单个交互(单击、击键或鼠标移动),包括文本框、按钮、表、菜单、单选按钮、组合框、复选框、列表视图、链接、树或页面选项卡。

先决条件

  • 要使用 Recorder,您必须已执行以下操作:
  • 当您使用双显示器时,请确保两个显示器的屏幕分辨率相同。
  • 确保屏幕分辨率设置为 1366x768。
  • 将设备显示和字体比例设置为 100%。

    如果您正在使用 Recorder package 2.0.6-20200626-193519 或更高版本,您可以在显示比例配置为 100% 或 125% 的计算机上录制 Google ChromeInternet ExplorerJava、Microsoft Active Accessibility 和 Microsoft UI 自动化应用程序的任务。

  • 如果您使用浏览器自动执行任务,请将缩放级别配置为 100%。

    如果您使用的是 Recorder package 2.0.6-20200626-193519 或更高版本,则可以在没有 100% 缩放级别设置的 Google Chrome 浏览器中录制任务。

  • 如果您使用 Google Chrome 浏览器自动执行任务,请确保启用与 Automation 360 内部版本对应的 Automation Anywhere 插件。

    Browser requirements for Automation Workspace

  • 要使用 Universal RecorderInternet Explorer 模式下自动化运行在 Microsoft Edge Chromium 浏览器上的网页应用程序,请确保启用了 Internet Explorer 兼容模式。 在网页应用程序中,使用 HTML 技术捕获对象。 要启用此模式,请执行以下步骤:
    1. Microsoft Edge Chromium 浏览器页面上,单击设置
    2. 在左侧窗格中,单击默认浏览器
    3. 导航到允许网站在 Internet Explorer 模式下重新加载选项,然后选择允许
    4. 单击添加以添加要在 Internet Explorer 模式下加载的页面 URL。
      注: 您添加的页面将在您添加页面之日起的 30 天内以 Internet Explorer 模式打开。
录制任务时的注意事项:
  • 尽可能使用单击,而不是快捷键。

    使用 Recorder 单击对象时,它会检索对象的属性,使 bot 能够在运行时识别对象。 键盘快捷键可靠性较低,因此请在无法通过单击对象自动执行任务时使用。

  • 如果您正在使用浏览器自动执行任务,请勿使用自动填充在字段中输入值。
  • 以低速录制任务。
  • 避免在录制过程中拖动窗口。
  • 避免单击不属于要录制和自动化的流程的应用程序。
  • 使用 Internet Explorer 时,在执行 action 之前,action 会等待直至浏览器完全渲染且处于就绪状态。

过程

要录制对象控件的单个交互,请执行以下步骤:

  1. 双击或拖动录制器 > 捕获
  2. 指定捕获对象的窗口。
    应用程序浏览器变量选项卡中选择。
    选项描述
    应用程序 从当前活动窗口的列表中选择。 此选项显示 Bot Creator 设备上打开的所有应用程序和浏览器窗口的列表。
    浏览器 从支持的浏览器选项卡列表中选择。
    注: 此选项支持 Google Chrome、基于 Chromium 的 Microsoft EdgeInternet Explorer 浏览器。 对于所有其他浏览器,请使用应用程序选项。
    变量 选择现有窗口变量以指定应用程序窗口标题。
  3. 可选: 窗口标题字段中插入通配符 (*),以搜索可以更改的窗口标题。 可以在值的开头、中间或结尾指定一个或多个通配符 (*)。
    例如,要对标题中包含 Microsoft 的任何窗口执行操作,请将通配符添加到值之前或之后来指示任何字符串:*Microsoft*bot 首先会搜索确切的窗口标题 (Microsoft),如果找不到匹配项,它会搜索标题中任何位置带有 Microsoft 一词的窗口。

    您可以使用正则表达式 (regex) 来标识窗口标题。 将每个正则表达式条件选择为字符串模式,然后输入值。 默认情况下,窗口标题字段区分大小写。

    要识别浏览器标题,您可以启用区分大小写选项以匹配字母大小写,或禁用该选项以识别字母大小写不匹配的窗口标题。
    注: 确保您系统上安装的最低 Bot Agent 版本是随 Automation 360 v.26 发布的版本。 如果存在随 Automation 360 v.25 或更早版本发布的 Bot Agent 版本,则默认情况下,将仅通过匹配字母大小写(区分大小写)识别窗口标题。
    例如,要匹配所有以单词开头、后跟 - Notepad 的窗口标题名称,您可以输入字符串* -Notepad,或者仅为与此模式匹配的窗口标题使用模式((\w)\s)*document-Notepad
    注:
    • 当您使用类型为字符串的正则表达式,并将 -title 作为任何 action 的窗口标题的输入值时,bot 可能会遇到运行时错误。 为了防止运行时错误,请确保在将字符串输入添加为 *-title 时,具有特定标题的应用程序已打开。 星号 (*) 只是一个字符,而不是通配符。
    • 当您使用类型为 Pattern 的正则表达式,并将 -title 作为任何 action 的窗口标题的输入值时,bot 可能会遇到运行时错误,因为输入值 *-title 是不正确的。

      请确保使用有效的正则表达式模式。

    注: 在运行时,验证 Task Bot 是否识别正确的窗口。 如果没有,请执行以下操作:
    1. 打开应用程序或浏览器窗口。
    2. 窗口 > 获取活动窗口标题 action 拖动到录制器 > 捕获 action 上方。
    3. 将字符串变量插入到将窗口标题分配给变量字段中。
    4. 窗口 > 设置标题 action 拖动到窗口 > 获取活动窗口标题 action 下方。
    5. 窗口字段中,插入由录制器 > 捕获 action 生成的窗口变量。
    6. 新建窗口标题字段中,从获取活动窗口标题 action 插入字符串变量。
    7. 单击保存
  4. 可选: 选择重设窗口大小选项以指定窗口尺寸。
    此选项可提供更可靠的 bot。 它根据录制任务的尺寸调整窗口的大小,这增强了 bot 识别目标对象的能力。
    • 如果在您录制任务时窗口最大化,则此选项处于取消选中状态。
    • 如果在录制任务时窗口未达到最大尺寸,则默认选择此选项,并且宽度和高度字段会自动填充窗口尺寸。
    注: 此选项仅适用于可以调整大小的窗口。 它不适用于桌面任务栏选项。
  5. 单击捕获对象
    选定窗口将出现。
  6. 将鼠标移动到要自动化的对象上,例如按钮、表单字段或表。
    对象周围会出现一个红色矩形框。
    注: 如果该框未显示,并且您正在 Google ChromeMicrosoft EdgeMozilla Firefox 浏览器中捕获,请验证您是否已为这些浏览器启用 Automation Anywhere 扩展程序。 请参阅 Google Chrome 浏览器扩展程序要求 查看 Google Chrome 浏览器。
  7. 单击对象。
  8. 查看对象属性表。
    下面是根据技术类型默认选择的对象属性列表:
    注: 您没有明确选择 Java 或 HTML 技术的选项。 当您在自动检测模式下捕获应用程序时,Recorder 会根据被捕获的应用程序自动检测技术。 当 Recorder 检测到特定技术时,技术类型会显示在对象属性中。
    重要信息: 下面的列表不包括所有属性,并仅限于从技术类型方面最常用和最重要的属性。
    技术类型 对象属性 描述
    HTML 技术 控制类型 这是一个只读属性,用于显示捕获对象的类型,例如文本框或按钮。
    DOMXPath 它是用来定位被捕获控件或对象的路径。 DOMXPath 可以有两种类型: 相对 Xpath 和绝对 XPath。
    • 绝对 Xpath: 它包含从根元素到所需元素的完整路径。 例如,此主题的绝对 Xpath 是 /html/body/div/div[1]/main/div[2]/div/div/div[2]/div/div/div[1]/div/article/main/article/div/p[1]
    • 相对 Xpath: 这是一个较短的路径,指向您要识别的元素。 相对路径开头为 // 符号。 例如,此主题的相对 Xpath 是 //*[@id="cloud-using-recorder-action"]/div/p[1]
    例如,如果您想在 Google Chrome 浏览器上找到某特定元素的 DOMXPath,请执行以下步骤:
    1. 选择您要为其提取 XPath 的元素。
    2. 右键单击该元素并选择检查
    3. 右键单击元素选项卡中突出显示的元素。
    4. 前往复制 > 复制 Xpath来复制相对路径,选择复制 > 复制完整 Xpath来复制绝对路径。
    路径 它是应用程序中特定控件位置的数字表示。 对于网页应用程序,最佳实践是使用搜索标准中的 DOMXPath,而不是 Path
    HTML 名称和 ID 这些属性用于识别 HTML 对象
    HTML 内部文本 DOM innerText 属性用于设置或返回指定节点及其子节点的文本内容
    HTML 标签 HTML 标签就像关键字一样,定义网页浏览器设置格式和显示内容的方式。 例如,如果捕获的文本有 HTML 代码: <h3 class="search_results-title">״string package״的搜索结果</h3>,则在 HTML 标签字段中输入 h3
    Microsoft Active Accessibility 控件类型 此属性仅作为参考,以确保捕获到正确的对象
    路径 它是应用程序中特定控件位置的数字表示
    名称 它指定元素的名称,并用作标识符
    ID 它指定元素的 ID,并用作标识符
    Java 技术 控件类型 此属性仅作为参考,以确保捕获到正确的对象
    路径 它是应用程序中特定控件位置的数字表示
    Microsoft UI 自动化 控制类型 此属性仅作为参考,以确保捕获到正确的对象
    路径 它是应用程序中特定控件位置的数字表示
    名称 它指定元素的名称,并用作标识符
    ID 它指定元素的 ID,并用作标识符
    IsFirst 此属性使 bot 能够根据您的搜索条件检测到第一个对象,而无需遍历整个树。 当对象没有唯一的自动化 ID 并且应用程序中的对象层次结构发生变化时,您可以使用此属性。
    Microsoft UI Automation (COM) 控件类型 此属性仅作为参考,以确保捕获到正确的对象。
    路径 它是应用程序中特定控件位置的数字表示。
    名称 它指定元素的名称,并用作标识符。
    ID 它指定元素的 ID,并用作标识符。
    bot 使用选定的属性来识别运行时的对象控件。
    1. 验证控件类型是否与预期对象匹配。
      例如,当从网站捕获表时,请确保控件类型HTML 标签值为 Table
      如果控件类型与预期对象不匹配,请重新捕获对象控件。
    2. 选择并分配值到您想包含在对象搜索中的对象属性。
      为获得更可靠的 bot,我们建议您只选择具有静态值的属性(如名称类型HTML IDDOMXPATH),并取消选择具有动态值的属性(如 HTML Href路径),这些是可以改变的主题且会导致 bot 错误。
      在对象属性值中使用通配符字符 (*) 或变量来搜索属性动态且经常变化的对象是一种最佳实践。
      注: SAP 技术目前不支持通配符字符匹配。 当您使用通配符执行 bot 时,它会精确匹配搜索条件中指定的属性值。
  9. 从下拉列表中选择操作
    有关按对象显示的完整可能 actions 列表,请参阅 对使用 Universal Recorder 捕获的对象执行的操作
    • 如果在控件类型密码文本的文本框中录制单击和击键,录制器不会捕获输入到该字段的按键。 相反,action 会选择设置文本选项,并提供安全输入密码的选项。 我们建议您将密码存储在 Credential Vault 中,并将其作为凭据插入 action

      请参阅 Bot editor 中的凭据和凭据变量

      如果您在 MSAA 或 SAP 应用程序中使用 TAB 键而不是单击导航到文本框,录制器能够识别具有控件类型密码文本的字段。

    • 如果所选操作支持后台处理,则会出现在后台运行选项。

      请参阅 后台处理

  10. 设置系统超时字段中,选择基本高级
    • 基本: 在等待系统响应(以秒为单位)字段中,指定 bot 必须在应用程序窗口中等待对象控件出现的秒数。 此等待时间包括页面加载和对象搜索的等待时间。

      我们建议在使用“设置文本” action 向文本字段输入击键时设置延迟时间。

      注:bot 指定的超时时间仅在控件所在的窗口存在时适用于等待控件出现在应用程序窗口上。 Recorder 首先查找应用程序窗口,然后才在该窗口内搜索对象。 默认的窗口搜索时间为 30 秒。 因此,即使您将等待时间指定为 5 秒,如果窗口不存在,它仍会默认等待 30 秒。

      我们建议您首先使用如果 > 窗口存在条件,指定等待时间为零秒,并确保应用程序窗口存在。 如果窗口存在,则使用 Recorder,指定等待时间为 5 秒,并运行 bot 来检测对象。

    • 高级: 使用此选项可以自动化那些不断加载和更新最新数据的网站,例如股票网站。 这些网站在技术上从未完全加载到屏幕上。 在此类情况下,bot 无需等待网页完全加载,可以在一定时间后直接进行网页自动化操作。

      等待浏览器响应(以秒为单位)字段中,指定 bot 必须等待浏览器加载的秒数。 选择以下选项之一:

      • 停止机器人并显示错误消息: 如果网页在指定的超时时间内未完全加载,请选择此选项以停止 bot 并显示错误消息。
      • 跳过并继续处理对象: 选择此选项以直接处理对象并捕获它,即使网页尚未完全加载。

      等待对象响应(以秒为单位)字段中,指定 bot 必须在应用程序窗口中等待对象控件出现的秒数。

  11. 可选: 将输出分配给变量。
    Control Room 会根据您在步骤 8 中选择的操作建议一个描述性的默认变量名称。 例如,如果您选择了获取属性,则建议的输出变量是 PropertyValue。 如果您创建多个输出变量,随后的变量名称会附加 -1 以避免重复。
  12. 单击保存
    捕获的图像不会作为依赖项添加,并且在您检查 bot 时不会显示在依赖项列表中。
将对象链接到支撑锚点
注: 您可以在 Microsoft Active Accessibility、Microsoft UI 自动化或 Java 应用程序中使用对象锚定。
在运行时,如果 bot 不能可靠地识别对象,就将它链接到附近的一个更容易让 bot 找到的对象(比如链接或按钮):
  1. 打开捕获 action
  2. 单击锚点选项卡。
  3. 单击捕获锚点

    浏览器或应用程序窗口将激活,主对象将突出显示(也就是您之前捕获的对象)。 将出现一个对话框,用于验证操作是否正确识别了主对象。

  4. 如果突出显示了正确的对象,则单击是,选择锚点

    否则,请单击不,我需要更正来选择正确的对象。

  5. 选择离目标对象较近且更容易让 bot 找到的对象。

    该对象将突出显示,且右侧有一个锚点图标。

  6. 单击保存