获取元素 HTML
获取 Web 页面上元素的 HTML 代码。
命令可用性: 本地 IBM RPA SaaS 和 IBM RPA
Description
获取 Web 页面上元素的 HTML 代码，并将 HTML 代码作为 Text 值返回。 HTML 代码可能包含该元素及其子代元素。 此外，每个元素或其子元素都可以包含元素的标记名称、元素属性和属性值以及元素内容。
脚本语法
IBM RPA 的专有脚本语言具有类似于其他编程语言的语法。 该脚本语法在脚本文件中定义命令的语法。 您可以在 IBM RPA Studio的 脚本 方式下使用此语法。
webGetFieldHTML --selector(WebFieldElementSelectors) --id(String) --name(String) --css(String) --xpath(String) [--simulatehuman(Boolean)] [--timeout(TimeSpan)] (String)=value
依赖关系
在使用获取元素 HTML (webGetFieldHtml) 命令之前，请使用启动浏览器 (webStart) 命令来启动浏览器或使用查找 Internet Explorer 浏览器 (findBrowser) 命令来连接 Microsoft Internet Explorer。
输入参数
下表显示了此命令中提供的输入参数的列表。 在表中，您可以看到在 IBM RPA Studio的脚本方式及其 Designer 方式等效标签中工作时的参数名称。
| 设计器方式标签 | 脚本方式名称 | 必需的 | 接受的变量类型 | Description |
|---|---|---|---|---|
| 选择器类型 | selector |
Required |
WebFieldElementSelectors |
用于标识 Web 页面中元素的选择器类型。 请参阅 selector 参数选项。 |
| 标识 | id |
Required when the Selector type parameter is Id, IdAndName |
Text |
包含标识属性值的文本，以与元素匹配并获取元素。 |
| 名称 | name |
Required when the Selector type parameter is Name, IdAndName |
Text |
包含名称属性值的文本，以与元素匹配并获取元素。 |
| CSS | css |
Required when the Selector type parameter is CssSelector |
Text |
包含 CSS 选择器的文本，以与元素匹配并获取元素。 |
| XPath | xpath |
Required when the Selector type parameter is XPath |
Text |
包含 XML 路径值的文本，以与元素匹配并获取元素。 |
| 模拟人类 | simulatehuman |
Optional |
Boolean |
此参数不会更改命令的行为。 |
| Timeout | timeout |
Optional |
Time Span, Number, Text |
运行命令时的最长等待时间。 如果为空白，那么缺省超时为 5 秒。 |
selector 参数选项
下表显示了可用于 selector 输入参数的选项。 该表显示了在脚本方式下工作时的可用选项以及在设计器方式下的等效标签。
| 设计器方式标签 | 脚本方式名称 | Description |
|---|---|---|
| 标识 | Id |
根据"标识"属性值与元素匹配。 |
| 名称 | Name |
根据"名称"属性值与元素匹配。 |
| Css | CssSelector |
基于 CSS 选择器值与元素匹配。 |
| XPath | XPath |
根据 HTML 根中的 XML 路径与元素匹配。 |
| 标识和名称 | IdAndName |
根据标识和名称属性值与元素匹配。 |
输出参数
| 设计器方式标签 | 脚本方式名称 | 接受的变量类型 | Description |
|---|---|---|---|
| HTML 代码 | value |
Text |
返回一个 Text 值，其中包含元素及其子元素的 HTML 代码。 |
示例
以下代码示例演示了如何从 Web 页面中获取 <p> 元素的 HTML 代码。 获取元素 HTML (webGetFieldHTML) 命令使用 css 选择器来获取此元素的内容。
defVar --name htmlCode --type String
defVar --name webpage --type String --value "https://example.com/"
// Launches the Google Chrome browser
webStart --name browser --type "Chrome"
// Navigates to the web page with the text elements
webNavigate --url "${webpage}"
webGetFieldHTML --selector "CssSelector" --css "body > div > p:nth-child(3)" --simulatehuman htmlCode=value
// Logs the HTML code
logMessage --message "${htmlCode}" --type "Info"
webClose --name browser
限制
- 当使用 XPath 或 CSS 选择器与不唯一的 Web 元素进行交互时，即在 IFrame 内，需要指定命令将与 IFrame 内的哪个元素进行交互。 否则，将仅查找第一个元素。