获取 Excel 值
从 Excel 文件中具有指定列和行坐标的单元格获取值。
命令可用性: 本地 IBM RPA SaaS 和 IBM RPA
脚本语法
IBM RPA 的专有脚本语言的语法与其他编程语言类似。 该脚本语法在脚本文件中定义命令的语法。 您可以在 IBM RPA Studio的 脚本 方式下使用此语法。
excelGet --file(Excel) [--getfirstsheet(Boolean)] --sheet(String) [--usingcell(Boolean)] --cell(String) --row(Numeric) --column(Numeric) (Scalar)=value
依赖关系
- 要使用此命令，请使用 Open Excel file (
excelopen) 命令打开 Excel 文件。
输入参数
下表显示了此命令中提供的输入参数的列表。 在表中，您可以看到在 IBM RPA Studio的脚本方式及其 Designer 方式等效标签中工作时的参数名称。
| 设计器方式标签 | 脚本方式名称 | 必需的 | 接受的变量类型 | 描述 |
|---|---|---|---|---|
| 文件 | file |
Required |
Excel |
用于存储 Excel 实例的变量。 |
| 使用第一个工作表 | getfirstsheet |
Optional |
Boolean |
根据输入的坐标，从文件的第一个电子表格获取相应的值。 |
| 工作表 | sheet |
Required when the Use First Sheet parameter is disabled |
Text |
要从中获取值的工作表的名称。 |
| 指定单元格 | usingcell |
Optional |
Boolean |
启用以使用 cell 参数中的完整单元格坐标。 |
| 单元 | cell |
Required when the Specify Cell parameter is enabled |
Text |
要从中获取值的单元格。 示例：“B3”。 |
| 行 | row |
Required when the Specify Cell parameter is disabled |
Number |
对应于必须输入值的行坐标的元素。 示例: "A1" 中的 "1" |
| 列 | column |
Required when the Specify Cell parameter is disabled |
Number |
对应于必须输入值的列坐标的元素。 示例: "A1" 中的 "A" |
输出参数
| 设计器方式标签 | 脚本方式名称 | 接受的变量类型 | 描述 |
|---|---|---|---|
| 值 | 值 | Primitives |
返回一个变量，具有通过输入的坐标从找到的单元格中获取的值。 |
示例
该脚本使用打开 Excel 文件命令打开 excel 文件并将其存储在“OpenExcel 文件”变量中。 获取 Excel 值 命令使用此变量以及 Use First Sheet 和 Specify Cell 参数来获取 A1 单元格的值。 关闭 Excel将关闭文件，并且日志消息命令将记录从 IBM RPA Studio 控制台获取的值。
defVar --name openedExcelFile --type Excel
defVar --name obtainedValue --type String
excelOpen --file "samplefile" --savechangesopenedExcelFile=value
excelGet --file ${openedExcelFile} --getfirstsheet--usingcell--cell A1 obtainedValue=value
excelClose --file ${openedExcelFile} --save
logMessage --message "Obtained Value: ${obtainedValue}\r\n" --type "Info"
❕ 重要信息: 要运行样本脚本，必须创建文件并填写 "A1" 单元格，然后在 打开 Excel 文件 (excelopen) 命令中输入其路径。
限制
IBM RPA 显示日期值以及时间，而不考虑其格式化方式。
示例： 01/14/2022 -> 01/14/2022 12:00:00AM