IA-Connect Java

IA-Connect 是一个机器人过程自动化(RPA)平台,可将 RPA 功能从云添加到本地虚拟机,或通过 Citrix 或Microsoft远程桌面(RDS)连接。 这是使用 Java 访问桥(JAB)自动执行 Java 应用程序的模块。

此连接器在以下产品和区域中可用:

服务 Class 区域
Copilot Studio 高级 除以下各项外的所有 Power Automate 区域
     - 美国政府 (GCC)
     - 美国政府 (GCC High)
     - 由世纪互联运营的中国云
     - 美国国防部(DoD)
逻辑应用程序 标准 除以下各项外的所有 逻辑应用区域
     - Azure 政府区域
     - Azure 中国区域
     - 美国国防部(DoD)
Power Apps 高级 除以下各项外的所有 Power Apps 区域
     - 美国政府 (GCC)
     - 美国政府 (GCC High)
     - 由世纪互联运营的中国云
     - 美国国防部(DoD)
Power Automate 高级 除以下各项外的所有 Power Automate 区域
     - 美国政府 (GCC)
     - 美国政府 (GCC High)
     - 由世纪互联运营的中国云
     - 美国国防部(DoD)
联系人​​
Name Ultima Labs
URL https://www.ultima.com/ultima-labs
Email IAConnect@ultima.com
连接器元数据
发布者 Ultima Labs
网站 https://www.ultima.com/ultima-labs
隐私策略 https://www.ultima.com/privacy-policy
类别 IT作;生产力

IA-Connect 是一个机器人过程自动化(RPA)平台,可将 RPA 功能从 Power Automate 云流添加到本地虚拟机或通过 Citrix 或Microsoft远程桌面(RDS)连接。 IA-Connect 连接器提供 650 多个作,使你可以直接从 Power Automate 云流自动执行每种类型的本地应用程序。 所有 IA-Connect作都可以直接从 Power Automate Cloud Flow 获取,可在基于云的应用程序与本地应用程序之间轻松集成,从而利用 RPA 进程中现有的 Power Automate 条件、循环、动态内容、表达式和异常处理。 利用 IA-Connect 连接器还提供流运行历史记录的完整执行历史记录和可审核性,同时无需使用单独的应用程序/控制台/工作室来开发 RPA 进程。

先决条件

若要使用任何 IA-Connect 连接器,必须安装 IA-Connect 软件。 这可以免费测试 30 天,之后需要 IA-Connect 许可证。

IA-Connect 软件由两个主要组件组成:

  • IA-Connect Orchestrator,它是一个可在自己的 Azure 租户中托管的 Azure WebApp。 这会处理 RPA 流到一个或多个本地或基于云的虚拟机的路由和安全性。

  • IA-Connect 代理和控制器,安装在要自动执行的软件可访问的虚拟机上。 此外,IA-Connect 代理可以在 Citrix 或 Microsoft 远程桌面服务 (RDS) 会话中运行,其中 RPA 命令将虚拟通道传递到远程会话以供执行。 IA-Connect 代理可以从网络共享运行,不需要安装。

可用的 IA-Connect 连接器

可用的 IA-Connect 连接器包括:

  • IA-Connect 动态代码
  • IA-Connect Java
  • IA-Connect 大型机
  • office IA-Connect Microsoft
  • IA-Connect SAP GUI
  • IA-Connect 会话
  • IA-Connect UI
  • IA-Connect Web 浏览器

如何获取凭据

