为字段设置值
将值设置为位于 Web 应用程序中的字段。
命令可用性: 本地 IBM RPA SaaS 和 IBM RPA
Description
使用选择器类型将值设置为位于 Web 应用程序中的字段，以标识要设置该值的字段。
脚本语法
IBM RPA 的专有脚本语言具有类似于其他编程语言的语法。 该脚本语法在脚本文件中定义命令的语法。 您可以在 IBM RPA Studio的 脚本 方式下使用此语法。
webSet --value(String) --selector(WebFieldElementSelectors) --id(String) --name(String) --css(String) --xpath(String) [--simulatehuman(Boolean)] [--timeout(TimeSpan)] (Boolean)=value
依赖关系
在使用将值设置为字段 (webSet) 命令之前，请使用启动浏览器 (webStart) 命令来启动浏览器或使用查找 Internet Explorer 浏览器 (findBrowser) 命令来连接 Microsoft Internet Explorer。
输入参数
下表显示了此命令中提供的输入参数的列表。 在表中，您可以看到在 IBM RPA Studio的脚本方式及其 Designer 方式等效标签中工作时的参数名称。
| 设计器方式标签 | 脚本方式名称 | 必需的 | 接受的变量类型 | Description |
|---|---|---|---|---|
| 值 | value |
Required |
Text |
要分配给字段的值。 |
| 选择器类型 | selector |
Required |
WebFieldElementSelectors |
用于标识 Web 页面中的 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 |
包含要匹配的“名称”属性值并将值设置为字段的文本。 |
| 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 |
根据标识属性值匹配 Web 元素。 |
| 名称 | Name |
根据“名称”属性值匹配 Web 元素。 |
| Css | CssSelector |
根据 CSS 选择器值匹配 Web 元素。 |
| XPath | XPath |
根据 HTML 根中的 XML 路径匹配 Web 元素。 |
| 标识和名称 | IdAndName |
根据标识和名称属性值匹配 Web 元素。 |
输出参数
| 设计器方式标签 | 脚本方式名称 | 接受的变量类型 | Description |
|---|---|---|---|
| 成功 | value |
Boolean |
如果该值已成功分配给字段，那么返回 true，否则返回 false。 |
示例
在 IBM Web 站点搜索字段中输入 Quantum computing 值。
webStart --name browser --type "Chrome"
webNavigate --url "https://www.ibm.com/"
webSet --value "Quantum computing" --selector "Id" --id q --simulatehuman
// Use the element id to find the field to assign the value..
webClose --name browser --leavebrowseropen
// Keep the browser open.
限制
- 当使用 XPath 或 CSS 选择器与不唯一的 Web 元素进行交互时，即在 IFrame 内，需要指定命令将与 IFrame 内的哪个元素进行交互。 否则，将仅查找第一个元素。
- 此命令仅用于将值分配给可编辑字段。