单击菜单

在打开的窗口中单击菜单项。

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

脚本语法

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

clickOnMenu --window(Window) --menupath(String) [--timeout(TimeSpan)]

依赖关系

必须使用另一个用于打开窗口的命令，例如 Launch and attach Window (launchWindow) 或 attach Window (attachWindow)。

输入参数

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

设计器方式标签 脚本方式名称 必需的 接受的变量类型 描述
窗口 window Optional Window 在其中单击菜单的打开的窗口。 此参数还适用于 SAP 窗口。
路径 menupath Required Text 菜单项的文本。 将单击的每个菜单项都必须以换行符分隔。
Timeout timeout Optional Time Span, Number, Text 命令执行时间。 如果在 Timeout 参数中未定义任何值，那么该命令将使用 Set Timeout (setTimeout) 命令定义的上下文时间。 如果脚本未使用该命令，那么缺省时间为 5 秒。

示例

示例 1：打开“记事本”应用程序窗口。 单击菜单 命令在菜单中执行以下单击顺序: "文件> 打开" ，这将打开用于选择文件的新窗口。

defVar --name notepadWindow --type Window
defVar --name processId --type Numeric
defVar --name success --type Boolean
launchWindow --executablepath "C:\\Windows\\notepad.exe" --timeout 00:00:20 notepadWindow=value  processId=processId success=success
clickOnMenu --window ${notepadWindow} --menupath "file\r\nopen" --timeout 00:00:10

示例 2：与上一个示例类似，不同之处在于，要多次浏览菜单，需要多次执行单击菜单命令。

defVar --name notepadWindow --type Window
launchWindow --executablepath "C:\\Windows\\notepad.exe" --timeout 00:00:20 notepadWindow=value
typeText --text "IBM"
clickOnMenu --window ${notepadWindow} --menupath "edit\r\nselect all" --timeout 00:00:10
clickOnMenu --window ${notepadWindow} --menupath "edit\r\ncut" --timeout 00:00:10
clickOnMenu --window ${notepadWindow} --menupath "edit\r\npaste" --timeout 00:00:10
clickOnMenu --window ${notepadWindow} --menupath "file\r\nsave" --timeout 00:00:10
// Write, select, cut and paste text and open the save file window.

示例 3: 此示例显示命令如何与 SAP配合使用。 它将启动 SAP 会话，并根据定义的事务代码打开 SAP 任务。

startSAPSession --applicationpath "path\\sap.exe" --connectionstring "Connection string" --clientid 001 --username username --password password --language en
sapTransaction --transactionCode "Transaction code"
click --selector "Id" --controlsimilarity 100 --id "wnd[0]/usr/ssubSUBSCREEN_0:SAPWL_ST03N:1200/cntlALV_OVERVIEW_CONTAINER/shellcont/shell/Toolbar(13)"
clickOnMenu --menupath "Word processing" --timeout "00:00:10"

示例 4: 打开 "计算器" 应用程序，获取控件，然后命令根据先前获取的控件单击菜单。

defVar --name calculatorID --type String
defVar --name id --type Control
defVar --name calculatorWindow --type Window
// Open the Calculator application
launchWindow --executablepath "calc.exe" --safesearch  calculatorWindow=value
// Get ID as control
getControl --selector "Id" --id "${calculatorID}" id=control
// Click on the menu based on the control obtained previously
clickOnMenu --window ${calculatorWindow} --menupath "${id}" --timeout "00:00:10"
请记住:以上示例在 Windows 11 上不起作用。 IBM RPA 不支持 Windows 11 UWP 应用程序。