若要接收许可证并开始 30 天的免费试用,请在我们的网站上提交请求(https://www.ultima.com/IA-Connect/Power-Automate)。

收到试用请求后,我们将通过提供的电子邮件地址与你联系,以帮助设置 IA-Connect 软件并提供试用许可证。 这是一个功能齐全的试用版,可让你在试用期内在所有 8 个 IA-Connect 连接器中测试所有 650 个作中的任意一个。

连接器入门

提交 IA-Connect 的试用请求后,你将能够下载包含 IA-Connect 软件和涵盖安装和设置的文档的 ZIP 文件。 我们还将与你联系,根据需要通过安装过程提供支持和指导。

Support

在试用期内,可以联系 Ultima Labs (IAConnect@ultima.com)获取支持和帮助。

购买 IA-Connect 许可证后,将收到支持令牌,这些令牌可以兑换为来自 Ultima 的英国技术服务中心(TSC)的定制培训或支持。

已知问题、常见错误和常见问题解答

我们的知识库包含许多文章,这些文章涵盖了任何已知问题、使用 IA-Connect 连接器和常见问题时可能发生的常见错误。 可在 IA-Connect https://support.ultima.com/ultimalabs 试用期间以及购买 IA-Connect 许可证时访问这些资源的帐户访问。

正在创建连接

连接器支持以下身份验证类型:

默认 用于创建连接的参数。 所有区域 不可共享

违约

适用:所有区域

用于创建连接的参数。

这是不可共享的连接。 如果 Power App 与另一个用户共享,系统会提示其他用户显式创建新连接。

Name 类型 Description 必选
API 密钥 securestring 此 API 的 API 密钥 True
IA-Connect Orchestrator 地址 字符串 指定不带 HTTP(S) 组件的 IA-Connect 业务流程协调程序地址 True

限制

名称 调用 续订期
每个连接的 API 调用数 100 60 秒

操作

Focus Java 元素

聚焦一个 Java 元素,该元素使其成为键盘焦点的活动元素,并且根据应用程序,可能会将元素窗口引入前台。

Java 元素中的全局输入密码

将鼠标移动到 Java 元素的中心,将鼠标焦点放在它、左键和按下键。 通常用于不接受本机 UIA 输入方法的密码输入。

Java 元素是否处理相同

比较 Java 元素的两个 Java 元素句柄,以查看它们是否表示相同的 Java 对象。 如果已标识元素并检索到其父元素的句柄,则这非常有用。

Java 元素是否存在

报告 Java 元素是否存在并返回一些基本元素属性。

Java 桌面元素是否存在

报告 Java 桌面元素是否存在并提供一些基本元素属性。

从元素句柄获取 Java 角色 CSV

以 CSV 形式返回指定元素句柄下方的元素角色树。 此作仅用于开发目的,并提供应用程序的元素概述,这些元素可用于可视化应用程序结构和优化元素搜索。

从元素搜索获取 Java 角色 CSV

执行 Java 元素搜索,并将搜索的元素的详细信息(最多输出到找到元素的点)作为 CSV。 此作仅用于开发目的,并提供应用程序的元素概述,这些元素可用于可视化应用程序结构和优化元素搜索。

以列表的形式获取 Java 元素属性

返回 Java 元素的属性作为单行列表(单行集合/数据表),而不是单个项,这也许很有用,具体取决于你打算如何使用数据。

全局中间鼠标单击 Java 元素

将鼠标移动到 Java 元素的中心,然后单击中间鼠标按钮。

全局双鼠标左键单击 Java 元素

将鼠标移动到 Java 元素的中心,然后双击鼠标左键。

全局鼠标单击 Java 表单元格

将鼠标移动到 Java 表格单元格的中心,然后单击指定的鼠标按钮。

全局鼠标右键单击 Java 元素

将鼠标移动到 Java 元素的中心,然后单击鼠标右键。

全局鼠标左键单击 Java 元素

将鼠标移动到 Java 元素的中心,然后单击鼠标左键。

围绕 Java 元素绘制矩形

在 Java 元素的外围周围绘制一个矩形,以帮助确定找到的元素是必需的。 矩形在 5 秒后自动删除。

在 Java 元素中输入密码

将密码输入 Java 元素(通常是密码输入字段),替换现有文本。

在屏幕坐标处为 Java 元素创建句柄

通过提供屏幕坐标来创建 Java 元素的句柄。 如果 Java 元素存在于指定坐标处,该作将标识该元素并返回该元素的句柄。

在屏幕坐标处获取 Java 表单元格

如果作为表的子元素的 Java 表单元格存在于指定的坐标处,此作将标识元素及其属性,并选择性地返回表单元格元素的句柄。

对 Java 元素执行作

执行 Java 元素的可访问作。 可以使用“获取 Java 元素的作”作来查询特定元素的这些可访问作。 对于文本元素,一些常见作是按钮的“click”或“select-all”。

将全局输入文本写入 Java 元素

将鼠标移动到 Java 元素的中心,将鼠标焦点放在它、左键和按下键。 通常用于不接受本机 UIA 输入法的文本输入。

将文本输入 Java 元素

将文本输入 Java 元素(通常是文本输入字段),要么替换现有文本,要么将新值插入到特定位置。

屏幕上可见的 Java 表单元格

返回 Java 表元素中的特定表单元格当前是否在屏幕上可见。

展开 Java 选择元素

展开或折叠 Java 元素(通常是菜单/下拉列表项)。 如果项已展开,则不会发生任何作。

按 Java 元素

按 Java 元素(通常是按钮)。

按名称获取 Java 选择状态

通过提供子元素名称返回所选内容(通常是列表或下拉列表中的项)中的子元素的选择状态。 可以使用作“获取 Java 选择元素项”检索所有选择子元素项来检查其名称。

按名称选择 Java 列表元素

选择具有指定名称的列表元素。 这通常用于在下拉菜单/菜单项中选择项。

按索引获取 Java 选择状态

通过提供子元素索引返回所选内容(通常是列表或下拉列表中的项)中的子元素的选择状态。 可以使用作“获取 Java 选择元素项”检索所有选择子元素项来检查其索引。

按索引选择 Java 列表元素

选择与指定索引匹配的列表元素。 这通常用于在下拉菜单/菜单项中选择项。

断开与 Java 访问网桥的连接

关闭任何运行 IA-Connect Java 子系统(IA-JavaAccessBridge)。

是 Java 窗口

返回 UIA 窗口是否为 Java 元素。

检查 Java 元素

将元素(通常是复选框或单选框)的状态设置为选中或未选中。

等待 Java 元素

等待 Java 元素(通常是窗口内的单个元素(如按钮或文本输入区域)存在。

等待 Java 元素不存在

等待 Java 元素(通常是窗口内的单个元素(如按钮或文本输入区域)不再存在。

等待 Java 桌面元素

等待 Java 桌面元素(通常是窗口)存在。

等待 Java 桌面元素不存在

等待 Java 桌面元素(通常是窗口)不再存在。

获取 Java 元素值

返回元素的值。 值通常与文本输入区域相关联,但许多元素可以具有此属性。

获取 Java 元素属性

返回 Java 元素的所有 Java 属性。 如果不确定哪些字段包含所需的属性值,这可能很有用。

获取 Java 元素文本值

返回 Java 元素的文本值。 文本值通常与文本元素相关联,但许多元素可以具有此属性。

获取 Java 元素的作

返回 Java 元素的可访问作。 然后,可以使用作名称作为作“对 Java 元素执行作”的作(例如“click”或“select-all”)的输入,对元素执行这些可访问作。

获取 Java 元素的可见边界矩形

检索 Java 元素的可见边界。 通常,Java Access Bridge 将返回元素的虚拟位置值,无论该元素在屏幕上是否可见,这些虚拟值都由“获取 Java 元素属性”作提供。 对于较大的元素(例如可滚动的表元素),因为这些元素可能并不总是在屏幕上可见,此作将返回元素当前可见区域的坐标。

获取 Java 子元素属性

返回由索引指定的特定 Java 子元素的所有属性。 如果不确定哪些字段包含所需的属性值,这可能很有用。

获取 Java 桌面元素

返回桌面上的 Java 应用程序窗口和对话框的列表。 必须首先连接到 Java 访问桥。

获取 Java 父元素属性

返回 Java 元素的父元素的属性。 此作将仅返回直接父元素的属性,并且不会搜索元素树的整个高度。

获取 Java 表内容

返回 Java 表元素的内容。 这是包含行、列、标题和单元格(即表)的元素。

获取 Java 表单元格属性

返回 Java 表元素中指定单元格的属性和内容。 这是包含行、列、标题和单元格(即表)的元素。 可以选择性地指定是否通过枚举视区来确定单元格当前在屏幕上是否可见,以及该单元格是否为坐标。 视区元素通常包含表(例如它是表的父元素),并表示表的可见区域。

获取 Java 表属性

返回 Java 表元素的属性。 这是包含行、列、标题和单元格(即表)的元素。 可以选择通过枚举视区来确定表的哪些组件当前在屏幕上可见。 视区元素通常包含表(例如它是表的父元素),并表示表的可见区域。

获取 Java 选择元素项

返回在指定 Java 选择元素下找到的所有子选择元素项。 可以选择通过循环选择、选择列表中的每个单独选项或读取所选内容的子元素的标签来检索选择元素选项。 如果选择通过读取所选内容的子元素的标签来检索选择元素选项,则可能需要先通过将“Expand first”参数作为“True”来展开所选内容,然后还可以选择关闭所选内容,同时提供“Collapse after”参数作为“True”。

获取 UIA 元素的 Java 属性

返回 UIA 元素的所有 Java 属性。 如果不确定哪些字段包含所需的属性值,这可能很有用。

获取 Windows 访问网桥信息

返回有关特定 Java VM ID(包括 Java 和 Windows DLL 版本)的 Windows 访问桥(WAB)的信息。 Java VM ID 可以作为“获取 Java 元素属性”作的输出获取。

获取 Windows 访问网桥连接状态

返回 IA-Connect 代理与 Windows 访问网桥(WAB)之间的连接的当前状态。 如果 IA-Connect 代理连接到 WAB,则相关详细信息将作为输出返回。

获取多个 Java 父元素属性

返回 Java 元素的所有父元素的属性。 如果“要处理的最大父级”参数设置得足够高,此作将搜索返回所有父属性的元素树的整个高度。

获取所有 Java 子元素属性

返回所有 Java 子元素的所有属性。 如果不确定哪些字段包含所需的属性值,这可能很有用。

连接到 Java 访问网桥

启动 IA-Connect Java 子系统(IA-JavaAccessBridge),并将其连接到指定的 Java 访问桥 DLL(或留空搜索一个)。 必须先执行此步骤,然后才能自动执行 Java 应用程序。 此作还启用必须在运行任何 Java 应用程序之前启用的 Java 访问桥。

重置所有 Java 元素句柄

重置当前由 IA-Connect 存储的所有 Java 元素句柄,如果已识别大量元素并存储了大量元素句柄,这非常有用。 在元素句柄数非常高(100,000+)的情况下,此作还可用于释放 RAM 使用情况。

Focus Java 元素

聚焦一个 Java 元素,该元素使其成为键盘焦点的活动元素,并且根据应用程序,可能会将元素窗口引入前台。

参数

名称 密钥 必需 类型 说明
父元素 JAB 句柄
SearchParentElementJABHandle True integer

Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。

搜索 Java 元素名称
SearchElementJABName string

要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。

搜索 Java 元素说明
SearchElementJABDescription string

要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。

搜索 Java 元素角色
SearchElementJABRole string

要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。

搜索子元素
SearchSubTree boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

最大相对深度
MaxRelativeDepth integer

要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。

匹配索引
MatchIndex integer

如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。

搜索筛选器
SearchFilter string

可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。

按列名称排序
SortByColumn string

如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。

匹配索引升序
MatchIndexAscending boolean

如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。

区分大小写的搜索
CaseSensitiveSearch boolean

元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。

仅搜索可见元素
OnlySearchVisibleElements boolean

是否应只搜索可见元素? 默认情况下,此值设置为 true。

仅显示元素的搜索
OnlySearchShowingElements boolean

是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。

不遍历的元素角色
ElementRolesNotToTraverse string

一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

要搜索的最大元素数
MaximumElementsToSearch integer

查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

每个节点要搜索的最大子元素数
MaximumChildElementsToSearchPerNode integer

查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

Java 元素中的全局输入密码

将鼠标移动到 Java 元素的中心,将鼠标焦点放在它、左键和按下键。 通常用于不接受本机 UIA 输入方法的密码输入。

参数

名称 密钥 必需 类型 说明
父元素 JAB 句柄
SearchParentElementJABHandle True integer

Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。

搜索 Java 元素名称
SearchElementJABName string

要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。

搜索 Java 元素说明
SearchElementJABDescription string

要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。

搜索 Java 元素角色
SearchElementJABRole string

要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。

搜索子元素
SearchSubTree boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

最大相对深度
MaxRelativeDepth integer

要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。

匹配索引
MatchIndex integer

如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。

搜索筛选器
SearchFilter string

可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。

按列名称排序
SortByColumn string

如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。

匹配索引升序
MatchIndexAscending boolean

如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。

区分大小写的搜索
CaseSensitiveSearch boolean

元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。

仅搜索可见元素
OnlySearchVisibleElements boolean

是否应只搜索可见元素? 默认情况下,此值设置为 true。

仅显示元素的搜索
OnlySearchShowingElements boolean

是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。

不遍历的元素角色
ElementRolesNotToTraverse string

一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

要搜索的最大元素数
MaximumElementsToSearch integer

查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

每个节点要搜索的最大子元素数
MaximumChildElementsToSearchPerNode integer

查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

Focus 元素首先
FocusElement boolean

是否应 IA-Connect 尝试在全局单击之前聚焦元素?

全局鼠标左键单击元素
GlobalMouseClickOnElement boolean

在输入文本之前,是否应在元素坐标(以聚焦元素)处执行全局鼠标单击?

使用双击删除鼠标替换现有值
ReplaceExistingValueUsingDoubleClickDelete boolean

是否应通过双击鼠标(突出显示它),然后删除来替换任何现有值?

使用 CTRL-A delete 替换现有值
ReplaceExistingValueUsingCTRLADelete boolean

是否应按 Ctrl-A 替换任何现有值(要突出显示所有值),然后删除? 某些元素可能不支持使用 Ctrl-A 突出显示,在这种情况下,应尝试“使用双击删除替换现有值”的替代选项。

输入密码
PasswordToInput True password

全局输入的密码值。

使用发送密钥事件
SendKeyEvents boolean

如果设置为 true,则将使用将模拟击键发送到作系统的较低级别的 API。 如果设置为 false,则会改用将击键发送到焦点元素的更高级别的 API。

密钥间隔(以毫秒为单位)
KeyIntervalInMilliseconds integer

每个按键之间的毫秒数。

双击间隔(以毫秒为单位)
DoubleClickIntervalInMilliseconds integer

如果参数“使用双击删除替换现有值”设置为 true,则每次单击之间的毫秒数。

不解释符号
DontInterpretSymbols boolean

“输入密码”中的符号是否不应解释为特殊键(例如+ 用于 Shift、^ for Ctrl)? 如果尝试输入实际符号,则应将其设置为 true。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

Java 元素是否处理相同

比较 Java 元素的两个 Java 元素句柄,以查看它们是否表示相同的 Java 对象。 如果已标识元素并检索到其父元素的句柄,则这非常有用。

参数

名称 密钥 必需 类型 说明
元素 1 JAB 句柄
Element1JABHandle True integer

要比较的第一个元素句柄。

元素 2 JAB 句柄
Element2JABHandle True integer

要比较的第二个元素句柄。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

返回

名称 路径 类型 说明
同一对象
SameObject boolean

如果两个元素句柄都用于同一 Java 对象,则返回 true;如果元素句柄适用于不同的 Java 对象,则返回 false。

Java 元素是否存在

报告 Java 元素是否存在并返回一些基本元素属性。

参数

名称 密钥 必需 类型 说明
父元素 JAB 句柄
SearchParentElementJABHandle True integer

Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。

搜索 Java 元素名称
SearchElementJABName string

要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。

搜索 Java 元素说明
SearchElementJABDescription string

要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。

搜索 Java 元素角色
SearchElementJABRole string

要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。

搜索子元素
SearchSubTree boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

最大相对深度
MaxRelativeDepth integer

要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。

匹配索引
MatchIndex integer

如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。

搜索筛选器
SearchFilter string

可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。

按列名称排序
SortByColumn string

如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。

匹配索引升序
MatchIndexAscending boolean

如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。

区分大小写的搜索
CaseSensitiveSearch boolean

元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。

仅搜索可见元素
OnlySearchVisibleElements boolean

是否应只搜索可见元素? 默认情况下,此值设置为 true。

仅显示元素的搜索
OnlySearchShowingElements boolean

是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。

不遍历的元素角色
ElementRolesNotToTraverse string

一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

要搜索的最大元素数
MaximumElementsToSearch integer

查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

每个节点要搜索的最大子元素数
MaximumChildElementsToSearchPerNode integer

查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

返回

名称 路径 类型 说明
元素存在
ElementExists boolean

如果元素存在,则返回 true;否则返回 false。

元素 JAB 句柄
ElementJABHandle integer

如果找到搜索元素,这将保存一个数字元素句柄,该句柄可用于进一步作以充当“父”句柄进行进一步搜索(即查找相对于此句柄的元素)。

元素名称
ElementName string

定位元素的 Java 名称。

元素说明
ElementDescription string

定位元素的 Java 说明(如果有)。

元素角色
ElementRole string

定位元素的 Java 角色(例如框架或面板)(如果有)。

Java 桌面元素是否存在

报告 Java 桌面元素是否存在并提供一些基本元素属性。

参数

名称 密钥 必需 类型 说明
搜索 UIA 元素名称
SearchUIAElementName string

要搜索的可选 UIA 元素名称(从父窗口句柄开始)。 可以通过检查发现这一点。

搜索 UIA 元素类名
SearchUIAElementClassName string

要搜索的可选 UIA 元素类名(从父窗口句柄开始)。 可以通过检查发现这一点。

搜索 UIA 元素本地化控件类型
SearchUIAElementLocalizedControlType string

要搜索的可选 UIA 元素本地化控件类型(从父窗口句柄开始)。 可以通过检查发现这一点。

搜索进程 ID
SearchProcessID integer

正在运行的进程的进程 ID。 这可以作为“运行进程”作的输出进行检索。

搜索子元素
SearchChildElements boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

匹配索引
MatchIndex integer

如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。

搜索筛选器
SearchFilter string

可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。

按列名称排序
SortByColumn string

如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。

匹配索引升序
MatchIndexAscending boolean

如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。

包括子进程
IncludeChildProcesses boolean

如果设置为 true 并且指定了“搜索进程 ID”,则搜索中将包含该进程 ID 的子进程。 这通常适用于 Java,因为启动器 EXE 通常会运行子级“Java(w).exe”进程。 如果设置为 false,则仅返回与确切的“搜索进程 ID”匹配的进程。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

返回

名称 路径 类型 说明
元素存在
ElementExists boolean

如果元素存在,则返回 true;否则返回 false。

元素 JAB 句柄
ElementJABHandle integer

如果找到搜索元素,这将保存一个数字元素句柄,该句柄可用于进一步作以充当“父”句柄进行进一步搜索(即查找相对于此句柄的元素)。

元素名称
ElementName string

定位元素的 Java 名称。

元素说明
ElementDescription string

定位元素的 Java 说明(如果有)。

元素角色
ElementRole string

定位元素的 Java 角色(例如框架或面板)(如果有)。

从元素句柄获取 Java 角色 CSV

以 CSV 形式返回指定元素句柄下方的元素角色树。 此作仅用于开发目的,并提供应用程序的元素概述,这些元素可用于可视化应用程序结构和优化元素搜索。

参数

名称 密钥 必需 类型 说明
父元素 JAB 句柄
SearchParentElementJABHandle True integer

Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。

搜索子元素
SearchSubTree boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

最大相对深度
MaxRelativeDepth integer

要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。

仅搜索可见元素
OnlySearchVisibleElements boolean

是否应只搜索可见元素? 默认情况下,此值设置为 true。

仅显示元素的搜索
OnlySearchShowingElements boolean

是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。

不遍历的元素角色
ElementRolesNotToTraverse string

一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

要搜索的最大元素数
MaximumElementsToSearch integer

查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

每个节点要搜索的最大子元素数
MaximumChildElementsToSearchPerNode integer

查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

CSV 中的缩进角色
IndentRoleInCSV boolean

CSV 输出中的子元素角色是否应缩进? 这有助于更好地可视化 Java 元素树中的父关系和子关系。 默认情况下,此值设置为“True”。

在 CSV 中包含说明
IncludeDescriptionInCSV boolean

元素说明是否应包含在 CSV 输出中? 默认情况下,此值设置为“True”。

在 CSV 中包含维度
IncludeDimensionsInCSV boolean

元素维度(高度、宽度和边界边缘)是否应包含在 CSV 输出中? 默认情况下,此值设置为“True”。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

返回

名称 路径 类型 说明
找到的元素
ElementFound boolean

如果找到输入句柄指定的元素,则返回 true;否则返回 false。

搜索的元素数
ElementsSearched integer

在父元素下搜索的元素数。

角色 CSV
RoleCSV string

包含父元素下找到的每个元素的角色的 CSV 输出。

从元素搜索获取 Java 角色 CSV

执行 Java 元素搜索,并将搜索的元素的详细信息(最多输出到找到元素的点)作为 CSV。 此作仅用于开发目的,并提供应用程序的元素概述,这些元素可用于可视化应用程序结构和优化元素搜索。

参数

名称 密钥 必需 类型 说明
父元素 JAB 句柄
SearchParentElementJABHandle True integer

Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。

搜索 Java 元素名称
SearchElementJABName string

要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。

搜索 Java 元素说明
SearchElementJABDescription string

要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。

搜索 Java 元素角色
SearchElementJABRole string

要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。

搜索子元素
SearchSubTree boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

最大相对深度
MaxRelativeDepth integer

要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。

匹配索引
MatchIndex integer

如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。

搜索筛选器
SearchFilter string

可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。

按列名称排序
SortByColumn string

如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。

匹配索引升序
MatchIndexAscending boolean

如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。

区分大小写的搜索
CaseSensitiveSearch boolean

元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。

仅搜索可见元素
OnlySearchVisibleElements boolean

是否应只搜索可见元素? 默认情况下,此值设置为 true。

仅显示元素的搜索
OnlySearchShowingElements boolean

是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。

不遍历的元素角色
ElementRolesNotToTraverse string

一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

要搜索的最大元素数
MaximumElementsToSearch integer

查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

每个节点要搜索的最大子元素数
MaximumChildElementsToSearchPerNode integer

查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

CSV 中的缩进角色
IndentRoleInCSV boolean

CSV 输出中的子元素角色是否应缩进? 这有助于更好地可视化 Java 元素树中的父关系和子关系。 默认情况下,此值设置为“True”。

在 CSV 中包含说明
IncludeDescriptionInCSV boolean

元素说明是否应包含在 CSV 输出中? 默认情况下,此值设置为“True”。

在 CSV 中包含维度
IncludeDimensionsInCSV boolean

元素维度(高度、宽度和边界边缘)是否应包含在 CSV 输出中? 默认情况下,此值设置为“True”。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

返回

名称 路径 类型 说明
找到的元素
ElementFound boolean

如果找到搜索元素,则返回 true;否则返回 false。

搜索的元素数
ElementsSearched integer

在找到搜索元素之前在父元素下搜索的元素数。

角色 CSV
RoleCSV string

包含搜索中找到的每个元素的角色的 CSV 输出。

以列表的形式获取 Java 元素属性

返回 Java 元素的属性作为单行列表(单行集合/数据表),而不是单个项,这也许很有用,具体取决于你打算如何使用数据。

参数

名称 密钥 必需 类型 说明
父元素 JAB 句柄
SearchParentElementJABHandle True integer

Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。

搜索 Java 元素名称
SearchElementJABName string

要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。

搜索 Java 元素说明
SearchElementJABDescription string

要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。

搜索 Java 元素角色
SearchElementJABRole string

要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。

搜索子元素
SearchSubTree boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

最大相对深度
MaxRelativeDepth integer

要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。

匹配索引
MatchIndex integer

如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。

搜索筛选器
SearchFilter string

可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。

按列名称排序
SortByColumn string

如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。

匹配索引升序
MatchIndexAscending boolean

如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。

区分大小写的搜索
CaseSensitiveSearch boolean

元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。

仅搜索可见元素
OnlySearchVisibleElements boolean

是否应只搜索可见元素? 默认情况下,此值设置为 true。

仅显示元素的搜索
OnlySearchShowingElements boolean

是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。

不遍历的元素角色
ElementRolesNotToTraverse string

一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

要搜索的最大元素数
MaximumElementsToSearch integer

查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

每个节点要搜索的最大子元素数
MaximumChildElementsToSearchPerNode integer

查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

最大字符串长度
MaxStringLength integer

说明字段的最大长度。 这有时可能包含大量文本,因此设置最大值可以提高搜索速度。 默认情况下,没有最大字符串长度,因此将返回完整说明。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

返回

名称 路径 类型 说明
找到的元素数
NumberOfElementsFound integer

找到满足搜索条件的元素数。

返回的元素数
NumberOfElementsReturned integer

从搜索返回的元素数。 如果“要搜索的最大元素数”或“每个节点要搜索的最大子元素数”设置为较低的数字,则这可能小于找到的元素数。

Java 元素属性 JSON
JABElementPropertiesJSON string

找到与搜索条件匹配的 Java 元素的元素属性(采用 JSON 格式)。

全局中间鼠标单击 Java 元素

将鼠标移动到 Java 元素的中心,然后单击中间鼠标按钮。

参数

名称 密钥 必需 类型 说明
父元素 JAB 句柄
SearchParentElementJABHandle True integer

Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。

搜索 Java 元素名称
SearchElementJABName string

要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。

搜索 Java 元素说明
SearchElementJABDescription string

要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。

搜索 Java 元素角色
SearchElementJABRole string

要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。

搜索子元素
SearchSubTree boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

最大相对深度
MaxRelativeDepth integer

要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。

匹配索引
MatchIndex integer

如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。

搜索筛选器
SearchFilter string

可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。

按列名称排序
SortByColumn string

如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。

匹配索引升序
MatchIndexAscending boolean

如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。

区分大小写的搜索
CaseSensitiveSearch boolean

元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。

仅搜索可见元素
OnlySearchVisibleElements boolean

是否应只搜索可见元素? 默认情况下,此值设置为 true。

仅显示元素的搜索
OnlySearchShowingElements boolean

是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。

不遍历的元素角色
ElementRolesNotToTraverse string

一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

要搜索的最大元素数
MaximumElementsToSearch integer

查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

每个节点要搜索的最大子元素数
MaximumChildElementsToSearchPerNode integer

查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

单击偏移 X
ClickOffsetX integer

要偏移单击作依据的 X 像素数。 此参数支持正(右)和负(左)偏移值。

单击偏移 Y
ClickOffsetY integer

要偏移单击作的 Y 像素数。 此参数支持正(down)和负(向上)偏移值。

相对于
OffsetRelativeTo string

要偏移的元素的相对位置(居中/中、左、右、上、下、下、左上、右下、左下、右下)。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

全局双鼠标左键单击 Java 元素

将鼠标移动到 Java 元素的中心,然后双击鼠标左键。

参数

名称 密钥 必需 类型 说明
父元素 JAB 句柄
SearchParentElementJABHandle True integer

Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。

搜索 Java 元素名称
SearchElementJABName string

要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。

搜索 Java 元素说明
SearchElementJABDescription string

要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。

搜索 Java 元素角色
SearchElementJABRole string

要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。

搜索子元素
SearchSubTree boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

最大相对深度
MaxRelativeDepth integer

要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。

匹配索引
MatchIndex integer

如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。

搜索筛选器
SearchFilter string

可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。

按列名称排序
SortByColumn string

如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。

匹配索引升序
MatchIndexAscending boolean

如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。

区分大小写的搜索
CaseSensitiveSearch boolean

元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。

仅搜索可见元素
OnlySearchVisibleElements boolean

是否应只搜索可见元素? 默认情况下,此值设置为 true。

仅显示元素的搜索
OnlySearchShowingElements boolean

是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。

不遍历的元素角色
ElementRolesNotToTraverse string

一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

要搜索的最大元素数
MaximumElementsToSearch integer

查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

每个节点要搜索的最大子元素数
MaximumChildElementsToSearchPerNode integer

查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

单击偏移 X
ClickOffsetX integer

要偏移单击作依据的 X 像素数。 此参数支持正(右)和负(左)偏移值。

单击偏移 Y
ClickOffsetY integer

要偏移单击作的 Y 像素数。 此参数支持正(down)和负(向上)偏移值。

相对于
OffsetRelativeTo string

要偏移的元素的相对位置(居中/中、左、右、上、下、下、左上、右下、左下、右下)。

延迟(以毫秒为单位)
DelayInMilliseconds integer

第一次单击和第二次单击之间的延迟(以毫秒为单位)。 默认值为 10 毫秒。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

全局鼠标单击 Java 表单元格

将鼠标移动到 Java 表格单元格的中心,然后单击指定的鼠标按钮。

参数

名称 密钥 必需 类型 说明
父元素 JAB 句柄
SearchParentElementJABHandle True integer

Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。

搜索 Java 元素名称
SearchElementJABName string

要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。

搜索 Java 元素说明
SearchElementJABDescription string

要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。

搜索 Java 元素角色
SearchElementJABRole string

要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。

搜索子元素
SearchSubTree boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

最大相对深度
MaxRelativeDepth integer

要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。

匹配索引
MatchIndex integer

如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。

搜索筛选器
SearchFilter string

可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。

按列名称排序
SortByColumn string

如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。

匹配索引升序
MatchIndexAscending boolean

如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。

区分大小写的搜索
CaseSensitiveSearch boolean

元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。

仅搜索可见元素
OnlySearchVisibleElements boolean

是否应只搜索可见元素? 默认情况下,此值设置为 true。

仅显示元素的搜索
OnlySearchShowingElements boolean

是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。

不遍历的元素角色
ElementRolesNotToTraverse string

一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

要搜索的最大元素数
MaximumElementsToSearch integer

查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

每个节点要搜索的最大子元素数
MaximumChildElementsToSearchPerNode integer

查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

单元格行索引
RowIndex True integer

表中单元格的行索引,从 1 开始。

单元格列索引
ColumnIndex True integer

表中单元格的列索引,从 1 开始。

枚举视区
EnumerateViewport boolean

视区元素通常包含表,并表示表的可见区域。 如果设置为“True”(默认值),则 IA-Connect 代理将通过计算视区的大小来尝试检测表可见边界和每个角单元格的索引。 这使你可以确定表的哪些组件当前在屏幕上可见。 如果设置为“False”,则不会填充视区坐标。

处理视区父级
ProcessViewportParents boolean

如果设置为“True”(默认值),则还将处理视区父元素,以帮助优化视区可见大小。 如果它嵌入到另一个视区中,这非常有用。 如果设置为“False”,则不会处理视区父元素。

要处理的最大视区父级
MaxViewportParentsToProcess integer

枚举视区时要处理的父元素的最大数目。 默认情况下,此值设置为 50。

要考虑的视区父元素角色
ViewportParentElementRolesToConsider string

枚举以计算视区大小时要考虑的视区父元素的角色。 这用于排除大小小于视口的父元素,这些元素可能会倾斜大小计算,例如页面选项卡。 默认情况下,这些为:面板、视区、分层窗格、根窗格。

视区左边距
ViewportLeftMargin integer

枚举视区左内部边距。 此值可用于排除可能仅由单个像素或两个像素显示且几乎完全处于屏幕外的任何单元格。 默认情况下,此值设置为 2,仅当尝试影响 IA-Connect 代理返回的数据时,才应增加。

视区上边距
ViewportTopMargin integer

枚举视区顶部的内部边距。 此值可用于排除可能仅由单个像素或两个像素显示且几乎完全处于屏幕外的任何单元格。 默认情况下,此值设置为 2,仅当尝试影响 IA-Connect 代理返回的数据时,才应增加。

视区右边距
ViewportRightMargin integer

枚举视区的右内部边距。 此值可用于排除可能仅由单个像素或两个像素显示且几乎完全处于屏幕外的任何单元格。 默认情况下,此值设置为 2,仅当尝试影响 IA-Connect 代理返回的数据时,才应增加。

视区下边距
ViewportBottomMargin integer

枚举视区底部的内部边距。 此值可用于排除可能仅由单个像素或两个像素显示且几乎完全处于屏幕外的任何单元格。 默认情况下,此值设置为 2,仅当尝试影响 IA-Connect 代理返回的数据时,才应增加。

鼠标按钮
MouseButton True integer

单击表格单元格时要使用的鼠标按钮。 Left = 0,Right = 1,Middle = 2,Double left = 3。

单击偏移 X
ClickOffsetX integer

要偏移单击作依据的 X 像素数。 此参数支持正(右)和负(左)偏移值。

单击偏移 Y
ClickOffsetY integer

要偏移单击作的 Y 像素数。 此参数支持正(down)和负(向上)偏移值。

相对于
OffsetRelativeTo string

要偏移的元素的相对位置(居中/中、左、右、上、下、下、左上、右下、左下、右下)。

延迟(以毫秒为单位)
DelayInMilliseconds integer

单击之间等待的秒数,默认情况下为 0.05(20 毫秒)。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

全局鼠标右键单击 Java 元素

将鼠标移动到 Java 元素的中心,然后单击鼠标右键。

参数

名称 密钥 必需 类型 说明
父元素 JAB 句柄
SearchParentElementJABHandle True integer

Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。

搜索 Java 元素名称
SearchElementJABName string

要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。

搜索 Java 元素说明
SearchElementJABDescription string

要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。

搜索 Java 元素角色
SearchElementJABRole string

要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。

搜索子元素
SearchSubTree boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

最大相对深度
MaxRelativeDepth integer

要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。

匹配索引
MatchIndex integer

如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。

搜索筛选器
SearchFilter string

可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。

按列名称排序
SortByColumn string

如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。

匹配索引升序
MatchIndexAscending boolean

如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。

区分大小写的搜索
CaseSensitiveSearch boolean

元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。

仅搜索可见元素
OnlySearchVisibleElements boolean

是否应只搜索可见元素? 默认情况下,此值设置为 true。

仅显示元素的搜索
OnlySearchShowingElements boolean

是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。

不遍历的元素角色
ElementRolesNotToTraverse string

一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

要搜索的最大元素数
MaximumElementsToSearch integer

查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

每个节点要搜索的最大子元素数
MaximumChildElementsToSearchPerNode integer

查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

单击偏移 X
ClickOffsetX integer

要偏移单击作依据的 X 像素数。 此参数支持正(右)和负(左)偏移值。

单击偏移 Y
ClickOffsetY integer

要偏移单击作的 Y 像素数。 此参数支持正(down)和负(向上)偏移值。

相对于
OffsetRelativeTo string

要偏移的元素的相对位置(居中/中、左、右、上、下、下、左上、右下、左下、右下)。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

全局鼠标左键单击 Java 元素

将鼠标移动到 Java 元素的中心,然后单击鼠标左键。

参数

名称 密钥 必需 类型 说明
父元素 JAB 句柄
SearchParentElementJABHandle True integer

Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。

搜索 Java 元素名称
SearchElementJABName string

要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。

搜索 Java 元素说明
SearchElementJABDescription string

要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。

搜索 Java 元素角色
SearchElementJABRole string

要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。

搜索子元素
SearchSubTree boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

最大相对深度
MaxRelativeDepth integer

要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。

匹配索引
MatchIndex integer

如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。

搜索筛选器
SearchFilter string

可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。

按列名称排序
SortByColumn string

如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。

匹配索引升序
MatchIndexAscending boolean

如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。

区分大小写的搜索
CaseSensitiveSearch boolean

元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。

仅搜索可见元素
OnlySearchVisibleElements boolean

是否应只搜索可见元素? 默认情况下,此值设置为 true。

仅显示元素的搜索
OnlySearchShowingElements boolean

是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。

不遍历的元素角色
ElementRolesNotToTraverse string

一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

要搜索的最大元素数
MaximumElementsToSearch integer

查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

每个节点要搜索的最大子元素数
MaximumChildElementsToSearchPerNode integer

查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

单击偏移 X
ClickOffsetX integer

要偏移单击作依据的 X 像素数。 此参数支持正(右)和负(左)偏移值。

单击偏移 Y
ClickOffsetY integer

要偏移单击作的 Y 像素数。 此参数支持正(down)和负(向上)偏移值。

相对于
OffsetRelativeTo string

要偏移的元素的相对位置(居中/中、左、右、上、下、下、左上、右下、左下、右下)。

单击元素的次数
NumberOfTimesToClickElement integer

单击元素的次数,默认情况下为 1。

在单击之间等待的秒数
SecondsToWaitBetweenClicks double

单击之间等待的秒数,默认情况下为 0。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

围绕 Java 元素绘制矩形

在 Java 元素的外围周围绘制一个矩形,以帮助确定找到的元素是必需的。 矩形在 5 秒后自动删除。

参数

名称 密钥 必需 类型 说明
父元素 JAB 句柄
SearchParentElementJABHandle True integer

Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。

搜索 Java 元素名称
SearchElementJABName string

要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。

搜索 Java 元素说明
SearchElementJABDescription string

要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。

搜索 Java 元素角色
SearchElementJABRole string

要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。

搜索子元素
SearchSubTree boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

最大相对深度
MaxRelativeDepth integer

要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。

匹配索引
MatchIndex integer

如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。

搜索筛选器
SearchFilter string

可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。

按列名称排序
SortByColumn string

如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。

匹配索引升序
MatchIndexAscending boolean

如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。

区分大小写的搜索
CaseSensitiveSearch boolean

元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。

仅搜索可见元素
OnlySearchVisibleElements boolean

是否应只搜索可见元素? 默认情况下,此值设置为 true。

仅显示元素的搜索
OnlySearchShowingElements boolean

是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。

不遍历的元素角色
ElementRolesNotToTraverse string

一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

要搜索的最大元素数
MaximumElementsToSearch integer

查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

每个节点要搜索的最大子元素数
MaximumChildElementsToSearchPerNode integer

查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

笔颜色
PenColour string

要绘制的矩形的颜色(例如红色、绿色、蓝色、黄色、紫色或橙色)或字符串十六进制代码(例如 #FF0000)。

笔粗像素
PenThicknessPixels integer

突出显示矩形边框的粗细(以像素为单位)。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

在 Java 元素中输入密码

将密码输入 Java 元素(通常是密码输入字段),替换现有文本。

参数

名称 密钥 必需 类型 说明
父元素 JAB 句柄
SearchParentElementJABHandle True integer

Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。

搜索 Java 元素名称
SearchElementJABName string

要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。

搜索 Java 元素说明
SearchElementJABDescription string

要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。

搜索 Java 元素角色
SearchElementJABRole string

要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。

搜索子元素
SearchSubTree boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

最大相对深度
MaxRelativeDepth integer

要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。

匹配索引
MatchIndex integer

如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。

搜索筛选器
SearchFilter string

可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。

按列名称排序
SortByColumn string

如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。

匹配索引升序
MatchIndexAscending boolean

如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。

区分大小写的搜索
CaseSensitiveSearch boolean

元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。

仅搜索可见元素
OnlySearchVisibleElements boolean

是否应只搜索可见元素? 默认情况下,此值设置为 true。

仅显示元素的搜索
OnlySearchShowingElements boolean

是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。

不遍历的元素角色
ElementRolesNotToTraverse string

一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

要搜索的最大元素数
MaximumElementsToSearch integer

查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

每个节点要搜索的最大子元素数
MaximumChildElementsToSearchPerNode integer

查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

输入密码
PasswordToInput True password

要输入的密码值。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

在屏幕坐标处为 Java 元素创建句柄

通过提供屏幕坐标来创建 Java 元素的句柄。 如果 Java 元素存在于指定坐标处,该作将标识该元素并返回该元素的句柄。

参数

名称 密钥 必需 类型 说明
父元素 JAB 句柄
ParentElementJABHandle True integer

Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。

屏幕 X
ScreenX True integer

屏幕 X 坐标(以像素为单位),以像素为单位查找元素。

屏幕 Y
ScreenY True integer

要在其中找到元素的屏幕 Y 坐标(以像素为单位)。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

返回

名称 路径 类型 说明
定位元素 JAB 句柄
LocatedElementJABHandle integer

如果元素存在于指定坐标处,则将保存一个数值元素句柄,该句柄可用于进一步作以充当“父”句柄,以便进一步搜索(即查找相对于句柄的元素)。

在屏幕坐标处获取 Java 表单元格

如果作为表的子元素的 Java 表单元格存在于指定的坐标处,此作将标识元素及其属性,并选择性地返回表单元格元素的句柄。

参数

名称 密钥 必需 类型 说明
Table 元素 JAB 句柄
TableElementJABHandle True integer

要搜索的父表元素的 Java 元素句柄。 这可能是之前使用“获取 Java 元素属性”找到的表。

屏幕 X
ScreenX True integer

屏幕 X 坐标(以像素为单位),用于查找表单元格的位置。

屏幕 Y
ScreenY True integer

要查找表单元格的屏幕 Y 坐标(以像素为单位)。

返回句柄
ReturnJABHandle boolean

是否应为单元格返回元素句柄?

Workflow
Workflow True string

在此处添加以下表达式:workflow()

返回

名称 路径 类型 说明
父级的单元格索引
CellIndexInParent integer

表中单元格的单元格索引。 第一行中的第一个单元格的索引为 1,该行中每个单元格的索引将增加 1。 因此,在包含 5 行和 3 列的表中,第二行中的第一个单元格的索引为 4。

单元格行索引
CellRowIndex integer

表中单元格的行索引,从 1 开始。

单元格列索引
CellColumnIndex integer

表中单元格的列索引,从 1 开始。

单元格 JAB 句柄
CellJABHandle integer

表单元格的元素句柄。

对 Java 元素执行作

执行 Java 元素的可访问作。 可以使用“获取 Java 元素的作”作来查询特定元素的这些可访问作。 对于文本元素,一些常见作是按钮的“click”或“select-all”。

参数

名称 密钥 必需 类型 说明
父元素 JAB 句柄
SearchParentElementJABHandle True integer

Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。

搜索 Java 元素名称
SearchElementJABName string

要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。

搜索 Java 元素说明
SearchElementJABDescription string

要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。

搜索 Java 元素角色
SearchElementJABRole string

要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。

搜索子元素
SearchSubTree boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

最大相对深度
MaxRelativeDepth integer

要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。

匹配索引
MatchIndex integer

如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。

搜索筛选器
SearchFilter string

可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。

按列名称排序
SortByColumn string

如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。

匹配索引升序
MatchIndexAscending boolean

如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。

区分大小写的搜索
CaseSensitiveSearch boolean

元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。

仅搜索可见元素
OnlySearchVisibleElements boolean

是否应只搜索可见元素? 默认情况下,此值设置为 true。

仅显示元素的搜索
OnlySearchShowingElements boolean

是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。

不遍历的元素角色
ElementRolesNotToTraverse string

一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

要搜索的最大元素数
MaximumElementsToSearch integer

查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

每个节点要搜索的最大子元素数
MaximumChildElementsToSearchPerNode integer

查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

Action
Action True string

要执行的作,例如“click”。 作名称通常区分大小写。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

将全局输入文本写入 Java 元素

将鼠标移动到 Java 元素的中心,将鼠标焦点放在它、左键和按下键。 通常用于不接受本机 UIA 输入法的文本输入。

参数

名称 密钥 必需 类型 说明
父元素 JAB 句柄
SearchParentElementJABHandle True integer

Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。

搜索 Java 元素名称
SearchElementJABName string

要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。

搜索 Java 元素说明
SearchElementJABDescription string

要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。

搜索 Java 元素角色
SearchElementJABRole string

要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。

搜索子元素
SearchSubTree boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

最大相对深度
MaxRelativeDepth integer

要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。

匹配索引
MatchIndex integer

如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。

搜索筛选器
SearchFilter string

可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。

按列名称排序
SortByColumn string

如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。

匹配索引升序
MatchIndexAscending boolean

如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。

区分大小写的搜索
CaseSensitiveSearch boolean

元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。

仅搜索可见元素
OnlySearchVisibleElements boolean

是否应只搜索可见元素? 默认情况下,此值设置为 true。

仅显示元素的搜索
OnlySearchShowingElements boolean

是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。

不遍历的元素角色
ElementRolesNotToTraverse string

一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

要搜索的最大元素数
MaximumElementsToSearch integer

查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

每个节点要搜索的最大子元素数
MaximumChildElementsToSearchPerNode integer

查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

Focus 元素首先
FocusElement boolean

是否应 IA-Connect 尝试在全局单击之前聚焦元素?

全局鼠标左键单击元素
GlobalMouseClickOnElement boolean

在输入文本之前,是否应在元素坐标(以聚焦元素)处执行全局鼠标单击?

使用双击删除鼠标替换现有值
ReplaceExistingValueUsingDoubleClickDelete boolean

是否应通过双击鼠标(突出显示它),然后删除来替换任何现有值?

使用 CTRL-A delete 替换现有值
ReplaceExistingValueUsingCTRLADelete boolean

是否应按 Ctrl-A 替换任何现有值(要突出显示所有值),然后删除? 某些元素可能不支持使用 Ctrl-A 突出显示,在这种情况下,应尝试“使用双击删除替换现有值”的替代选项。

要输入的文本
TextToInput string

使用键盘将文本值设置为全局输入。

使用发送密钥事件
SendKeyEvents boolean

如果设置为 true,则将使用将模拟击键发送到作系统的较低级别的 API。 如果设置为 false,则会改用将击键发送到焦点元素的更高级别的 API。

密钥间隔(以毫秒为单位)
KeyIntervalInMilliseconds integer

每个按键之间的毫秒数。

双击间隔(以毫秒为单位)
DoubleClickIntervalInMilliseconds integer

如果参数“使用双击删除替换现有值”设置为 true,则每次单击之间的毫秒数。

不解释符号
DontInterpretSymbols boolean

“要输入的文本”中的符号是否不应解释为特殊键(例如,对于 Shift、^ for Ctrl)? 如果尝试输入实际符号,则应将其设置为 true。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

将文本输入 Java 元素

将文本输入 Java 元素(通常是文本输入字段),要么替换现有文本,要么将新值插入到特定位置。

参数

名称 密钥 必需 类型 说明
父元素 JAB 句柄
SearchParentElementJABHandle True integer

Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。

搜索 Java 元素名称
SearchElementJABName string

要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。

搜索 Java 元素说明
SearchElementJABDescription string

要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。

搜索 Java 元素角色
SearchElementJABRole string

要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。

搜索子元素
SearchSubTree boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

最大相对深度
MaxRelativeDepth integer

要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。

匹配索引
MatchIndex integer

如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。

搜索筛选器
SearchFilter string

可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。

按列名称排序
SortByColumn string

如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。

匹配索引升序
MatchIndexAscending boolean

如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。

区分大小写的搜索
CaseSensitiveSearch boolean

元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。

仅搜索可见元素
OnlySearchVisibleElements boolean

是否应只搜索可见元素? 默认情况下,此值设置为 true。

仅显示元素的搜索
OnlySearchShowingElements boolean

是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。

不遍历的元素角色
ElementRolesNotToTraverse string

一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

要搜索的最大元素数
MaximumElementsToSearch integer

查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

每个节点要搜索的最大子元素数
MaximumChildElementsToSearchPerNode integer

查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

要输入的文本
TextToInput string

要输入的文本值。

替换现有值
ReplaceExistingValue boolean

如果元素中存在现有文本,应将其替换?

插入位置
InsertPosition integer

开始插入文本的位置(索引)。 如果存在现有文本,则插入位置可用于在现有文本中的特定位置插入。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

屏幕上可见的 Java 表单元格

返回 Java 表元素中的特定表单元格当前是否在屏幕上可见。

参数

名称 密钥 必需 类型 说明
父元素 JAB 句柄
SearchParentElementJABHandle True integer

Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。

搜索 Java 元素名称
SearchElementJABName string

要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。

搜索 Java 元素说明
SearchElementJABDescription string

要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。

搜索 Java 元素角色
SearchElementJABRole string

要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。

搜索子元素
SearchSubTree boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

最大相对深度
MaxRelativeDepth integer

要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。

匹配索引
MatchIndex integer

如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。

搜索筛选器
SearchFilter string

可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。

按列名称排序
SortByColumn string

如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。

匹配索引升序
MatchIndexAscending boolean

如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。

区分大小写的搜索
CaseSensitiveSearch boolean

元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。

仅搜索可见元素
OnlySearchVisibleElements boolean

是否应只搜索可见元素? 默认情况下,此值设置为 true。

仅显示元素的搜索
OnlySearchShowingElements boolean

是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。

不遍历的元素角色
ElementRolesNotToTraverse string

一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

要搜索的最大元素数
MaximumElementsToSearch integer

查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

每个节点要搜索的最大子元素数
MaximumChildElementsToSearchPerNode integer

查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

处理视区父级
ProcessViewportParents boolean

如果设置为“True”(默认值),则还将处理视区父元素,以帮助优化视区可见大小。 如果它嵌入到另一个视区中,这非常有用。 如果设置为“False”,则不会处理视区父元素。

要处理的最大视区父级
MaxViewportParentsToProcess integer

枚举视区时要处理的父元素的最大数目。 默认情况下,此值设置为 50。

要考虑的视区父元素角色
ViewportParentElementRolesToConsider string

枚举以计算视区大小时要考虑的视区父元素的角色。 这用于排除大小小于视口的父元素,这些元素可能会倾斜大小计算,例如页面选项卡。 默认情况下,这些为:面板、视区、分层窗格、根窗格。

视区左边距
ViewportLeftMargin integer

枚举视区左内部边距。 此值可用于排除可能仅由单个像素或两个像素显示且几乎完全处于屏幕外的任何单元格。 默认情况下,此值设置为 2,仅当尝试影响 IA-Connect 代理返回的数据时,才应增加。

视区上边距
ViewportTopMargin integer

枚举视区顶部的内部边距。 此值可用于排除可能仅由单个像素或两个像素显示且几乎完全处于屏幕外的任何单元格。 默认情况下,此值设置为 2,仅当尝试影响 IA-Connect 代理返回的数据时,才应增加。

视区右边距
ViewportRightMargin integer

枚举视区的右内部边距。 此值可用于排除可能仅由单个像素或两个像素显示且几乎完全处于屏幕外的任何单元格。 默认情况下,此值设置为 2,仅当尝试影响 IA-Connect 代理返回的数据时,才应增加。

视区下边距
ViewportBottomMargin integer

枚举视区底部的内部边距。 此值可用于排除可能仅由单个像素或两个像素显示且几乎完全处于屏幕外的任何单元格。 默认情况下,此值设置为 2,仅当尝试影响 IA-Connect 代理返回的数据时,才应增加。

单元格行索引
CellRowIndex True integer

表中单元格的行索引,从 1 开始。

单元格列索引
CellColumnIndex True integer

表中单元格的列索引,从 1 开始。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

返回

名称 路径 类型 说明
屏幕上的单元格
CellOnScreen boolean

如果指定的单元格当前在屏幕上显示,则返回 true;否则返回 false。

结果是肯定的
ResultIsCertain boolean

如果“屏幕上的单元格”结果是确定的,则返回 true。 如果无法计算 4 个父表边界中的任何一个,则此值将设置为“False”。

屏幕外方向
OffscreenDirection string

指定单元格的屏幕外方向的文本表示形式,例如上方、下方、左侧或右侧。 如果单元格位于“上”和“左”或“右”,则将返回为“上图”。 同样,如果单元格位于 AND Left 或 Right 下方,则此作将返回为 Below。

展开 Java 选择元素

展开或折叠 Java 元素(通常是菜单/下拉列表项)。 如果项已展开,则不会发生任何作。

参数

名称 密钥 必需 类型 说明
父元素 JAB 句柄
SearchParentElementJABHandle True integer

Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。

搜索 Java 元素名称
SearchElementJABName string

要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。

搜索 Java 元素说明
SearchElementJABDescription string

要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。

搜索 Java 元素角色
SearchElementJABRole string

要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。

搜索子元素
SearchSubTree boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

最大相对深度
MaxRelativeDepth integer

要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。

匹配索引
MatchIndex integer

如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。

搜索筛选器
SearchFilter string

可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。

按列名称排序
SortByColumn string

如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。

匹配索引升序
MatchIndexAscending boolean

如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。

区分大小写的搜索
CaseSensitiveSearch boolean

元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。

仅搜索可见元素
OnlySearchVisibleElements boolean

是否应只搜索可见元素? 默认情况下,此值设置为 true。

仅显示元素的搜索
OnlySearchShowingElements boolean

是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。

不遍历的元素角色
ElementRolesNotToTraverse string

一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

要搜索的最大元素数
MaximumElementsToSearch integer

查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

每个节点要搜索的最大子元素数
MaximumChildElementsToSearchPerNode integer

查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

展开
Expand boolean

如果设置为“True”(默认值),则元素将展开。 如果设置为“False”,则元素将折叠。

验证元素状态
VerifyElementState boolean

如果设置为“True”,则之后 IA-Connect 代理将验证元素状态,以检查“Expanded”状态是否与预期状态匹配,如果不匹配,则会引发异常。 例如,如果展开元素,则“IsExpanded”属性应为 true。 如果设置为“False”,则不会验证元素状态。

等待状态更改的秒数
SecondsToWaitForStateChange double

展开或折叠后等待状态更改的秒数。 默认情况下,此值设置为 0.05(20 毫秒)。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

按 Java 元素

按 Java 元素(通常是按钮)。

参数

名称 密钥 必需 类型 说明
父元素 JAB 句柄
SearchParentElementJABHandle True integer

Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。

搜索 Java 元素名称
SearchElementJABName string

要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。

搜索 Java 元素说明
SearchElementJABDescription string

要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。

搜索 Java 元素角色
SearchElementJABRole string

要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。

搜索子元素
SearchSubTree boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

最大相对深度
MaxRelativeDepth integer

要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。

匹配索引
MatchIndex integer

如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。

搜索筛选器
SearchFilter string

可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。

按列名称排序
SortByColumn string

如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。

匹配索引升序
MatchIndexAscending boolean

如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。

区分大小写的搜索
CaseSensitiveSearch boolean

元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。

仅搜索可见元素
OnlySearchVisibleElements boolean

是否应只搜索可见元素? 默认情况下,此值设置为 true。

仅显示元素的搜索
OnlySearchShowingElements boolean

是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。

不遍历的元素角色
ElementRolesNotToTraverse string

一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

要搜索的最大元素数
MaximumElementsToSearch integer

查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

每个节点要搜索的最大子元素数
MaximumChildElementsToSearchPerNode integer

查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

按元素的次数
NumberOfTimesToPressElement integer

按元素的次数,默认情况下为 1。

在按下之间等待的秒数
SecondsToWaitBetweenPresses double

在按下之间等待的秒数,默认情况下为 0.05(20 毫秒)。

自动检测作名称
AutoDetectActionName boolean

如果设置为 true(默认值),IA-Connect 代理将尝试自动检测非英语区域设置中的“click”作名称。 如果元素有两个以上的可能作,则将使用“替代作名称”。 如果设置为 false,则 IA-Connect 代理不会尝试检测非英语区域设置中的“click”作名称,除非提供了“替代作名称”值,否则该作可能会失败。

重写作名称
OverrideActionName string

非英语区域设置中的“Click”作的名称,例如“cliquer”或“hacer clic”。 这可以从作“获取 Java 元素的作”的输出中确定,并且通常区分大小写。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

按名称获取 Java 选择状态

通过提供子元素名称返回所选内容(通常是列表或下拉列表中的项)中的子元素的选择状态。 可以使用作“获取 Java 选择元素项”检索所有选择子元素项来检查其名称。

参数

名称 密钥 必需 类型 说明
父元素 JAB 句柄
SearchParentElementJABHandle True integer

Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。

搜索 Java 元素名称
SearchElementJABName string

要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。

搜索 Java 元素说明
SearchElementJABDescription string

要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。

搜索 Java 元素角色
SearchElementJABRole string

要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。

搜索子元素
SearchSubTree boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

最大相对深度
MaxRelativeDepth integer

要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。

匹配索引
MatchIndex integer

如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。

搜索筛选器
SearchFilter string

可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。

按列名称排序
SortByColumn string

如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。

匹配索引升序
MatchIndexAscending boolean

如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。

区分大小写的搜索
CaseSensitiveSearch boolean

元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。

仅搜索可见元素
OnlySearchVisibleElements boolean

是否应只搜索可见元素? 默认情况下,此值设置为 true。

仅显示元素的搜索
OnlySearchShowingElements boolean

是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。

不遍历的元素角色
ElementRolesNotToTraverse string

一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

要搜索的最大元素数
MaximumElementsToSearch integer

查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

每个节点要搜索的最大子元素数
MaximumChildElementsToSearchPerNode integer

查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

物料名称
ItemName True string

要选择或取消选择的列表项的名称。

项名称区分大小写
ItemNameCaseSensitive boolean

如果设置为“True”,则项名称搜索将区分大小写(例如,它必须与列表项完全匹配)。 如果设置为“False”(默认值),则项名称搜索将不区分大小写。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

返回

名称 路径 类型 说明
已选择名称
NameIsSelected boolean

如果所选的命名选择列表项处于选中状态,则返回 true;否则返回 false。

按名称选择 Java 列表元素

选择具有指定名称的列表元素。 这通常用于在下拉菜单/菜单项中选择项。

参数

名称 密钥 必需 类型 说明
父元素 JAB 句柄
SearchParentElementJABHandle True integer

Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。

搜索 Java 元素名称
SearchElementJABName string

要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。

搜索 Java 元素说明
SearchElementJABDescription string

要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。

搜索 Java 元素角色
SearchElementJABRole string

要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。

搜索子元素
SearchSubTree boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

最大相对深度
MaxRelativeDepth integer

要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。

匹配索引
MatchIndex integer

如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。

搜索筛选器
SearchFilter string

可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。

按列名称排序
SortByColumn string

如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。

匹配索引升序
MatchIndexAscending boolean

如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。

区分大小写的搜索
CaseSensitiveSearch boolean

元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。

仅搜索可见元素
OnlySearchVisibleElements boolean

是否应只搜索可见元素? 默认情况下,此值设置为 true。

仅显示元素的搜索
OnlySearchShowingElements boolean

是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。

不遍历的元素角色
ElementRolesNotToTraverse string

一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

要搜索的最大元素数
MaximumElementsToSearch integer

查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

每个节点要搜索的最大子元素数
MaximumChildElementsToSearchPerNode integer

查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

物料名称
ItemName True string

要选择或取消选择的列表项的名称。

选择项
SelectItem boolean

如果设置为“True”(默认值),则将选择该项。 如果设置为“False”,则将取消选中该项。 这通常仅用于多选。

项名称区分大小写
ItemNameCaseSensitive boolean

如果设置为“True”,则项名称搜索将区分大小写(例如,它必须与列表项完全匹配)。 如果设置为“False”(默认值),则项名称搜索将不区分大小写。

首先清除所选内容
ClearSelectionFirst boolean

如果设置为“True”(默认值),则首先清除所选内容。 这主要用于多选,因为你需要选择其他项还是只选择单个项(首先清除)。 如果设置为“False”,则不会首先清除所选内容。

通过选择获取选项列表
GetListOfOptionsBySelecting boolean

如果设置为“True”,则 IA-Connect 代理将尝试通过依次选择每个选项(在 JAB 中)获取所选内容中的所有选项的列表。 如果设置为“False”(默认值),则“通过读取标签获取选项列表”参数应设置为“True”,否则不会读取选项列表。

通过读取标签获取选项列表
GetListOfOptionsByReadingLabels boolean

如果设置为“True”(默认值),则 IA-Connect 代理将尝试通过读取子标签(在 JAB 树中)获取所选内容中所有选项的列表。 对于下拉列表,几乎肯定会需要将“Expand first”参数设置为“True”,因为在列表下拉列表之前不会公开子元素。 此外,将“Collapse after”参数设置为“True”以在之后关闭列表。 “通过选择获取选项列表”参数也应设置为“False”,否则将忽略此选项(因为无法通过这两种方法获取列表)。 如果设置为“False”,则“通过选择”参数获取选项列表应设置为“True”,否则不会读取选项列表。

首先展开
ExpandFirst boolean

如果设置为“true”(默认值),则在搜索列表项元素之前,该作将尝试展开列表。 这对于动态列表非常有用,因为在展开列表之前,可能不会创建其他列表项元素。 如果设置为“false”,则列表将不会展开。

折叠后
CollapseAfter boolean

如果设置为 true(默认值),则在执行搜索后,列表将折叠。 如果设置为 false,则列表将不会折叠。

展开和折叠之间的秒数
SecondsBetweenExpandCollapse double

如果展开作和折叠作设置为“True”,则等待的秒数。 默认情况下,这是 0.05 (20 毫秒)。

强制,即使处于正确的状态
ForceEvenIfInCorrectState boolean

如果设置为“True”,则即使已选择该元素,也会选择该元素。 如果设置为“False”(默认值),则如果已选择列表元素,则 IA-Connect 代理将不执行任何作。

故障时恢复
RecoverOnFailure boolean

如果设置为“True”,则在新选择失败时,将恢复最初选择的列表项。 例如,如果选择了第 3 项,然后尝试选择第 90 项(不存在),则重新选择第 3 项。 如果设置为“False”,则不会恢复最初选择的列表项。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

按索引获取 Java 选择状态

通过提供子元素索引返回所选内容(通常是列表或下拉列表中的项)中的子元素的选择状态。 可以使用作“获取 Java 选择元素项”检索所有选择子元素项来检查其索引。

参数

名称 密钥 必需 类型 说明
父元素 JAB 句柄
SearchParentElementJABHandle True integer

Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。

搜索 Java 元素名称
SearchElementJABName string

要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。

搜索 Java 元素说明
SearchElementJABDescription string

要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。

搜索 Java 元素角色
SearchElementJABRole string

要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。

搜索子元素
SearchSubTree boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

最大相对深度
MaxRelativeDepth integer

要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。

匹配索引
MatchIndex integer

如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。

搜索筛选器
SearchFilter string

可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。

按列名称排序
SortByColumn string

如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。

匹配索引升序
MatchIndexAscending boolean

如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。

区分大小写的搜索
CaseSensitiveSearch boolean

元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。

仅搜索可见元素
OnlySearchVisibleElements boolean

是否应只搜索可见元素? 默认情况下,此值设置为 true。

仅显示元素的搜索
OnlySearchShowingElements boolean

是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。

不遍历的元素角色
ElementRolesNotToTraverse string

一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

要搜索的最大元素数
MaximumElementsToSearch integer

查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

每个节点要搜索的最大子元素数
MaximumChildElementsToSearchPerNode integer

查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

项索引
ItemIndex True integer

要查询的列表项状态的索引(从 1 开始)。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

返回

名称 路径 类型 说明
已选择索引
IndexIsSelected boolean

如果指定的索引处的选择列表项处于选中状态,则返回 true;否则返回 false。

按索引选择 Java 列表元素

选择与指定索引匹配的列表元素。 这通常用于在下拉菜单/菜单项中选择项。

参数

名称 密钥 必需 类型 说明
父元素 JAB 句柄
SearchParentElementJABHandle True integer

Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。

搜索 Java 元素名称
SearchElementJABName string

要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。

搜索 Java 元素说明
SearchElementJABDescription string

要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。

搜索 Java 元素角色
SearchElementJABRole string

要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。

搜索子元素
SearchSubTree boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

最大相对深度
MaxRelativeDepth integer

要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。

匹配索引
MatchIndex integer

如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。

搜索筛选器
SearchFilter string

可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。

按列名称排序
SortByColumn string

如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。

匹配索引升序
MatchIndexAscending boolean

如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。

区分大小写的搜索
CaseSensitiveSearch boolean

元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。

仅搜索可见元素
OnlySearchVisibleElements boolean

是否应只搜索可见元素? 默认情况下,此值设置为 true。

仅显示元素的搜索
OnlySearchShowingElements boolean

是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。

不遍历的元素角色
ElementRolesNotToTraverse string

一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

要搜索的最大元素数
MaximumElementsToSearch integer

查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

每个节点要搜索的最大子元素数
MaximumChildElementsToSearchPerNode integer

查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

项索引
ItemIndex True integer

要选择或取消选择的列表项的索引(从 1 开始)。

选择项
SelectItem boolean

如果设置为“True”(默认值),则将选择该项。 如果设置为“False”,则将取消选中该项。 这通常仅用于多选。

首先清除所选内容
ClearSelectionFirst boolean

如果设置为“True”(默认值),则首先清除所选内容。 这主要用于多选,因为你需要选择其他项还是只选择单个项(首先清除)。 如果设置为“False”,则不会首先清除所选内容。

故障时恢复
RecoverOnFailure boolean

如果设置为“True”,则在新选择失败时,将恢复最初选择的列表项。 例如,如果选择了第 3 项,然后尝试选择第 90 项(不存在),则重新选择第 3 项。 如果设置为“False”,则不会恢复最初选择的列表项。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

断开与 Java 访问网桥的连接

关闭任何运行 IA-Connect Java 子系统(IA-JavaAccessBridge)。

参数

名称 密钥 必需 类型 说明
禁用 Java 访问网桥
DisableJavaAccessBridge boolean

是否应禁用 Java 访问桥? 默认情况下,此值设置为“True”。

辅助功能文件路径
AccessibilityFilepath string

.accessibility.properties 文件的路径,用于控制是否启用 Java 访问桥。 如果未提供路径,则默认为 %USERPROFILE%.accessibility.properties。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

是 Java 窗口

返回 UIA 窗口是否为 Java 元素。

参数

名称 密钥 必需 类型 说明
父窗口句柄
ParentWindowHandle True integer

要充当搜索起点的父 UIA 窗口句柄。 这可以通过使用 UIA作(如“等待桌面元素”或“等待元素”)进行检查来发现。

搜索元素名称
SearchElementName string

要搜索的可选 UIA 元素名称(从父窗口句柄开始)。 可以通过检查发现这一点。

Search 元素类名
SearchElementClassName string

要搜索的可选 UIA 元素类名(从父窗口句柄开始)。 可以通过检查发现这一点。

搜索元素自动化 ID
SearchElementAutomationId string

要搜索的可选 UIA 元素自动化 ID(从父窗口句柄开始)。 可以通过检查发现这一点。

搜索元素本地化控件类型
SearchLocalizedControlType string

要搜索的可选 UIA 元素本地化控件类型(从父窗口句柄开始)。 可以通过检查发现这一点。

搜索 UIA 子树
SearchSubTree boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

匹配索引
MatchIndex integer

如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。

搜索筛选器
SearchFilter string

可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。

按列名称排序
SortByColumn string

如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。

匹配索引升序
MatchIndexAscending boolean

如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

返回

名称 路径 类型 说明
是 Java 窗口
IsJavaWindow boolean

如果找到的 UIA 元素是 Java 窗口,则返回 true;否则返回 false。

检查 Java 元素

将元素(通常是复选框或单选框)的状态设置为选中或未选中。

参数

名称 密钥 必需 类型 说明
父元素 JAB 句柄
SearchParentElementJABHandle True integer

Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。

搜索 Java 元素名称
SearchElementJABName string

要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。

搜索 Java 元素说明
SearchElementJABDescription string

要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。

搜索 Java 元素角色
SearchElementJABRole string

要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。

搜索子元素
SearchSubTree boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

最大相对深度
MaxRelativeDepth integer

要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。

匹配索引
MatchIndex integer

如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。

搜索筛选器
SearchFilter string

可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。

按列名称排序
SortByColumn string

如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。

匹配索引升序
MatchIndexAscending boolean

如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。

区分大小写的搜索
CaseSensitiveSearch boolean

元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。

仅搜索可见元素
OnlySearchVisibleElements boolean

是否应只搜索可见元素? 默认情况下,此值设置为 true。

仅显示元素的搜索
OnlySearchShowingElements boolean

是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。

不遍历的元素角色
ElementRolesNotToTraverse string

一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

要搜索的最大元素数
MaximumElementsToSearch integer

查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

每个节点要搜索的最大子元素数
MaximumChildElementsToSearchPerNode integer

查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

Check 元素
CheckElement boolean

元素应选中(true)还是未选中(false)?

自动检测作名称
AutoDetectActionName boolean

如果设置为 true(默认值),IA-Connect 代理将尝试自动检测非英语区域设置中的“click”作名称。 如果元素有两个以上的可能作,则将使用“替代作名称”。 如果设置为 false,则 IA-Connect 代理不会尝试检测非英语区域设置中的“click”作名称,除非提供了“替代作名称”值,否则该作可能会失败。

重写作名称
OverrideActionName string

非英语区域设置中的“Click”作的名称,例如“cliquer”或“hacer clic”。 这可以从作“获取 Java 元素的作”的输出中确定,并且通常区分大小写。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

等待 Java 元素

等待 Java 元素(通常是窗口内的单个元素(如按钮或文本输入区域)存在。

参数

名称 密钥 必需 类型 说明
父元素 JAB 句柄
SearchParentElementJABHandle True integer

Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。

搜索 Java 元素名称
SearchElementJABName string

要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。

搜索 Java 元素说明
SearchElementJABDescription string

要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。

搜索 Java 元素角色
SearchElementJABRole string

要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。

搜索子元素
SearchSubTree boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

最大相对深度
MaxRelativeDepth integer

要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。

匹配索引
MatchIndex integer

如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。

搜索筛选器
SearchFilter string

可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。

按列名称排序
SortByColumn string

如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。

匹配索引升序
MatchIndexAscending boolean

如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。

区分大小写的搜索
CaseSensitiveSearch boolean

元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。

仅搜索可见元素
OnlySearchVisibleElements boolean

是否应只搜索可见元素? 默认情况下,此值设置为 true。

仅显示元素的搜索
OnlySearchShowingElements boolean

是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。

不遍历的元素角色
ElementRolesNotToTraverse string

一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

要搜索的最大元素数
MaximumElementsToSearch integer

查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

每个节点要搜索的最大子元素数
MaximumChildElementsToSearchPerNode integer

查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

等待的秒数
SecondsToWait True double

等待元素存在的最大秒数。

如果未找到元素,引发异常
RaiseExceptionIfElementNotFound boolean

如果等待期后 Java 元素不存在,IA-Connect 是否应引发异常?

Workflow
Workflow True string

在此处添加以下表达式:workflow()

返回

名称 路径 类型 说明
元素存在
ElementExists boolean

如果元素存在,则返回 true;否则返回 false。

元素 JAB 句柄
ElementJABHandle integer

如果找到搜索元素,这将保存一个数字元素句柄,该句柄可用于进一步作以充当“父”句柄进行进一步搜索(即查找相对于此句柄的元素)。

元素名称
ElementName string

定位元素的 Java 名称。

元素说明
ElementDescription string

定位元素的 Java 说明(如果有)。

元素角色
ElementRole string

定位元素的 Java 角色(例如框架或面板)(如果有)。

等待 Java 元素不存在

等待 Java 元素(通常是窗口内的单个元素(如按钮或文本输入区域)不再存在。

参数

名称 密钥 必需 类型 说明
父元素 JAB 句柄
SearchParentElementJABHandle True integer

Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。

搜索 Java 元素名称
SearchElementJABName string

要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。

搜索 Java 元素说明
SearchElementJABDescription string

要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。

搜索 Java 元素角色
SearchElementJABRole string

要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。

搜索子元素
SearchSubTree boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

最大相对深度
MaxRelativeDepth integer

要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。

匹配索引
MatchIndex integer

如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。

搜索筛选器
SearchFilter string

可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。

按列名称排序
SortByColumn string

如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。

匹配索引升序
MatchIndexAscending boolean

如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。

区分大小写的搜索
CaseSensitiveSearch boolean

元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。

仅搜索可见元素
OnlySearchVisibleElements boolean

是否应只搜索可见元素? 默认情况下,此值设置为 true。

仅显示元素的搜索
OnlySearchShowingElements boolean

是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。

不遍历的元素角色
ElementRolesNotToTraverse string

一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

要搜索的最大元素数
MaximumElementsToSearch integer

查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

每个节点要搜索的最大子元素数
MaximumChildElementsToSearchPerNode integer

查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

等待的秒数
SecondsToWait True double
如果元素仍然存在,则引发异常
RaiseExceptionIfElementStillExists boolean

如果 Java 元素在等待期后仍然存在,IA-Connect 是否应引发异常?

Workflow
Workflow True string

在此处添加以下表达式:workflow()

返回

名称 路径 类型 说明
元素在等待之前存在
ElementExistsBeforeWait boolean

如果元素在等待之前存在,则返回 true;否则返回 false。

等待后存在元素
ElementExistsAfterWait boolean

如果元素在等待后存在,则返回 true;否则返回 false。

等待 Java 桌面元素

等待 Java 桌面元素(通常是窗口)存在。

参数

名称 密钥 必需 类型 说明
搜索 UIA 元素名称
SearchUIAElementName string

要搜索的可选 UIA 元素名称(从父窗口句柄开始)。 可以通过检查发现这一点。

搜索 UIA 元素类名
SearchUIAElementClassName string

要搜索的可选 UIA 元素类名(从父窗口句柄开始)。 可以通过检查发现这一点。

搜索 UIA 元素本地化控件类型
SearchUIAElementLocalizedControlType string

要搜索的可选 UIA 元素本地化控件类型(从父窗口句柄开始)。 可以通过检查发现这一点。

搜索进程 ID
SearchProcessID integer

正在运行的进程的进程 ID。 这可以作为“运行进程”作的输出进行检索。

搜索子元素
SearchChildElements boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

匹配索引
MatchIndex integer

如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。

搜索筛选器
SearchFilter string

可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。

按列名称排序
SortByColumn string

如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。

匹配索引升序
MatchIndexAscending boolean

如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。

等待的秒数
SecondsToWait True double

等待元素存在的最大秒数。

包括子进程
IncludeChildProcesses boolean

如果设置为 true 并且指定了“搜索进程 ID”,则搜索中将包含该进程 ID 的子进程。 这通常适用于 Java,因为启动器 EXE 通常会运行子级“Java(w).exe”进程。 如果设置为 false,则仅返回与确切的“搜索进程 ID”匹配的进程。

如果未找到元素,引发异常
RaiseExceptionIfElementNotFound boolean

如果等待期后 Java 元素不存在,IA-Connect 是否应引发异常?

Workflow
Workflow True string

在此处添加以下表达式:workflow()

返回

名称 路径 类型 说明
元素存在
ElementExists boolean

如果元素存在,则返回 true;否则返回 false。

元素 JAB 句柄
ElementJABHandle integer

如果找到搜索元素,这将保存一个数字元素句柄,该句柄可用于进一步作以充当“父”句柄进行进一步搜索(即查找相对于此句柄的元素)。

元素名称
ElementName string

定位元素的 Java 名称。

元素说明
ElementDescription string

定位元素的 Java 说明(如果有)。

元素角色
ElementRole string

定位元素的 Java 角色(例如框架或面板)(如果有)。

等待 Java 桌面元素不存在

等待 Java 桌面元素(通常是窗口)不再存在。

参数

名称 密钥 必需 类型 说明
搜索 UIA 元素名称
SearchUIAElementName string

要搜索的可选 UIA 元素名称(从父窗口句柄开始)。 可以通过检查发现这一点。

搜索 UIA 元素类名
SearchUIAElementClassName string

要搜索的可选 UIA 元素类名(从父窗口句柄开始)。 可以通过检查发现这一点。

搜索 UIA 元素本地化控件类型
SearchUIAElementLocalizedControlType string

要搜索的可选 UIA 元素本地化控件类型(从父窗口句柄开始)。 可以通过检查发现这一点。

搜索进程 ID
SearchProcessID integer

正在运行的进程的进程 ID。 这可以作为“运行进程”作的输出进行检索。

搜索子元素
SearchChildElements boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

匹配索引
MatchIndex integer

如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。

搜索筛选器
SearchFilter string

可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。

按列名称排序
SortByColumn string

如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。

匹配索引升序
MatchIndexAscending boolean

如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。

等待的秒数
SecondsToWait True double

等待元素不存在的最大秒数。

包括子进程
IncludeChildProcesses boolean

如果设置为 true 并且指定了“搜索进程 ID”,则搜索中将包含该进程 ID 的子进程。 这通常适用于 Java,因为启动器 EXE 通常会运行子级“Java(w).exe”进程。 如果设置为 false,则仅返回与确切的“搜索进程 ID”匹配的进程。

如果元素仍然存在,则引发异常
RaiseExceptionIfElementStillExists boolean

如果 Java 元素在等待期后仍然存在,IA-Connect 是否应引发异常?

Workflow
Workflow True string

在此处添加以下表达式:workflow()

返回

名称 路径 类型 说明
元素在等待之前存在
ElementExistsBeforeWait boolean

如果元素在等待之前存在,则返回 true;否则返回 false。

等待后存在元素
ElementExistsAfterWait boolean

如果元素在等待后存在,则返回 true;否则返回 false。

获取 Java 元素值

返回元素的值。 值通常与文本输入区域相关联,但许多元素可以具有此属性。

参数

名称 密钥 必需 类型 说明
父元素 JAB 句柄
SearchParentElementJABHandle True integer

Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。

搜索 Java 元素名称
SearchElementJABName string

要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。

搜索 Java 元素说明
SearchElementJABDescription string

要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。

搜索 Java 元素角色
SearchElementJABRole string

要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。

搜索子元素
SearchSubTree boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

最大相对深度
MaxRelativeDepth integer

要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。

匹配索引
MatchIndex integer

如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。

搜索筛选器
SearchFilter string

可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。

按列名称排序
SortByColumn string

如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。

匹配索引升序
MatchIndexAscending boolean

如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。

区分大小写的搜索
CaseSensitiveSearch boolean

元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。

仅搜索可见元素
OnlySearchVisibleElements boolean

是否应只搜索可见元素? 默认情况下,此值设置为 true。

仅显示元素的搜索
OnlySearchShowingElements boolean

是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。

不遍历的元素角色
ElementRolesNotToTraverse string

一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

要搜索的最大元素数
MaximumElementsToSearch integer

查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

每个节点要搜索的最大子元素数
MaximumChildElementsToSearchPerNode integer

查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

返回

名称 路径 类型 说明
元素当前值
ElementCurrentValue string

元素的当前值。

元素最大值
ElementMaximumValue string

元素的最大值(如果指定)。

元素最小值
ElementMinimumValue string

元素的最小值(如果指定)。

获取 Java 元素属性

返回 Java 元素的所有 Java 属性。 如果不确定哪些字段包含所需的属性值,这可能很有用。

参数

名称 密钥 必需 类型 说明
父元素 JAB 句柄
SearchParentElementJABHandle True integer

Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。

搜索 Java 元素名称
SearchElementJABName string

要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。

搜索 Java 元素说明
SearchElementJABDescription string

要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。

搜索 Java 元素角色
SearchElementJABRole string

要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。

搜索子元素
SearchSubTree boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

最大相对深度
MaxRelativeDepth integer

要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。

匹配索引
MatchIndex integer

如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。

搜索筛选器
SearchFilter string

可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。

按列名称排序
SortByColumn string

如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。

匹配索引升序
MatchIndexAscending boolean

如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。

区分大小写的搜索
CaseSensitiveSearch boolean

元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。

仅搜索可见元素
OnlySearchVisibleElements boolean

是否应只搜索可见元素? 默认情况下,此值设置为 true。

仅显示元素的搜索
OnlySearchShowingElements boolean

是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。

不遍历的元素角色
ElementRolesNotToTraverse string

一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

要搜索的最大元素数
MaximumElementsToSearch integer

查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

每个节点要搜索的最大子元素数
MaximumChildElementsToSearchPerNode integer

查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

最大字符串长度
MaxStringLength integer

说明字段的最大长度。 这有时可能包含大量文本,因此设置最大值可以提高搜索速度。 默认情况下,没有最大字符串长度,因此将返回完整说明。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

返回

名称 路径 类型 说明
元素 JAB 句柄
ElementJABHandle integer

如果找到搜索元素,这将保存一个数字元素句柄,该句柄可用于进一步作以充当“父”句柄进行进一步搜索(即查找相对于此句柄的元素)。

元素 VMID
ElementVMID integer

运行 Java 程序的 Java 虚拟机的 ID。

元素名称
ElementName string

定位元素的 Java 名称。

元素说明
ElementDescription string

定位元素的 Java 说明(如果有)。

元素角色
ElementRole string

定位元素的 Java 角色(例如框架或面板)(如果有)。

元素状态
ElementStates string

代理会话的区域设置中 Java 元素支持的状态(例如可聚焦且可见)。

元素状态en_US
ElementStates_en_US string

en_US区域设置中 Java 元素支持的状态(例如可聚焦、可见)。

元素左边缘
ElementLeftEdge integer

Java 元素或窗口左边缘与显示左边缘之间的距离(以像素为单位)。

元素上边缘
ElementTopEdge integer

Java 元素或窗口上边缘与显示上边缘之间的距离(以像素为单位)。

元素宽度
ElementWidth integer

Java 元素的宽度(以像素为单位)。

元素高度
ElementHeight integer

Java 元素的高度(以像素为单位)。

元素右边缘
ElementRightEdge integer

Java 元素或窗口右边缘与显示左边缘之间的距离(以像素为单位)。

元素下边缘
ElementBottomEdge integer

Java 元素或窗口的下边缘与显示上边缘之间的距离(以像素为单位)。

是组件元素
IsComponentElement boolean

如果 Java 元素是容器,则返回 true;否则返回 false。

Is action 元素
IsActionElement boolean

如果 Java 元素是作元素,则返回 true;否则返回 false。

是选择元素
IsSelectionElement boolean

如果 Java 元素是选定内容,则返回 true;否则返回 false。

文本元素
IsTextElement boolean

如果 Java 元素是文本元素,则返回 true;否则返回 false。

已启用
IsEnabled boolean

如果启用 Java 元素,则返回 true;否则返回 false。 禁用的元素通常可见,但无法与之交互。

可见
IsVisible boolean

如果 Java 元素可见,则返回 true;否则返回 false。

正在显示
IsShowing boolean

如果 Java 元素显示,则返回 true;否则返回 false。

不透明
IsOpaque boolean

如果 Java 元素不透明,则返回 true;否则返回 false。

可聚焦
IsFocusable boolean

如果 Java 元素由键盘聚焦,则返回 true;否则返回 false。 这可能是有限的使用,因为大多数元素都是键盘可聚焦的。

可编辑
IsEditable boolean

如果 Java 元素是可编辑的,则返回 true;否则返回 false。

是单行
IsSingleLine boolean

如果 Java 元素是单行,则返回 true;否则返回 false。

可调整大小
IsResizable boolean

如果 Java 元素可调整大小,则返回 true;否则返回 false。

模式
IsModal boolean

如果 Java 元素为模式,则返回 true;否则返回 false。 模式元素将阻止主应用程序窗口,从而阻止你与其交互。

折叠
IsCollapsed boolean

如果 Java 元素已折叠,则返回 true;否则返回 false。

可选择
IsSelectable boolean

如果 Java 元素是可选择的,则返回 true;否则返回 false。

已选择
IsSelected boolean

如果选择 Java 元素,则返回 true;否则返回 false。

垂直
IsVertical boolean

如果 Java 元素为垂直,则返回 true;否则返回 false。

水平
IsHorizontal boolean

如果 Java 元素是水平元素,则返回 true;否则返回 false。

处于活动状态
IsActive boolean

如果 Java 元素处于活动状态,则返回 true;否则返回 false。

已选中
IsChecked boolean

如果选中 Java 元素,则返回 true;否则返回 false。

重点
IsFocussed boolean

如果 Java 元素具有键盘焦点,则返回 true。 如果不是,则为 false。

已展开
IsExpanded boolean

如果 Java 元素已展开,则返回 true;否则返回 false。

其他元素状态en_US
AdditionalStates_en_US string

元素支持的任何其他状态都将列在en_US区域设置中,例如多选的暂时性状态。

父级索引
IndexInParent integer

当前父元素中的元素索引。

元素子计数
ChildrenCount integer

元素具有的子元素数。

元素深度
ElementDepth integer

顶级父窗口中元素的深度。

获取 Java 元素文本值

返回 Java 元素的文本值。 文本值通常与文本元素相关联,但许多元素可以具有此属性。

参数

名称 密钥 必需 类型 说明
父元素 JAB 句柄
SearchParentElementJABHandle True integer

Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。

搜索 Java 元素名称
SearchElementJABName string

要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。

搜索 Java 元素说明
SearchElementJABDescription string

要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。

搜索 Java 元素角色
SearchElementJABRole string

要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。

搜索子元素
SearchSubTree boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

最大相对深度
MaxRelativeDepth integer

要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。

匹配索引
MatchIndex integer

如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。

搜索筛选器
SearchFilter string

可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。

按列名称排序
SortByColumn string

如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。

匹配索引升序
MatchIndexAscending boolean

如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。

区分大小写的搜索
CaseSensitiveSearch boolean

元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。

仅搜索可见元素
OnlySearchVisibleElements boolean

是否应只搜索可见元素? 默认情况下,此值设置为 true。

仅显示元素的搜索
OnlySearchShowingElements boolean

是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。

不遍历的元素角色
ElementRolesNotToTraverse string

一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

要搜索的最大元素数
MaximumElementsToSearch integer

查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

每个节点要搜索的最大子元素数
MaximumChildElementsToSearchPerNode integer

查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

返回

名称 路径 类型 说明
元素文本值
ElementTextValue string

元素的文本值。

获取 Java 元素的作

返回 Java 元素的可访问作。 然后,可以使用作名称作为作“对 Java 元素执行作”的作(例如“click”或“select-all”)的输入,对元素执行这些可访问作。

参数

名称 密钥 必需 类型 说明
父元素 JAB 句柄
SearchParentElementJABHandle True integer

Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。

搜索 Java 元素名称
SearchElementJABName string

要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。

搜索 Java 元素说明
SearchElementJABDescription string

要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。

搜索 Java 元素角色
SearchElementJABRole string

要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。

搜索子元素
SearchSubTree boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

最大相对深度
MaxRelativeDepth integer

要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。

匹配索引
MatchIndex integer

如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。

搜索筛选器
SearchFilter string

可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。

按列名称排序
SortByColumn string

如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。

匹配索引升序
MatchIndexAscending boolean

如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。

区分大小写的搜索
CaseSensitiveSearch boolean

元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。

仅搜索可见元素
OnlySearchVisibleElements boolean

是否应只搜索可见元素? 默认情况下,此值设置为 true。

仅显示元素的搜索
OnlySearchShowingElements boolean

是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。

不遍历的元素角色
ElementRolesNotToTraverse string

一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

要搜索的最大元素数
MaximumElementsToSearch integer

查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

每个节点要搜索的最大子元素数
MaximumChildElementsToSearchPerNode integer

查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

返回

名称 路径 类型 说明
辅助作
AccessibleActions string

搜索元素的所有可访问作的列表,例如“click”。

获取 Java 元素的可见边界矩形

检索 Java 元素的可见边界。 通常,Java Access Bridge 将返回元素的虚拟位置值,无论该元素在屏幕上是否可见,这些虚拟值都由“获取 Java 元素属性”作提供。 对于较大的元素(例如可滚动的表元素),因为这些元素可能并不总是在屏幕上可见,此作将返回元素当前可见区域的坐标。

参数

名称 密钥 必需 类型 说明
元素 JAB 句柄
ElementJABHandle True integer

要为其返回可见边界的元素的元素句柄。 这可以使用“获取 Java 元素属性”或其他返回元素句柄的其他搜索找到。

要处理的最大父级数
MaxParentsToProcess integer

计算指定元素的可见大小时要处理的父元素的最大数目。 默认情况下,此值设置为 50。

要考虑的父元素角色
ParentElementRolesToConsider string

计算元素大小时要考虑的父元素的角色。 这用于排除小于可倾斜大小计算的元素(例如页面选项卡)的父元素。 默认情况下,这些为:面板、视区、分层窗格、根窗格。

绘制矩形
DrawRectangle boolean

是否 IA-Connect 在元素周围绘制一个矩形,以便在屏幕上可见? 默认情况下,此值设置为 false。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

返回

名称 路径 类型 说明
元素可见矩形左侧
ElementVisibleRectangleLeft integer

元素的可见左边缘和显示左边缘之间的距离(以像素为单位)。

元素可见矩形顶部
ElementVisibleRectangleTop integer

元素的可见上边缘与显示上边缘之间的距离(以像素为单位)。

元素右侧可见矩形
ElementVisibleRectangleRight integer

元素的可见右边缘和显示器左边缘之间的距离(以像素为单位)。

元素可见矩形底部
ElementVisibleRectangleBottom integer

元素的可见下边缘与显示上边缘之间的距离(以像素为单位)。

元素可见矩形宽度
ElementVisibleRectangleWidth integer

元素的可见宽度(以像素为单位)。

元素可见矩形高度
ElementVisibleRectangleHeight integer

元素的可见高度(以像素为单位)。

获取 Java 子元素属性

返回由索引指定的特定 Java 子元素的所有属性。 如果不确定哪些字段包含所需的属性值,这可能很有用。

参数

名称 密钥 必需 类型 说明
Search 元素 JAB 句柄
SearchElementJABHandle True integer

要为其返回子元素属性的元素的元素句柄。 这可以使用“获取 Java 元素属性”或其他返回元素句柄的其他搜索找到。

搜索子索引
SearchChildIndex True integer
最大字符串长度
MaxStringLength integer

说明字段的最大长度。 这有时可能包含大量文本,因此设置最大值可以提高搜索速度。 默认情况下,没有最大字符串长度,因此将返回完整说明。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

返回

名称 路径 类型 说明
元素 JAB 句柄
ElementJABHandle integer

如果找到搜索元素,这将保存一个数字元素句柄,该句柄可用于进一步作以充当“父”句柄进行进一步搜索(即查找相对于此句柄的元素)。

元素 VMID
ElementVMID integer

运行 Java 程序的 Java 虚拟机的 ID。

元素名称
ElementName string

定位元素的 Java 名称。

元素说明
ElementDescription string

定位元素的 Java 说明(如果有)。

元素角色
ElementRole string

定位元素的 Java 角色(例如框架或面板)(如果有)。

元素状态
ElementStates string

代理会话的区域设置中 Java 元素支持的状态(例如可聚焦且可见)。

元素状态en_US
ElementStates_en_US string

en_US区域设置中 Java 元素支持的状态(例如可聚焦、可见)。

元素左边缘
ElementLeftEdge integer

Java 元素或窗口左边缘与显示左边缘之间的距离(以像素为单位)。

元素上边缘
ElementTopEdge integer

Java 元素或窗口上边缘与显示上边缘之间的距离(以像素为单位)。

元素右边缘
ElementRightEdge integer

Java 元素或窗口右边缘与显示左边缘之间的距离(以像素为单位)。

元素下边缘
ElementBottomEdge integer

Java 元素或窗口的下边缘与显示上边缘之间的距离(以像素为单位)。

元素宽度
ElementWidth integer

Java 元素的宽度(以像素为单位)。

元素高度
ElementHeight integer

Java 元素的高度(以像素为单位)。

是组件元素
IsComponentElement boolean

如果 Java 元素是容器,则返回 true;否则返回 false。

Is action 元素
IsActionElement boolean

如果 Java 元素是作元素,则返回 true;否则返回 false。

是选择元素
IsSelectionElement boolean

如果 Java 元素是选定内容,则返回 true;否则返回 false。

文本元素
IsTextElement boolean

如果 Java 元素是文本元素,则返回 true;否则返回 false。

已启用
IsEnabled boolean

如果启用 Java 元素,则返回 true;否则返回 false。 禁用的元素通常可见,但无法与之交互。

可见
IsVisible boolean

如果 Java 元素可见,则返回 true;否则返回 false。

正在显示
IsShowing boolean

如果 Java 元素显示,则返回 true;否则返回 false。

不透明
IsOpaque boolean

如果 Java 元素不透明,则返回 true;否则返回 false。

可聚焦
IsFocusable boolean

如果 Java 元素由键盘聚焦,则返回 true;否则返回 false。 这可能是有限的使用,因为大多数元素都是键盘可聚焦的。

可编辑
IsEditable boolean

如果 Java 元素是可编辑的,则返回 true;否则返回 false。

是单行
IsSingleLine boolean

如果 Java 元素是单行,则返回 true;否则返回 false。

可调整大小
IsResizable boolean

如果 Java 元素可调整大小,则返回 true;否则返回 false。

模式
IsModal boolean

如果 Java 元素为模式,则返回 true;否则返回 false。 模式元素将阻止主应用程序窗口,从而阻止你与其交互。

折叠
IsCollapsed boolean

如果 Java 元素已折叠,则返回 true;否则返回 false。

可选择
IsSelectable boolean

如果 Java 元素是可选择的,则返回 true;否则返回 false。

已选择
IsSelected boolean

如果选择 Java 元素,则返回 true;否则返回 false。

垂直
IsVertical boolean

如果 Java 元素为垂直,则返回 true;否则返回 false。

水平
IsHorizontal boolean

如果 Java 元素是水平元素,则返回 true;否则返回 false。

处于活动状态
IsActive boolean

如果 Java 元素处于活动状态,则返回 true;否则返回 false。

已选中
IsChecked boolean

如果选中 Java 元素,则返回 true;否则返回 false。

重点
IsFocussed boolean

如果 Java 元素具有键盘焦点,则返回 true。 如果不是,则为 false。

已展开
IsExpanded boolean

如果 Java 元素已展开,则返回 true;否则返回 false。

其他元素状态en_US
AdditionalStates_en_US string

元素支持的任何其他状态都将列在en_US区域设置中,例如多选的暂时性状态。

父级索引
IndexInParent integer

当前父元素中的元素索引。

元素子计数
ChildrenCount integer

元素具有的子元素数。

元素深度
ElementDepth integer

顶级父窗口中元素的深度。

获取 Java 桌面元素

返回桌面上的 Java 应用程序窗口和对话框的列表。 必须首先连接到 Java 访问桥。

参数

名称 密钥 必需 类型 说明
搜索元素本地化控件类型
SearchElementLocalizedControlType string

要搜索的可选 UIA 元素本地化控件类型(从父窗口句柄开始)。 可以通过检查发现这一点。

搜索进程 ID
SearchProcessID integer

正在运行的进程的进程 ID。 这可以作为“运行进程”作的输出进行检索。

要返回的第一个项目
FirstItemToReturn integer

要返回的第一项的元素索引,从 1 开始。 如果要按反向顺序返回元素(从树底),也可以指定从 -1 开始的负索引。 例如,-10 的索引将从底部返回第十项。

要返回的最大项数
MaxItemsToReturn integer

要返回的最大元素数。 此参数可用于返回较小区块中的大型元素集,例如大型表。 可以一次返回 500 行,而不是尝试返回可能导致异常大型表超时的整个表。

搜索子元素
SearchChildElements boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

最大字符串长度
MaxStringLength integer

说明字段的最大长度。 这有时可能包含大量文本,因此设置最大值可以提高搜索速度。 默认情况下,没有最大字符串长度,因此将返回完整说明。

包括子进程
IncludeChildProcesses boolean

如果设置为 true 并且指定了“搜索进程 ID”,则搜索中将包含该进程 ID 的子进程。 这通常适用于 Java,因为启动器 EXE 通常会运行子级“Java(w).exe”进程。 如果设置为 false,则仅返回与确切的“搜索进程 ID”匹配的进程。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

返回

名称 路径 类型 说明
找到的元素数
NumberOfElementsFound integer

找到满足搜索条件的元素数。

返回的元素数
NumberOfElementsReturned integer

从搜索返回的元素数。 如果“要返回的最大项数”设置为较低的数字,则这可能小于找到的元素数。

Java 桌面元素 JSON
JavaDesktopElementsJSON string

Java 桌面元素的元素属性以 JSON 格式找到与搜索条件匹配。

获取 Java 父元素属性

返回 Java 元素的父元素的属性。 此作将仅返回直接父元素的属性,并且不会搜索元素树的整个高度。

参数

名称 密钥 必需 类型 说明
Search 元素 JAB 句柄
SearchElementJABHandle True integer

要为其返回父元素属性的元素的元素句柄。 这可以使用“获取 Java 元素属性”或其他返回元素句柄的其他搜索找到。

最大字符串长度
MaxStringLength integer

说明字段的最大长度。 这有时可能包含大量文本,因此设置最大值可以提高搜索速度。 默认情况下,没有最大字符串长度,因此将返回完整说明。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

返回

名称 路径 类型 说明
元素 JAB 句柄
ElementJABHandle integer

如果找到搜索元素,这将保存一个数字元素句柄,该句柄可用于进一步作以充当“父”句柄进行进一步搜索(即查找相对于此句柄的元素)。

元素 VMID
ElementVMID integer

运行 Java 程序的 Java 虚拟机的 ID。

元素名称
ElementName string

定位元素的 Java 名称。

元素说明
ElementDescription string

定位元素的 Java 说明(如果有)。

元素角色
ElementRole string

定位元素的 Java 角色(例如框架或面板)(如果有)。

元素状态
ElementStates string

代理会话的区域设置中 Java 元素支持的状态(例如可聚焦且可见)。

元素状态en_US
ElementStates_en_US string

en_US区域设置中 Java 元素支持的状态(例如可聚焦、可见)。

元素左边缘
ElementLeftEdge integer

Java 元素或窗口左边缘与显示左边缘之间的距离(以像素为单位)。

元素上边缘
ElementTopEdge integer

Java 元素或窗口上边缘与显示上边缘之间的距离(以像素为单位)。

元素右边缘
ElementRightEdge integer

Java 元素或窗口右边缘与显示左边缘之间的距离(以像素为单位)。

元素下边缘
ElementBottomEdge integer

Java 元素或窗口的下边缘与显示上边缘之间的距离(以像素为单位)。

元素宽度
ElementWidth integer

Java 元素的宽度(以像素为单位)。

元素高度
ElementHeight integer

Java 元素的高度(以像素为单位)。

是组件元素
IsComponentElement boolean

如果 Java 元素是容器,则返回 true;否则返回 false。

Is action 元素
IsActionElement boolean

如果 Java 元素是作元素,则返回 true;否则返回 false。

是选择元素
IsSelectionElement boolean

如果 Java 元素是选定内容,则返回 true;否则返回 false。

文本元素
IsTextElement boolean

如果 Java 元素是文本元素,则返回 true;否则返回 false。

已启用
IsEnabled boolean

如果启用 Java 元素,则返回 true;否则返回 false。 禁用的元素通常可见,但无法与之交互。

可见
IsVisible boolean

如果 Java 元素可见,则返回 true;否则返回 false。

正在显示
IsShowing boolean

如果 Java 元素显示,则返回 true;否则返回 false。

不透明
IsOpaque boolean

如果 Java 元素不透明,则返回 true;否则返回 false。

可聚焦
IsFocusable boolean

如果 Java 元素由键盘聚焦,则返回 true;否则返回 false。 这可能是有限的使用,因为大多数元素都是键盘可聚焦的。

可编辑
IsEditable boolean

如果 Java 元素是可编辑的,则返回 true;否则返回 false。

是单行
IsSingleLine boolean

如果 Java 元素是单行,则返回 true;否则返回 false。

可调整大小
IsResizable boolean

如果 Java 元素可调整大小,则返回 true;否则返回 false。

模式
IsModal boolean

如果 Java 元素为模式,则返回 true;否则返回 false。 模式元素将阻止主应用程序窗口,从而阻止你与其交互。

折叠
IsCollapsed boolean

如果 Java 元素已折叠,则返回 true;否则返回 false。

可选择
IsSelectable boolean

如果 Java 元素是可选择的,则返回 true;否则返回 false。

已选择
IsSelected boolean

如果选择 Java 元素,则返回 true;否则返回 false。

垂直
IsVertical boolean

如果 Java 元素为垂直,则返回 true;否则返回 false。

水平
IsHorizontal boolean

如果 Java 元素是水平元素,则返回 true;否则返回 false。

处于活动状态
IsActive boolean

如果 Java 元素处于活动状态,则返回 true;否则返回 false。

已选中
IsChecked boolean

如果选中 Java 元素,则返回 true;否则返回 false。

重点
IsFocussed boolean

如果 Java 元素具有键盘焦点,则返回 true。 如果不是,则为 false。

已展开
IsExpanded boolean

如果 Java 元素已展开,则返回 true;否则返回 false。

其他元素状态en_US
AdditionalStates_en_US string

元素支持的任何其他状态都将列在en_US区域设置中,例如多选的暂时性状态。

父级索引
IndexInParent integer

当前父元素中的元素索引。

元素子计数
ChildrenCount integer

元素具有的子元素数。

元素深度
ElementDepth integer

顶级父窗口中元素的深度。

获取 Java 表内容

返回 Java 表元素的内容。 这是包含行、列、标题和单元格(即表)的元素。

参数

名称 密钥 必需 类型 说明
父元素 JAB 句柄
SearchParentElementJABHandle True integer

Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。

搜索 Java 元素名称
SearchElementJABName string

要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。

搜索 Java 元素说明
SearchElementJABDescription string

要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。

搜索 Java 元素角色
SearchElementJABRole string

要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。

搜索子元素
SearchSubTree boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

最大相对深度
MaxRelativeDepth integer

要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。

匹配索引
MatchIndex integer

如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。

搜索筛选器
SearchFilter string

可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。

按列名称排序
SortByColumn string

如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。

匹配索引升序
MatchIndexAscending boolean

如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。

区分大小写的搜索
CaseSensitiveSearch boolean

元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。

仅搜索可见元素
OnlySearchVisibleElements boolean

是否应只搜索可见元素? 默认情况下,此值设置为 true。

仅显示元素的搜索
OnlySearchShowingElements boolean

是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。

不遍历的元素角色
ElementRolesNotToTraverse string

一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

要搜索的最大元素数
MaximumElementsToSearch integer

查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

每个节点要搜索的最大子元素数
MaximumChildElementsToSearchPerNode integer

查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

要返回的第一行
FirstRowToReturn integer

要返回的第一行的索引。 默认情况下,此值设置为 1。

要返回的最大行数
MaxRowsToReturn integer

要返回的最大行数。 默认情况下,返回所有行。

要返回的第一列
FirstColumnToReturn integer

要返回的第一列的索引。 默认情况下,此值设置为 1。

要返回的最大列数
MaxColumnsToReturn integer

要返回的最大列数。 默认情况下,返回所有列。

使用表中的列标题
UseColumnHeadersFromTable boolean

如果设置为“True”,则 IA-Connect 代理将尝试返回输出集合列以匹配 Java 表中的列名。 如果设置为“False”(默认值),则集合中的列标题将称为“Column_N”(因为集合不能有空名称)。

返回输出集合中的行索引
ReturnRowIndexInOutputCollection boolean

如果设置为“True”(默认值),则 IA-Connect Agent 会将输出集合中的行索引作为附加列返回。 默认情况下,行索引列将称为“Row_index”,但可以通过在“列名称”中传递列名来存储行索引“参数来更改此列名。 如果计划筛选输出集合并跟踪筛选结果与哪个行相关,这非常有用。 如果设置为“False”,则不返回行索引列。

要存储行索引的列的名称
NameOfColumnToStoreRowIndex string

如果“输出集合中的返回行索引”设置为“True”,则可以通过在此处提供值来替代默认列名“_Row_Index”。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

返回

名称 路径 类型 说明
表中的行数
NumberOfRowsInTable integer

表格的行数。

表中的列数
NumberOfColumnsInTable integer

表格的列数。

所选行数
NumberOfSelectedRows integer

当前选定的行数。

所选列数
NumberOfSelectedColumns integer

当前选择的列数。

返回的行数
NumberOfRowsReturned integer

返回的行数,如果“要返回的最大行数”设置为较低的数字,则返回的行数可能小于找到的行数。

返回的列数
NumberOfColumnsReturned integer

返回的列数,如果“要返回的最大列数”设置为较低的数字,则返回的列数可能小于找到的列数。

表内容 JSON
TableContentsJSON string

表元素的内容,采用 JSON 格式。 如果“使用表中的列标题”设置为 true,则此集合的列名将与表元素的列名匹配。 如果列名为空,则集合中将调用“Column_N”(因为集合不能有空名称)。 如果列名是重复的,它将将“_N”追加到名称(因为集合不能具有重复的列名)。

获取 Java 表单元格属性

返回 Java 表元素中指定单元格的属性和内容。 这是包含行、列、标题和单元格(即表)的元素。 可以选择性地指定是否通过枚举视区来确定单元格当前在屏幕上是否可见,以及该单元格是否为坐标。 视区元素通常包含表(例如它是表的父元素),并表示表的可见区域。

参数

名称 密钥 必需 类型 说明
父元素 JAB 句柄
SearchParentElementJABHandle True integer

Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。

搜索 Java 元素名称
SearchElementJABName string

要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。

搜索 Java 元素说明
SearchElementJABDescription string

要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。

搜索 Java 元素角色
SearchElementJABRole string

要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。

搜索子元素
SearchSubTree boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

最大相对深度
MaxRelativeDepth integer

要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。

匹配索引
MatchIndex integer

如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。

搜索筛选器
SearchFilter string

可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。

按列名称排序
SortByColumn string

如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。

匹配索引升序
MatchIndexAscending boolean

如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。

区分大小写的搜索
CaseSensitiveSearch boolean

元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。

仅搜索可见元素
OnlySearchVisibleElements boolean

是否应只搜索可见元素? 默认情况下,此值设置为 true。

仅显示元素的搜索
OnlySearchShowingElements boolean

是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。

不遍历的元素角色
ElementRolesNotToTraverse string

一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

要搜索的最大元素数
MaximumElementsToSearch integer

查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

每个节点要搜索的最大子元素数
MaximumChildElementsToSearchPerNode integer

查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

单元格行索引
RowIndex True integer

表中单元格的行索引,从 1 开始。

单元格列索引
ColumnIndex True integer

表中单元格的列索引,从 1 开始。

返回句柄
ReturnJABHandle boolean

如果设置为 true,则将返回单元格的元素句柄。

枚举视区
EnumerateViewport boolean

视区元素通常包含表,并表示表的可见区域。 如果设置为“True”(默认值),则 IA-Connect 代理将通过计算视区的大小来尝试检测表可见边界和每个角单元格的索引。 这使你可以确定表的哪些组件当前在屏幕上可见。 如果设置为“False”,则不会填充视区坐标。

处理视区父级
ProcessViewportParents boolean

如果设置为“True”(默认值),则还将处理视区父元素,以帮助优化视区可见大小。 如果它嵌入到另一个视区中,这非常有用。 如果设置为“False”,则不会处理视区父元素。

要处理的最大视区父级
MaxViewportParentsToProcess integer

枚举视区时要处理的父元素的最大数目。 默认情况下,此值设置为 50。

要考虑的视区父元素角色
ViewportParentElementRolesToConsider string

枚举以计算视区大小时要考虑的视区父元素的角色。 这用于排除大小小于视口的父元素,这些元素可能会倾斜大小计算,例如页面选项卡。 默认情况下,这些为:面板、视区、分层窗格、根窗格。

视区左边距
ViewportLeftMargin integer

枚举视区左内部边距。 此值可用于排除可能仅由单个像素或两个像素显示且几乎完全处于屏幕外的任何单元格。 默认情况下,此值设置为 2,仅当尝试影响 IA-Connect 代理返回的数据时,才应增加。

视区上边距
ViewportTopMargin integer

枚举视区顶部的内部边距。 此值可用于排除可能仅由单个像素或两个像素显示且几乎完全处于屏幕外的任何单元格。 默认情况下,此值设置为 2,仅当尝试影响 IA-Connect 代理返回的数据时,才应增加。

视区右边距
ViewportRightMargin integer

枚举视区的右内部边距。 此值可用于排除可能仅由单个像素或两个像素显示且几乎完全处于屏幕外的任何单元格。 默认情况下,此值设置为 2,仅当尝试影响 IA-Connect 代理返回的数据时,才应增加。

视区下边距
ViewportBottomMargin integer

枚举视区底部的内部边距。 此值可用于排除可能仅由单个像素或两个像素显示且几乎完全处于屏幕外的任何单元格。 默认情况下,此值设置为 2,仅当尝试影响 IA-Connect 代理返回的数据时,才应增加。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

返回

名称 路径 类型 说明
单元格索引
CellIndex integer

表中的单元格索引。 第一行中的第一个单元格的索引为 1,该行中每个单元格的索引将增加 1。 因此,在包含 5 行和 3 列的表中,第二行中的第一个单元格的索引为 4。

单元格行区
RowExtent integer

单元格跨越的行数。 这通常为 1,除非单元格跨多行合并。

单元格列盘区
ColumnExtent integer

单元格跨越的列数。 这通常为 1,除非单元格跨多个列合并。

已选择单元格
IsSelected boolean

返回 true,如果单元格当前处于选中状态,则返回 false。

单元格内容
CellContents string

单元格的内容。

单元格左边缘
CellLeftEdge integer

单元格元素的左边缘与显示左边缘之间的距离(以像素为单位)。

单元格上边缘
CellTopEdge integer

单元格元素的上边缘与显示上边缘之间的距离(以像素为单位)。

单元格右边缘
CellRightEdge integer

单元格元素的右边缘和显示左边缘之间的距离(以像素为单位)。

单元格下边缘
CellBottomEdge integer

单元格元素的下边缘与显示上边缘之间的距离(以像素为单位)。

单元格宽度
CellWidth integer

单元格元素的宽度(以像素为单位)。

单元格高度
CellHeight integer

单元格元素的高度(以像素为单位)。

单元格在屏幕上可见
CellOnscreen boolean

如果单元格在屏幕上可见,则返回 true;否则返回 false。

可见结果是肯定的
CellVisibleResultIsCertain boolean

如果“单元格在屏幕上可见”结果是确定的,则返回 true。 如果无法计算 4 个父表边界中的任何一个,则此值将设置为“False”。

单元格 JAB 句柄
CellJABHandle integer

表单元格的元素句柄。

获取 Java 表属性

返回 Java 表元素的属性。 这是包含行、列、标题和单元格(即表)的元素。 可以选择通过枚举视区来确定表的哪些组件当前在屏幕上可见。 视区元素通常包含表(例如它是表的父元素),并表示表的可见区域。

参数

名称 密钥 必需 类型 说明
父元素 JAB 句柄
SearchParentElementJABHandle True integer

Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。

搜索 Java 元素名称
SearchElementJABName string

要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。

搜索 Java 元素说明
SearchElementJABDescription string

要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。

搜索 Java 元素角色
SearchElementJABRole string

要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。

搜索子元素
SearchSubTree boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

最大相对深度
MaxRelativeDepth integer

要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。

匹配索引
MatchIndex integer

如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。

搜索筛选器
SearchFilter string

可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。

按列名称排序
SortByColumn string

如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。

匹配索引升序
MatchIndexAscending boolean

如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。

区分大小写的搜索
CaseSensitiveSearch boolean

元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。

仅搜索可见元素
OnlySearchVisibleElements boolean

是否应只搜索可见元素? 默认情况下,此值设置为 true。

仅显示元素的搜索
OnlySearchShowingElements boolean

是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。

不遍历的元素角色
ElementRolesNotToTraverse string

一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

要搜索的最大元素数
MaximumElementsToSearch integer

查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

每个节点要搜索的最大子元素数
MaximumChildElementsToSearchPerNode integer

查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

枚举视区
EnumerateViewport boolean

视区元素通常包含表,并表示表的可见区域。 如果设置为“True”(默认值),则 IA-Connect 代理将通过计算视区的大小来尝试检测表可见边界和每个角单元格的索引。 这使你可以确定表的哪些组件当前在屏幕上可见。 如果设置为“False”,则不会填充视区坐标。

处理视区父级
ProcessViewportParents boolean

如果设置为“True”(默认值),则还将处理视区父元素,以帮助优化视区可见大小。 如果它嵌入到另一个视区中,这非常有用。 如果设置为“False”,则不会处理视区父元素。

要处理的最大视区父级
MaxViewportParentsToProcess integer

枚举视区时要处理的父元素的最大数目。 默认情况下,此值设置为 50。

要考虑的视区父元素角色
ViewportParentElementRolesToConsider string

枚举以计算视区大小时要考虑的视区父元素的角色。 这用于排除大小小于视口的父元素,这些元素可能会倾斜大小计算,例如页面选项卡。 默认情况下,这些为:面板、视区、分层窗格、根窗格。

视区左边距
ViewportLeftMargin integer

枚举视区左内部边距。 此值可用于排除可能仅由单个像素或两个像素显示且几乎完全处于屏幕外的任何单元格。 默认情况下,此值设置为 2,仅当尝试影响 IA-Connect 代理返回的数据时,才应增加。

视区上边距
ViewportTopMargin integer

枚举视区顶部的内部边距。 此值可用于排除可能仅由单个像素或两个像素显示且几乎完全处于屏幕外的任何单元格。 默认情况下,此值设置为 2,仅当尝试影响 IA-Connect 代理返回的数据时,才应增加。

视区右边距
ViewportRightMargin integer

枚举视区的右内部边距。 此值可用于排除可能仅由单个像素或两个像素显示且几乎完全处于屏幕外的任何单元格。 默认情况下,此值设置为 2,仅当尝试影响 IA-Connect 代理返回的数据时,才应增加。

视区下边距
ViewportBottomMargin integer

枚举视区底部的内部边距。 此值可用于排除可能仅由单个像素或两个像素显示且几乎完全处于屏幕外的任何单元格。 默认情况下,此值设置为 2,仅当尝试影响 IA-Connect 代理返回的数据时,才应增加。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

返回

名称 路径 类型 说明
行数
NumberOfRows integer

表格的行数。

列数
NumberOfColumns integer

表格的列数。

所选行数
NumberOfSelectedRows integer

当前选定的行数。

所选列数
NumberOfSelectedColumns integer

当前选择的列数。

行标题中的行数
NumberOfRowsInRowHeader integer

行标题中的行数。 这通常为 0,因为表很少具有行标题。

列标题中的列数
NumberOfColumnsInColumnHeader integer

列标题中的列数。

视区位于
ViewportLocated boolean

如果视区已找到,则返回 true;否则返回 false。 如果这是“True”,则返回视区坐标。

视区左边缘
ViewportLeftEdge integer

视区元素的左边缘和显示器左边缘之间的距离(以像素为单位)。

视区上边缘
ViewportTopEdge integer

视区元素上边缘与显示器上边缘之间的距离(以像素为单位)。

视区宽度
ViewportWidth integer

视区元素的宽度(以像素为单位)。

视区高度
ViewportHeight integer

视区元素的高度(以像素为单位)。

视区右边缘
ViewportRightEdge integer

视区元素的右边缘和显示器左边缘之间的距离(以像素为单位)。

视区下边缘
ViewportBottomEdge integer

视区元素的下边缘与显示器上边缘之间的距离(以像素为单位)。

父级左上方可见单元格索引
TopLeftVisibleCellIndexInParent integer

表中左上角可见单元格的单元格索引。 第一行中的第一个单元格的索引为 1,该行中每个单元格的索引将增加 1。 因此,在包含 5 行和 3 列的表中,第二行中的第一个单元格的索引为 4。

左上方可见行索引
TopLeftVisibleCellRowIndex integer

表中左上方可见单元格的行索引。

左上可见列索引
TopLeftVisibleCellColumnIndex integer

表中左上方可见单元格的列索引。

父级右上方可见单元格索引
TopRightVisibleCellIndexInParent integer

表中右上可见单元格的单元格索引。 第一行中的第一个单元格的索引为 1,该行中每个单元格的索引将增加 1。 因此,在包含 5 行和 3 列的表中,第二行中的第一个单元格的索引为 4。

右上可见行索引
TopRightVisibleCellRowIndex integer

表中右上可见单元格的行索引。

右上可见列索引
TopRightVisibleCellColumnIndex integer

表中右上可见单元格的列索引。

父级左下可见单元格索引
BottomLeftVisibleCellIndexInParent integer

表中左下可见单元格的单元格索引。 第一行中的第一个单元格的索引为 1,该行中每个单元格的索引将增加 1。 因此,在包含 5 行和 3 列的表中,第二行中的第一个单元格的索引为 4。

左下可见行索引
BottomLeftVisibleCellRowIndex integer

表中左下可见单元格的行索引。

左下可见列索引
BottomLeftVisibleCellColumnIndex integer

表中左下可见单元格的列索引。

父级右下可见单元格索引
BottomRightVisibleCellIndexInParent integer

表中右下角可见单元格的单元格索引。 第一行中的第一个单元格的索引为 1,该行中每个单元格的索引将增加 1。 因此,在包含 5 行和 3 列的表中,第二行中的第一个单元格的索引为 4。

右下角可见行索引
BottomRightVisibleCellRowIndex integer

表中右下角可见单元格的行索引。

右下可见列索引
BottomRightVisibleCellColumnIndex integer

表中右下可见单元格的列索引。

最左侧可见的列索引
LeftmostVisibleColumnIndex integer

最左侧可见列的列索引。

最右侧可见的列索引
RightmostVisibleColumnIndex integer

最右侧可见列的列索引。

最顶部可见的行索引
TopmostVisibleRowIndex integer

最上面的可见行的行索引。

最底部可见的行索引
BottommostVisibleRowIndex integer

最底部可见行的行索引。

获取 Java 选择元素项

返回在指定 Java 选择元素下找到的所有子选择元素项。 可以选择通过循环选择、选择列表中的每个单独选项或读取所选内容的子元素的标签来检索选择元素选项。 如果选择通过读取所选内容的子元素的标签来检索选择元素选项,则可能需要先通过将“Expand first”参数作为“True”来展开所选内容,然后还可以选择关闭所选内容,同时提供“Collapse after”参数作为“True”。

参数

名称 密钥 必需 类型 说明
父元素 JAB 句柄
SearchParentElementJABHandle True integer

Java 元素句柄,它是要搜索的元素的父级。 这可能是之前使用“等待 Java 桌面元素”找到的窗口。

搜索 Java 元素名称
SearchElementJABName string

要搜索的元素的可选 Java 名称。 可以通过检查发现这一点。

搜索 Java 元素说明
SearchElementJABDescription string

要搜索的元素的可选 Java 元素说明。 可以通过检查发现这一点。

搜索 Java 元素角色
SearchElementJABRole string

要搜索的元素的可选 Java 元素角色。 可以通过检查发现这一点。

搜索子元素
SearchSubTree boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

最大相对深度
MaxRelativeDepth integer

要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。

匹配索引
MatchIndex integer

如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。

搜索筛选器
SearchFilter string

可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。

按列名称排序
SortByColumn string

如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。

匹配索引升序
MatchIndexAscending boolean

如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。

区分大小写的搜索
CaseSensitiveSearch boolean

元素搜索是否区分大小写? 设置为 True 时,将仅返回与确切字符串/文本搜索匹配的元素。 默认情况下,此值设置为 false。

仅搜索可见元素
OnlySearchVisibleElements boolean

是否应只搜索可见元素? 默认情况下,此值设置为 true。

仅显示元素的搜索
OnlySearchShowingElements boolean

是否应仅显示要搜索的元素? 显示元素通常是在备用选项卡或折叠菜单中显示的项目。 默认情况下,此值设置为 true。

不遍历的元素角色
ElementRolesNotToTraverse string

一个逗号分隔的角色列表,用于在搜索时不遍历(单步执行)。 搜索仍将检查元素是否与搜索条件匹配,但不会搜索任何子元素。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

要搜索的最大元素数
MaximumElementsToSearch integer

查找目标元素时要搜索的最大元素数,限制搜索仅检查 Java 树中找到的前 N 个元素数。 默认情况下,此值设置为 2000。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

每个节点要搜索的最大子元素数
MaximumChildElementsToSearchPerNode integer

查找目标元素时,要在每个元素中搜索的最大子元素数,限制搜索仅检查 Java 树中每个元素找到的前 N 个子元素数。 默认情况下,此值设置为 200。 此参数可用于优化元素搜索。 仅当“搜索子元素”输入参数设置为“True”时,才使用此参数。

通过选择获取选项列表
GetListOfOptionsBySelecting boolean

如果设置为“True”,则 IA-Connect 代理将尝试通过依次选择每个选项(在 JAB 中)获取所选内容中的所有选项的列表。 如果设置为“False”(默认值),则“通过读取标签获取选项列表”参数应设置为“True”,否则不会读取选项列表。

通过读取标签获取选项列表
GetListOfOptionsByReadingLabels boolean

如果设置为“True”,则 IA-Connect 代理将尝试通过读取子标签(在 JAB 树中)获取所选内容中所有选项的列表。 对于下拉列表,几乎肯定会需要将“Expand first”参数设置为“True”,因为在列表下拉列表之前不会公开子元素。 此外,将“Collapse after”参数设置为“True”以在之后关闭列表。 “通过选择获取选项列表”参数也应设置为“False”,否则将忽略此选项(因为无法通过这两种方法获取列表)。 如果设置为“False”(默认值),则“通过选择”参数获取选项列表应设置为“True”,否则不会读取选项列表。

首先展开
ExpandFirst boolean

如果设置为“true”,则在搜索列表项元素之前,该作将尝试展开列表。 这对于动态列表非常有用,因为在展开列表之前,可能不会创建其他列表项元素。 如果设置为 false(默认值),则列表将不会展开。

折叠后
CollapseAfter boolean

如果设置为 true,则在执行搜索后,列表将折叠。 如果设置为 false(默认值),则列表将不会折叠。

展开和折叠之间的秒数
SecondsBetweenExpandCollapse double

如果展开作和折叠作设置为“True”,则等待的秒数。 默认情况下,这是 0.05 (20 毫秒)。

要返回的最大列表项数
MaxListItemsToReturn integer

要返回的列表项的最大数目,默认情况下为 100。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

返回

名称 路径 类型 说明
所选项数
NumberOfSelectedItems integer

在当前选定的父选择元素下找到的子列表项数。

选择 1 名称
AccessibleSelection1Name string

第一个选定的子列表项的名称。

列表中的选择 1 索引
AccessibleSelection1IndexInParent integer

第一个选定子列表项列表中的索引。

所选项目 JSON
JABSelectionSelectedItemsJSON string

父选择元素的选定子列表项,采用 JSON 格式。

选择列表项 JSON
JABSelectionListItemsJSON string

父选择元素的所有子列表项,采用 JSON 格式。

获取 UIA 元素的 Java 属性

返回 UIA 元素的所有 Java 属性。 如果不确定哪些字段包含所需的属性值,这可能很有用。

参数

名称 密钥 必需 类型 说明
父窗口句柄
ParentWindowHandle True integer

要充当搜索起点的父 UIA 窗口句柄。 这可以通过使用 UIA作(如“等待桌面元素”或“等待元素”)进行检查来发现。

搜索元素名称
SearchElementName string

要搜索的可选 UIA 元素名称(从父窗口句柄开始)。 可以通过检查发现这一点。

Search 元素类名
SearchElementClassName string

要搜索的可选 UIA 元素类名(从父窗口句柄开始)。 可以通过检查发现这一点。

搜索元素自动化 ID
SearchElementAutomationId string

要搜索的可选 UIA 元素自动化 ID(从父窗口句柄开始)。 可以通过检查发现这一点。

搜索元素本地化控件类型
SearchLocalizedControlType string

要搜索的可选 UIA 元素本地化控件类型(从父窗口句柄开始)。 可以通过检查发现这一点。

搜索 UIA 子树
SearchSubTree boolean

如果设置为 true,则会搜索父窗口句柄下方的整个树。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,则只会搜索树中父窗口句柄下方的元素。

匹配索引
MatchIndex integer

如果多个元素与搜索匹配,则应匹配哪个元素(从 1 开始)。 可与“按列排序”一起使用,以选择匹配的排序顺序。

搜索筛选器
SearchFilter string

可选的高级筛选器,用于使用条件运算符和任何元素字段进一步限制搜索。 示例 1:[Width] < 200。 示例 2:[名称],如“Document*”和 [Role],如“Label*”。 有关更多示例,请参阅文档。

按列名称排序
SortByColumn string

如果多个元素与搜索匹配,则可以指定要排序依据的元素属性。 这将与“匹配索引”结合使用来选取所需的元素。 例如:如果“按列名排序”为 [TopEdge] 且“Match index”为 1,则最接近屏幕顶部的匹配元素将匹配。

匹配索引升序
MatchIndexAscending boolean

如果多个元素与搜索匹配,则应从排序列表的顶部(true)或排序列表底部的“匹配索引”匹配(false)。

最大字符串长度
MaxStringLength integer

说明字段的最大长度。 这有时可能包含大量文本,因此设置最大值可以提高搜索速度。 默认情况下,没有最大字符串长度,因此将返回完整说明。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

返回

名称 路径 类型 说明
元素 JAB 句柄
ElementJABHandle integer

如果找到搜索元素,这将保存一个数字元素句柄,该句柄可用于进一步作以充当“父”句柄进行进一步搜索(即查找相对于此句柄的元素)。

元素 VMID
ElementVMID integer

运行 Java 程序的 Java 虚拟机的 ID。

元素名称
ElementName string

定位元素的 Java 名称。

元素说明
ElementDescription string

定位元素的 Java 说明(如果有)。

元素角色
ElementRole string

定位元素的 Java 角色(例如框架或面板)(如果有)。

元素状态
ElementStates string

代理会话的区域设置中 Java 元素支持的状态(例如可聚焦且可见)。

元素状态en_US
ElementStates_en_US string

en_US区域设置中 Java 元素支持的状态(例如可聚焦、可见)。

元素左边缘
ElementLeftEdge integer

Java 元素或窗口左边缘与显示左边缘之间的距离(以像素为单位)。

元素上边缘
ElementTopEdge integer

Java 元素或窗口上边缘与显示上边缘之间的距离(以像素为单位)。

元素宽度
ElementWidth integer

Java 元素的宽度(以像素为单位)。

元素高度
ElementHeight integer

Java 元素的高度(以像素为单位)。

元素右边缘
ElementRightEdge integer

Java 元素或窗口右边缘与显示左边缘之间的距离(以像素为单位)。

元素下边缘
ElementBottomEdge integer

Java 元素或窗口的下边缘与显示上边缘之间的距离(以像素为单位)。

是组件元素
IsComponentElement boolean

如果 Java 元素是容器,则返回 true;否则返回 false。

Is action 元素
IsActionElement boolean

如果 Java 元素是作元素,则返回 true;否则返回 false。

是选择元素
IsSelectionElement boolean

如果 Java 元素是选定内容,则返回 true;否则返回 false。

文本元素
IsTextElement boolean

如果 Java 元素是文本元素,则返回 true;否则返回 false。

已启用
IsEnabled boolean

如果启用 Java 元素,则返回 true;否则返回 false。 禁用的元素通常可见,但无法与之交互。

可见
IsVisible boolean

如果 Java 元素可见,则返回 true;否则返回 false。

正在显示
IsShowing boolean

如果 Java 元素显示,则返回 true;否则返回 false。

不透明
IsOpaque boolean

如果 Java 元素不透明,则返回 true;否则返回 false。

可聚焦
IsFocusable boolean

如果 Java 元素由键盘聚焦,则返回 true;否则返回 false。 这可能是有限的使用,因为大多数元素都是键盘可聚焦的。

可编辑
IsEditable boolean

如果 Java 元素是可编辑的,则返回 true;否则返回 false。

是单行
IsSingleLine boolean

如果 Java 元素是单行,则返回 true;否则返回 false。

可调整大小
IsResizable boolean

如果 Java 元素可调整大小,则返回 true;否则返回 false。

模式
IsModal boolean

如果 Java 元素为模式,则返回 true;否则返回 false。 模式元素将阻止主应用程序窗口,从而阻止你与其交互。

折叠
IsCollapsed boolean

如果 Java 元素已折叠,则返回 true;否则返回 false。

可选择
IsSelectable boolean

如果 Java 元素是可选择的,则返回 true;否则返回 false。

已选择
IsSelected boolean

如果选择 Java 元素,则返回 true;否则返回 false。

垂直
IsVertical boolean

如果 Java 元素为垂直,则返回 true;否则返回 false。

水平
IsHorizontal boolean

如果 Java 元素是水平元素,则返回 true;否则返回 false。

处于活动状态
IsActive boolean

如果 Java 元素处于活动状态,则返回 true;否则返回 false。

已选中
IsChecked boolean

如果选中 Java 元素,则返回 true;否则返回 false。

重点
IsFocussed boolean

如果 Java 元素具有键盘焦点,则返回 true。 如果不是,则为 false。

已展开
IsExpanded boolean

如果 Java 元素已展开,则返回 true;否则返回 false。

其他元素状态en_US
AdditionalStates_en_US string

元素支持的任何其他状态都将列在en_US区域设置中,例如多选的暂时性状态。

父级索引
IndexInParent integer

当前父元素中的元素索引。

元素子计数
ChildrenCount integer

元素具有的子元素数。

元素深度
ElementDepth integer

顶级父窗口中元素的深度。

获取 Windows 访问网桥信息

返回有关特定 Java VM ID(包括 Java 和 Windows DLL 版本)的 Windows 访问桥(WAB)的信息。 Java VM ID 可以作为“获取 Java 元素属性”作的输出获取。

参数

名称 密钥 必需 类型 说明
虚拟机ID
VMID True integer

Java 虚拟机 ID。 这在所有 Java 虚拟机中都是唯一的。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

返回

名称 路径 类型 说明
Java 类版本
JavaClassVersion string

Java 类版本,例如“1.8.0_261”。

Java DLL 版本
JavaDLLVersion string

Java DLL 版本,例如“1.8.0_261”。

Windows DLL 版本
WinDLLVersion string

Windows DLL 版本,例如“1.8.0_261”。

VM 版本
VMVersion string

Java VM 版本,例如“1.8.0_261”。

获取 Windows 访问网桥连接状态

返回 IA-Connect 代理与 Windows 访问网桥(WAB)之间的连接的当前状态。 如果 IA-Connect 代理连接到 WAB,则相关详细信息将作为输出返回。

参数

名称 密钥 必需 类型 说明
Workflow
Workflow True string

在此处添加以下表达式:workflow()

返回

名称 路径 类型 说明
已连接的 WAB
Connected boolean

如果 IA-Connect 代理连接到 Windows 访问桥,则返回 true;否则返回 false。

WAB 连接类型
ConnectionType string

与 Windows 访问桥的连接类型,例如 COM 或 Native 和 32 位或 64 位。

WAB 64 位
IsWAB64bit boolean

如果 Windows 访问桥为 64 位,则返回 true;否则返回 false。

连接错误
ConnectionError string

连接错误(如果报告了连接错误)。

加载 IA-JavaAccessBridge COM DLL
LoadedIAJABDLL string

加载 IA-JavaAccessBridge COM DLL 的完整路径。

加载的 Windows 访问桥 DLL
LoadedWABDLL string

加载的 Windows 访问桥 DLL 的完整路径。

Windows Access Bridge DLL 版本
WABVersion string

加载的 Windows 访问桥 DLL 的版本。

获取多个 Java 父元素属性

返回 Java 元素的所有父元素的属性。 如果“要处理的最大父级”参数设置得足够高,此作将搜索返回所有父属性的元素树的整个高度。

参数

名称 密钥 必需 类型 说明
Search 元素 JAB 句柄
SearchElementJABHandle True integer

要为其返回所有父元素属性的元素的元素句柄。 这可以使用“获取 Java 元素属性”或其他返回元素句柄的其他搜索找到。

最大字符串长度
MaxStringLength integer

说明字段的最大长度。 这有时可能包含大量文本,因此设置最大值可以提高搜索速度。 默认情况下,没有最大字符串长度,因此将返回完整说明。

要处理的最大父级数
MaxParentsToProcess integer

要处理的父元素的最大数目。 默认情况下,此值设置为 50。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

返回

名称 路径 类型 说明
Java 父元素 JSON
JavaParentElementsJSON string

JSON 格式的所有定位父元素的列表(及其属性)。 返回的属性与“获取 Java 元素属性”作返回的属性相同。

返回的父元素数
NumberOfParentElementsReturned integer

从搜索返回的父元素数。

获取所有 Java 子元素属性

返回所有 Java 子元素的所有属性。 如果不确定哪些字段包含所需的属性值,这可能很有用。

参数

名称 密钥 必需 类型 说明
Search 元素 JAB 句柄
SearchElementJABHandle True integer

要为其返回子元素属性的元素的元素句柄。 这可以使用“获取 Java 元素属性”或其他返回元素句柄的其他搜索找到。

要返回的第一个项目
FirstItemToReturn integer

要返回的第一项的元素索引,从 1 开始。 如果要按反向顺序返回元素(从树底),也可以指定从 -1 开始的负索引。 例如,-10 的索引将从底部返回第十项。

要返回的最大项数
MaxItemsToReturn integer

要返回的最大元素数。 此参数可用于返回较小区块中的大型元素集,例如大型表。 可以一次返回 500 行,而不是尝试返回可能导致异常大型表超时的整个表。

最大字符串长度
MaxStringLength integer

说明字段的最大长度。 这有时可能包含大量文本,因此设置最大值可以提高搜索速度。 默认情况下,没有最大字符串长度,因此将返回完整说明。

搜索后代
SearchDescendants boolean

如果设置为 true,则会搜索父句柄下的所有子元素。 这是更彻底的,但可能需要更长的时间。 如果设置为 false,将只搜索父句柄的直接子元素。

搜索 Java 元素角色
SearchRole string

要搜索的子元素的可选 Java 元素角色。 可以通过检查发现这一点。

最大相对深度
MaxRelativeDepth integer

要从父元素中搜索子元素的最大相对深度。 直接子元素的深度值为 0。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

返回

名称 路径 类型 说明
返回的子元素数
NumberOfChildElementsReturned integer

从搜索返回的子元素数。

当前深度可用的更多元素
MoreElementsAvailableAtCurrentDepth boolean

如果当前深度上有更多的子元素未返回为“要返回的最大项”设置为较低的数字,则返回 true。

在较低深度上可用的更多元素
MoreElementsAvailableAtLowerDepths boolean

如果 Java 树的深度较低处有更多子元素可用,则返回 true;如果“要返回的最大项数”设置为较低的数字。

比最大深度更深的元素
MoreElementsDeeperThanMaxDepth boolean

如果 Java 树的最大深度下有更多的子元素可用,则返回 true,如果“最大相对深度”设置为较低的数字。

Java 子元素 JSON
JavaChildElementsJSON string

JSON 格式的所有定位子元素的列表(及其属性)。 返回的属性与“获取 Java 子元素属性”作返回的属性相同。

连接到 Java 访问网桥

启动 IA-Connect Java 子系统(IA-JavaAccessBridge),并将其连接到指定的 Java 访问桥 DLL(或留空搜索一个)。 必须先执行此步骤,然后才能自动执行 Java 应用程序。 此作还启用必须在运行任何 Java 应用程序之前启用的 Java 访问桥。

参数

名称 密钥 必需 类型 说明
Windows Access Bridge DLL 搜索文件夹
WindowsAccessBridgeDLLSearchFolder string

在运行代理的会话中指定包含 Windows Access Bridge DLL(Java 运行时的组件)的文件夹,或输入 Windows Access Bridge DLL 的完整文件名以强制使用该特定 DLL。 如果未提供路径,则将使用标准 Windows 搜索路径。

IA-JavaAccessBridge DLL 路径
IAJavaAccessBridgePath string

如果需要将 IA-JavaAccessBridge.dll COM DLL(IA-Connect 代理的内置组件)的位置托管在 EXE 外部(可能是由于安全允许列表)。 这可以是完整路径,也可以是相对于 IA-Connect 代理位置的路径。 例如,如果代理和 IA-JavaAccessBridge.dll COM DLL 都位于同一文件夹中,则只需传递 DLL 的文件名就足够了。

是 64 位 Windows 访问桥 DLL
Is64BitJABDLL boolean

是否使用 Windows 访问桥 DLL 64 位?

将 COM 用于 64 位 IA-JavaAccessBridge DLL
UseCOMFor64BitJABDLL boolean

如果尝试加载的 Windows 访问网桥 DLL 为 64 位,则应通过进程外 COM DLLSurrogate 运行,而不是从 IA-Connect 直接(内存中)调用。 默认情况下,此值设置为“True”。 如果阻止了 IA-JavaAccessBridge DLL,可以尝试取消选中此项。

启用 Java 访问网桥
EnableJavaAccessBridge boolean

是否应启用 Java 访问桥? 默认情况下,此值设置为“True”。

辅助功能文件路径
AccessibilityFilepath string

.accessibility.properties 文件的路径,用于控制是否启用 Java 访问桥。 如果未提供路径,则默认为 %USERPROFILE%.accessibility.properties。

命令超时(以秒为单位)
CommandTimeoutInSeconds integer

等待 IA-Connect 连接到 Java 访问桥的最大秒数。 默认情况下,这是 20 秒。

Workflow
Workflow True string

在此处添加以下表达式:workflow()

返回

名称 路径 类型 说明
加载的 Windows 访问桥 DLL
LoadedWindowsAccessBridgeDLL string

加载的 Windows Access Bridge DLL 的完整文件名。

重置所有 Java 元素句柄

重置当前由 IA-Connect 存储的所有 Java 元素句柄,如果已识别大量元素并存储了大量元素句柄,这非常有用。 在元素句柄数非常高(100,000+)的情况下,此作还可用于释放 RAM 使用情况。

参数

名称 密钥 必需 类型 说明
Workflow
Workflow True string

在此处添加以下表达式:workflow()