单击 Web 页面

在 Web 页面上单击或双击元素。

命令可用性: 本地 IBM RPA SaaS 和 IBM RPA

脚本语法

IBM RPA 的专有脚本语言具有类似于其他编程语言的语法。 该脚本语法在脚本文件中定义命令的语法。 您可以在 IBM RPA Studio的 脚本 方式下使用此语法。

webClick [--isdoubleclick(Boolean)] [--nowait(Boolean)] --selector(WebElementSelectors) --id(String) --name(String) --css(String) --linktext(String) --innertext(String) --tagname(String) --xpath(String) --class(String) --elementvalue(String) [--simulatehuman(Boolean)] [--timeout(TimeSpan)] (Boolean)=value

依赖关系

在使用单击 Web 页面 (webClick) 命令之前，请使用启动浏览器 (webStart) 命令来启动浏览器，或使用查找 Internet Explorer 浏览器 (findBrowser) 命令连接 Microsoft Internet Explorer。

输入参数

下表显示了此命令中提供的输入参数的列表。 在表中，您可以看到在 IBM RPA Studio的脚本方式及其 Designer 方式等效标签中工作时的参数名称。

设计器方式标签 脚本方式名称 必需的 接受的变量类型 Description
双击 isdoubleclick Optional Boolean 启用以在元素界面中进行双左键单击。
不等待 nowait Optional Boolean 启用以忽略超时。
搜索目标 selector Required WebElementSelectors 用于标识 Web 页面中元素的选择器类型。

请参阅 selector 参数选项。
标识 id Required when the Search for parameter is Id, IdAndName Text 包含标识属性值的文本，以与元素匹配并单击元素。
元素名称 name Required when the Search for parameter is Name, NameAndValue, IdAndName Text 包含名称属性值的文本，以与元素匹配并单击元素。
CSS css Required when the Search for parameter is CssSelector Text 包含 CSS 选择器的文本，以与元素匹配并单击元素。
链接文本 linktext Required when the Search for parameter is LinkText Text 包含链接文本值的文本，以与元素匹配并单击元素。
元素文本 innertext Required when the Search for parameter is InnerTextAndTag Text 包含元素文本内容的文本，以与元素匹配并单击元素。
标记名称 tagname Required when the Search for parameter is InnerTextAndTag Text 包含标记名称属性值的文本，以与元素匹配并单击元素。
XPath xpath Required when the Search for parameter is XPath Text 包含 XML 路径值的文本，以与元素匹配并单击元素。
类名 class Required when the Search for parameter is ClassAndValue Text 包含类属性值的文本，以与元素匹配并单击元素。
元素值 elementvalue Required when the Search for parameter is ClassAndValue, NameAndValue Text 包含值属性值的文本，以与元素匹配并单击元素。
模拟人类 simulatehuman Optional Boolean 通过将鼠标光标移动到元素的中间并单击该元素来模拟人类用户交互。

请参阅 simulatehuman 限制。
Timeout timeout Optional Time Span, Number, Text 运行命令时的最长等待时间。 如果为空白，那么缺省超时为 5 秒。

selector 参数选项

下表显示了可用于 selector 输入参数的选项。 该表显示了在脚本方式下工作时的可用选项以及在设计器方式下的等效标签。

设计器方式标签 脚本方式名称 Description
标识 Id 根据"标识"属性值与元素匹配。
名称 Name 根据"名称"属性值与元素匹配。
Css CssSelector 基于 CSS 选择器值与元素匹配。
链接文本 LinkText 根据链接文本属性值与元素匹配。
内部文本和控件类型 InnerTextAndTag 根据元素文本内容和标记名称属性值与元素匹配。
XPath XPath 根据 HTML 根中的 XML 路径与元素匹配。
类和值 ClassAndValue 根据类名和值属性与元素匹配。
名称和值 NameAndValue 根据名称和值属性与元素匹配。
标识和名称 IdAndName 根据标识和名称属性值与元素匹配。

输出参数

设计器方式标签 脚本方式名称 接受的变量类型 Description
成功 value Boolean 如果成功进行单击，那么返回 true，否则返回 false。

示例

以下代码示例演示了如何单击 Web 页面上的按钮。 单击 Web 页面 (webClick) 命令使用 Name 选择器来查找并单击“搜索”按钮。

defVar --name webpage --type String --value "www.google.com"
// Launches the Google Chrome browser
webStart --name browser --type "Chrome"
// Navigates to the Google web page
webNavigate --url "${webpage}"
// Enters the value "IBM" on the search field
webSet --value "IBM" --selector "Name" --name q
webClick --selector "Name" --name btnK
webClose --name browser --leavebrowseropen

限制

在 simulatehuman 输入参数中：

  • 光标移动仅在 Internet Explorer 界面中可见。 您可以在该元素的中间看到一次单击。
  • 要双击该元素：
    • 仅检查 <input> 元素。
    • 请检查 <type> 属性和 file 值。

在 selector 参数选项中：

  • 当使用 XPath 或 CSS 选择器与不唯一的 Web 元素进行交互时，即在 IFrame 内，需要指定命令将与 IFrame 内的哪个元素进行交互。 否则，将仅查找第一个元素。