Get Table
动词：getTable
从指定控件选择器找到的表获取用户界面 (UI) 元素。
在 Windows 上，控件是允许用户与应用程序进行交互的元素。 控件可以是按钮、数据输入字段、菜单和各种其他元素。
语法
getTable --selector(ControlSelectors) --id(String) --name(String) --innertext(String) --tagname(String) --xpath(String) --classname(String) --elementvalue(String) --controltype(Nullable<ControlTypes>) --index(Numeric) --control(Control) [--usetable(Boolean)] [--searchbycolumn(Boolean)] --searchcolumn(String) --searchvalue(String) --returncolumn(String) --row(Numeric) [--timeout(TimeSpan)] (DataTable)=value (Numeric)=rows (Numeric)=columns
输入
| 脚本 | 设计器 | 必需的 | AcceptedTypes | Description |
|---|---|---|---|---|
| --selector | 选择器 | 必需的 | ControlSelectors | 用于识别用户界面控件的选择器的类型。 提供了以下选项： :ref(getTable.selector. *) 除了在脚本中插入带有自动填充这些参数的命令外，还可以使用 IBM RPA Studio的记录器来映射控件并获取 "选择器" 参数的必要信息。 该记录器在平台上的上方工具栏中可用。 |
| -- 标识 | 标识 | 仅当“选择器”为“标识”或“标识和名称”时 | 文本 | 应从中获取值的用户界面控件标识。 |
| -- 名称 | 名称 | 仅当“选择器”为“名称”、“名称和值”、“标识和名称”或“类型和名称”时 | 文本 | 应从中获取值的 UI 控件的名称。 |
| --innertext | 内部文本 | 仅当“选择器”为“内部文本和标记”时 | 文本 | 文本内的 UI 控件 |
| --tagname | 元素类型 | 仅当“选择器”为“内部文本和标记”时 | 文本 | 将从中获取值的元素的类型。 |
| --xpath | XPath | 仅当“选择器”为“XPath”时 | 文本 | UI 控件的 XPath 路径。 |
| --classname | 类 | 仅当“选择器”为“类和值”或“类名”时 | 文本 | 用户界面控件类。 |
| --elementvalue | 元素值 | 仅当“选择器”为“类和值”或“名称和值”时 | 文本 | UI 控件的当前值。 |
| --controltype | 控件类型 | 仅当“选择器”为“类型和索引”或“类型和名称”时 | ControlTypes | 应在用户界面 (UI) 中解析的用户界面控件的类型。 选项： 针对此操作指示的控件类型为“表”。 |
| -- 索引 | 索引 | 仅当“选择器”为“类型和索引”时 | 成员 | 在控件类型中指定的 UI 控件的索引，应从中获取值。 |
| --control | 控件 | 仅当“选择器”为“实例”时 | 控件 | 控件实例。使用命令搜索控件获取此变量。 |
| --usetable | 使用表 | 可选 | BOOLEAN | 启用后，将按列或行在表中访存元素。 |
| --searchbycolumn | 按列搜索 | 可选 | BOOLEAN | 启用后，将按列而不是按行访存元素。 |
| --searchcolumn | 搜索列 | 仅当“使用表”为 True 时 | 文本 | 将从中获取元素的列的名称或编号。 |
| --searchvalue | 搜索值 | 仅当“按列搜索”为 True 时 | 文本 | 用于在表中查找元素的值。 |
| --returncolumn | 返回列 | 仅当“按列搜索”为 True 时 | 文本 | 包含控件的列。 |
| --row | 行 | 仅当“按列搜索”为 False 时 | 成员 | 从中获取元素的表行。 |
| --timeout | 超时 | 可选 | 时间范围、数字、文本 | 执行命令以找到选择器指定的元素的最长等待时间。如果未在类型为超时的参数中设置任何值，那么执行将使用命令设置超时定义的上下文时间。 如果脚本未使用此命令，那么缺省时间为 5 秒。 |
输出
| 脚本 | 设计器 | AcceptedTypes | Description |
|---|---|---|---|
| 值 | 表 | 数据表 | 带有已识别元素的表。 |
| 行 | 行 | 成员 | 表的行数。 |
| columns | 列数 | 成员 | 表的列数。 |
示例
该命令通过“XPath”控制选择器获取特定应用程序的所有数据和表结构，并返回此表以及现有的行和列数量。
defVar --name windowApplication --type Window
defVar --name table --type DataTable
defVar --name rows --type Numeric
defVar --name columns --type Numeric
// Download the following file to execute the command.
launchWindow --executablepath "CSharpTestApp.exe" windowApplication=value
focusWindow --window ${windowApplication}
getTable --selector "XPath" --xpath "/root/table[1]" --timeout 00:05:00 table=value rows=rows columns=columns
logMessage --message "Table: ${table}\r\nRows: ${rows}\r\nColumns: ${columns}\r\n" --type "Info"
要正确运行以上脚本，需要下载上述文件，并在 :link (launchWindow) 命令的可执行文件参数中输入其路径。
输出值根据用户使用的应用程序而有所不同。
要执行此命令，必须先在 Windows 上启动一个新窗口。
备注
您可以使用 IBM RPA Studio的记录器来获取以下信息: