使用 Universal Recorder 编辑录制的任务
- Updated: 2023/02/13
录制任务后,编辑捕获 actions 以更改窗口、捕获其他对象、选择新操作、启用后台处理、输入其他等待时间或将输出保存到变量。
先决条件
选择列表 视图以查看每个 action 的完整详细信息。
编辑录制的任务以执行以下操作:
- 更改您要在其中执行操作的应用程序窗口,或向窗口标题添加通配符。
- 更改捕获的对象的属性。
- 指定要在捕获的对象上执行的 action。
- 在下一个 action 执行之前引入延迟。
- 指定要用于存储输出的变量。
要将捕获 action 添加到任务,请参阅 使用捕获 action。
过程
要编辑已录制的任务,请执行以下步骤:
- 打开包含要编辑的录制的 bot 的 actions。
- 单击要编辑的捕获 action。
根据需要进行以下更改:
- 将窗口选项更改为当前活动窗口选项。
- 可选:
在窗口标题字段中插入通配符 (*),以搜索可以更改的窗口标题。 可以在值的开头、中间或结尾指定一个或多个通配符 (*)。
例如,要对标题中包含 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 是否识别正确的窗口。 如果没有,请执行以下操作:- 打开应用程序或浏览器窗口。
- 将窗口 > 获取活动窗口标题 action 拖动到录制器 > 捕获 action 上方。
- 将字符串变量插入到将窗口标题分配给变量字段中。
- 将窗口 > 设置标题 action 拖动到窗口 > 获取活动窗口标题 action 下方。
- 在窗口字段中,插入由录制器 > 捕获 action 生成的窗口变量。
- 在新建窗口标题字段中,从获取活动窗口标题 action 插入字符串变量。
- 单击保存。
- 可选:
选择重设窗口大小选项以指定窗口尺寸。
此选项可提供更可靠的 bot。 它根据录制任务的尺寸调整窗口的大小,这增强了 bot 识别目标对象的能力。
- 如果在您录制任务时窗口最大化,则此选项处于取消选中状态。
- 如果在录制任务时窗口未达到最大尺寸,则默认选择此选项,并且宽度和高度字段会自动填充窗口尺寸。
注: 此选项仅适用于可以调整大小的窗口。 它不适用于桌面或任务栏选项。 -
查看对象属性表。
下面是根据技术类型默认选择的对象属性列表:注: 您没有明确选择 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,请执行以下步骤:- 选择您要为其提取 XPath 的元素。
- 右键单击该元素并选择检查。
- 右键单击元素选项卡中突出显示的元素。
- 前往复制 > 复制 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 使用选定的属性来识别运行时的对象控件。-
验证控件类型是否与预期对象匹配。
例如,当从网站捕获表时,请确保控件类型和 HTML 标签值为 Table。如果控件类型与预期对象不匹配,请重新捕获对象控件。
-
选择并分配值到您想包含在对象搜索中的对象属性。
为获得更可靠的 bot,我们建议您只选择具有静态值的属性(如名称、类、类型、HTML ID 和 DOMXPATH),并取消选择具有动态值的属性(如 HTML Href、路径或值),这些是可以改变的主题且会导致 bot 错误。在对象属性值中使用通配符字符 (*) 或变量来搜索属性动态且经常变化的对象是一种最佳实践。注: SAP 技术目前不支持通配符字符匹配。 当您使用通配符执行 bot 时,它会精确匹配搜索条件中指定的属性值。
-
绝对 Xpath: 它包含从根元素到所需元素的完整路径。 例如,此主题的绝对 Xpath 是
-
从下拉列表中选择操作。
有关按对象显示的完整可能 actions 列表,请参阅 对使用 Universal Recorder 捕获的对象执行的操作。
- 如果您在控件类型为
密码文本
的文本框中录制单击和按键操作,录制器不会捕获输入到该字段的按键。 相反,action 会选择设置文本选项,并提供安全输入密码的选项。 我们建议您将密码存储在 Credential Vault 中,并将其作为凭据插入 action。 Bot editor 中的凭据和凭据变量如果您在 MSAA 或 SAP 应用程序中使用 TAB 按键而不是单击导航到文本框,录制器能够识别 控件类型为
密码文本
的字段。我们建议您使用设置文本 action,而不设置延迟时间在文本字段中输入按键。 然而,如果您要输入的文本包含控制键值或文本字段需要任何按键事件,在使用设置文本 action 时,必须在按键之间设置延迟时间。
- 如果所选操作支持后台处理,则会出现在后台运行选项。后台处理
- 如果您在控件类型为
- 可选: 在等待控件字段中输入一个值,以指定 bot 必须在应用程序窗口中等待对象控件出现的秒数。
- 可选:
将输出分配给变量。
Control Room 会根据您在步骤 8 中选择的操作建议一个描述性的默认变量名称。 例如,如果您选择了获取属性,则建议的输出变量是
PropertyValue
。 如果您创建多个输出变量,随后的变量名称会附加 -1 以避免重复。 - 为您希望在 bot 中编辑的另一个 actions 执行步骤 3 至 9。
- 单击保存。
注: 您可以在 Microsoft Active Accessibility、Microsoft UI 自动化或 Java 应用程序中使用对象锚定。
在运行时,如果 bot 不能可靠地识别对象,就将它链接到附近的一个更容易让 bot 找到的对象(比如链接或按钮):
- 打开捕获 action。
- 单击锚点选项卡。
- 单击捕获锚点。
浏览器或应用程序窗口将激活,主对象将突出显示(也就是您之前捕获的对象)。 将出现一个对话框,用于验证操作是否正确识别了主对象。
- 如果突出显示了正确的对象,则单击是,选择锚点。
否则,请单击不,我需要更正来选择正确的对象。
- 选择离目标对象较近且更容易让 bot 找到的对象。
该对象将突出显示,且右侧有一个锚点图标。
- 单击保存。