获取组合框选项数

获取 Web 页面上组合框中的选项数。

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

脚本语法

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

webGetComboBox --selector(WebComboBoxElementSelectors) --id(String) --name(String) --css(String) --innertext(String) --tagname(String) --xpath(String) [--simulatehuman(Boolean)] [--timeout(TimeSpan)] (Numeric)=value

依赖关系

输入参数

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

设计器方式标签 脚本方式名称 必需的 接受的变量类型 Description
搜索依据 selector Required WebComboBoxElementSelectors 用于标识 Web 页面中组合框的选择器类型。

请参阅 selector 参数选项。
标识 id Required when the Search by parameter is Id, IdAndName Text 包含与组合框相匹配的标识属性值的文本。
名称 name Required when the Search by parameter is Name, IdAndName Text 包含与组合框相匹配的名称属性值的文本。
元素 CSS css Required when the Search by parameter is CssSelector Text 包含 CSS 选择器的文本，以匹配组合框。
元素文本 innertext Required when the Search by parameter is InnerTextAndTag Text 包含要与组合框匹配的元素文本内容的文本。
元素标记名称 tagname Required when the Search by parameter is InnerTextAndTag Text 包含与组合框相匹配的标记名称属性值的文本。
元素 XPath xpath Required when the Search by parameter is XPath Text 包含要与组合框匹配的 XML 路径值的文本。
模拟人类 simulatehuman Optional Boolean 此参数不会更改命令的行为。
Timeout timeout Optional Time Span, Number, Text 运行命令时的最长等待时间。 如果为空白，那么缺省超时为 5 秒。

selector 参数选项

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

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

输出参数

设计器方式标签 脚本方式名称 接受的变量类型 Description
选项 value Number 返回一个 Number 值，其中包含组合框中的选项数。

示例

下面的代码示例演示了如何获取网页上组合框中的选项数量。 获取组合框选项的数量 (webGetComboBox) 命令将使用组合框的 id 选择器来获取这些值。

defVar --name numberOfOptions --type Numeric
defVar --name webpage --type String --value "https://www.w3schools.com/tags/tryit.asp?filename=tryhtml_select"
// Launches the Google Chrome browser
webStart --name browser --type "Chrome"
// Navigates to the web page with the combination box
webNavigate --url "${webpage}"
webGetComboBox --selector "Id" --id cars --simulatehuman  numberOfOptions=value
// Logs the number of the options in the combination box
logMessage --message "The number of options: ${numberOfOptions}" --type "Info"
webClose --name browser

限制

  • 当使用 IFrame 内的 XPath 或 CSS 选择器与不唯一的 Web 元素进行交互时，需要为命令指定与 IFrame 内的哪个元素进行交互。 否则，将仅查找第一个元素。
  • 此命令仅支持由 HTML 标记 <select> 定义的组合框。