向 Web 发送键

将模拟按键发送到 Web 页面上的某个元素。

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

描述

将模拟按键发送到某个元素。

使用键代码模式将键代码发送到元素，如 {FOO}。 如果需要，启用模拟人类参数以在元素中输入键代码。

脚本语法

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

webSendKeys --value(String) --selector(WebFieldElementSelectors) --id(String) --name(String) --css(String) --xpath(String) [--simulatehuman(Boolean)] [--timeout(TimeSpan)] (Boolean)=value

依赖关系

在使用 Web 发送键 (webSendKeys) 命令之前，请使用启动浏览器 (webStart) 命令来启动浏览器或使用查找 Internet Explorer 浏览器 (findBrowser) 命令来连接 Microsoft Internet Explorer。

输入参数

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

设计器方式标签 脚本方式名称 必需的 接受的变量类型 Description
值 value Required Text 包含要发送到元素的键代码的文本。
要使用多个键代码，请在这些键代码之间使用空格，如 {BACKSPACE} {ENTER}。
您还可以定义按键的次数，如 {BACKSPACE 3} {ENTER 2}。 缺省情况下，每个键仅按一次。

请参阅 value 参数接受了键代码。
搜索目标 selector Required WebFieldElementSelectors 用于标识 Web 页面中元素的选择器类型。

请参阅 selector 参数选项。
标识 id Required when the Search for parameter is Id, IdAndName Text 包含标识属性值的文本，以与元素匹配。
名称 name Required when the Search for parameter is Name, IdAndName Text 包含"名称"属性值的文本，以与元素匹配。
CSS css Required when the Search for parameter is CssSelector Text 包含 CSS 选择器的文本，以与元素匹配。
XPath xpath Required when the Search for 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 根据标识和名称属性值与元素匹配。

value 参数接受了键代码

下表显示了要在 value 输入参数中使用的已接受密钥代码。

关键代码 Description
{ADD} 与数字键盘的加号键匹配。
{ALT} 与 Alt 键匹配。
{ARROWDOWN} 与向下箭头键匹配。
{ARROWLEFT} 与向左箭头键匹配。
{ARROWRIGHT} 与向右箭头键匹配。
{ARROWUP} 与向上箭头键匹配。
{BACKSPACE} 与退格键匹配。
{CANCEL} 与“取消”击键匹配。
{CLEAR} 与 Clear 击键匹配。
{COMMAND} 与功能键 COMMAND 匹配。
{CONTROL} 与 Control 键匹配。
{DECIMAL} 与数字jian键盘小数分隔符键匹配。
{DELETE} 与 Delete 键匹配。
{DIVIDE} 与数字键盘除号键匹配。
{DOWN} 与向左箭头键匹配。
{END} 与 End 键匹配。
{ENTER} 与 Enter 键匹配。
{EQUAL} 与等号键匹配。
{ESCAPE} 与 Escape 键匹配。
{F1} 与功能键 F1 匹配。
{F10} 与功能键 F10 匹配。
{F11} 与功能键 F11 匹配。
{F12} 与功能键 F12 匹配。
{F2} 与功能键 F2 匹配。
{F3} 与功能键 F3 匹配。
{F4} 与功能键 F4 匹配。
{F5} 与功能键 F5 匹配。
{F6} 与功能键 F6 匹配。
{F7} 与功能键 F7 匹配。
{F8} 与功能键 F8 匹配。
{F9} 与功能键 F9 匹配。
{HELP} 与“帮助”击键匹配。
{HOME} 与 Home 键匹配。
{INSERT} 与 Insert 键匹配。
{LEFT} 与向左箭头键匹配。
{LEFTALT} 与 Alt 键匹配。
{LEFTCONTROL} 与 Control 键匹配。
{LEFTSHIFT} 与 Shift 键匹配。
{META} 与功能键 META 匹配。
{MULTIPLY} 与数字键盘乘号键匹配。
{NULL} 与 NULL 击键匹配。
{NUMBERPAD0} 与数字键盘的 0 键匹配。
{NUMBERPAD1} 与数字键盘的 1 键匹配。
{NUMBERPAD2} 与数字键盘的 2 键匹配。
{NUMBERPAD3} 与数字键盘的 3 键匹配。
{NUMBERPAD4} 与数字键盘的 4 键匹配。
{NUMBERPAD5} 与数字键盘的 5 键匹配。
{NUMBERPAD6} 与数字键盘的 6 键匹配。
{NUMBERPAD7} 与数字键盘的 7 键匹配。
{NUMBERPAD8} 与数字键盘的 8 键匹配。
{NUMBERPAD9} 与数字键盘的 9 键匹配。
{PAGEDOWN} 与 Page Down 键匹配。
{PAGEUP} 与 Page Up 键匹配。
{PAUSE} 与 Pause 键匹配。
{RETURN} 与 Return 键匹配。
{RIGHT} 与向右箭头键匹配。
{SEMICOLON} 与分号键匹配。
{SEPARATOR} 与数字键盘的千位分隔符键匹配。
{SHIFT} 与 Shift 键匹配。
{SPACE} 与空格键相匹配。
{SUBTRACT} 与数字键盘的减号键匹配。
{TAB} 与 Tab 键匹配。

输出参数

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

示例

以下代码示例演示了如何发送 {ENTER} 键代码。 Web 发送键 (webSendKeys) 命令使用 Name 选择器将此键代码发送到该字段。

defVar --name webpage --type String --value "https://www.google.com.br/"
// Launches the Google Chrome browser
webStart --name browser --type "Chrome"
// Navigates to the web page
webNavigate --url "${webpage}"
// Enters the value `IBM` in the search field
webSet --value IBM --selector "Name" --name q
webSendKeys --value "{ENTER}" --selector "Name" --name q --timeout "00:00:05"
webClose --name browser

限制

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