将数据表插入 Excel 文件
创建数据表值并将这些值插入到现有 Excel 文件中。
命令可用性: 本地 IBM RPA SaaS 和 IBM RPA
脚本语法
IBM RPA 的专有脚本语言的语法与其他编程语言类似。 该脚本语法在脚本文件中定义命令的语法。 您可以在 IBM RPA Studio的 脚本 方式下使用此语法。
excelSetTable --dataTable(DataTable) [--headers(Boolean)] --file(Excel) [--getfirstsheet(Boolean)] --sheet(String) [--usingcell(Boolean)] --cell(String) --row(Numeric) --column(Numeric) (Boolean)=value
依赖关系
- 要使用此命令，请使用 Open Excel file (
excelopen) 命令打开 Excel 文件。
输入参数
下表显示了此命令中提供的输入参数的列表。 在表中，您可以看到在 IBM RPA Studio的脚本方式及其 Designer 方式等效标签中工作时的参数名称。
| 设计器方式标签 | 脚本方式名称 | 必需的 | 接受的变量类型 | 描述 |
|---|---|---|---|---|
| 数据表 | dataTable |
Required |
Data Table |
要从中获取值并将值插入到文件中的数据表。 |
| 包含标题 | headers |
Optional |
Boolean |
启用此项以使用工作表的第一行作为标题。 |
| 文件 | file |
Required |
Excel |
用于存储 Excel 实例的变量。 |
| 使用第一个工作表 | getfirstsheet |
Optional |
Boolean |
使用第一个工作表来创建表。 |
| 工作表 | sheet |
Required when the Use first sheet parameter is disabled |
Text |
要在其中创建表的电子表格的名称。 如果输入的名称与文件中的任何电子表格都不匹配，那么将创建具有给定名称的新电子表格。 |
| 指定单元格 | usingcell |
Optional |
Boolean |
允许用户输入完整的单元格坐标。 示例: "A1"。 |
| 单元 | cell |
Required when the Specify cell parameter is enabled |
Text |
表的开始单元格的坐标。 示例: "A1"。 |
| 行 | row |
Required when the Specify cell parameter is disabled |
Number |
要在其中插入初始值的单元格行所对应的值。 示例: "A1" 中 1 "1"。 |
| 列 | column |
Required when the Specify cell parameter is disabled |
Number |
对应于列单元格的值，应该在其中插入表的初始值。 示例: "A1" 中的 "A"。 |
输出参数
| 设计器方式标签 | 脚本方式名称 | 接受的变量类型 | 描述 |
|---|---|---|---|
| 成功 | 值 | Boolean |
如果成功创建表，那么返回 True ，否则返回 False 。 |
示例
打开 Excel 文件命令打开 Excel 文件，并将其数据导入名为 "dataTable" 的变量。 再次运行该命令，打开另一个 Excel 文件并创建一个新的电子表格，在其中插入 "dataTable" 中的数据。
defVar --name dataTable --type DataTable
defVar --name excelFile --type Excel
defVar --name excelFile02 --type Excel
excelOpen --file "file2" excelFile02=value
excelOpen --file "file1" excelFile=value
excelGetTable --file ${excelFile} --getfirstsheet--entiretabledataTable=value
excelSetTable --dataTable ${dataTable} --file ${excelFile02} --sheet Sheet03 --usingcell--cell A1
excelClose --file ${excelFile02} --save
excelClose --file ${excelFile} --save
❕ 重要信息: 要运行样本脚本，需要 2 不同的 excel 文件，然后在 打开 Office 文件 命令中输入其文件路径。