重命名 Excel 工作表
重命名 Excel 文件中具有指定索引或名称的工作表。
命令可用性: 本地 IBM RPA SaaS 和 IBM RPA
脚本语法
IBM RPA 的专有脚本语言的语法与其他编程语言类似。 该脚本语法在脚本文件中定义命令的语法。 您可以在 IBM RPA Studio的 脚本 方式下使用此语法。
excelRenameWorksheet --file(Excel) [--index(Numeric)] [--name(String)] --newname(String)
依赖关系
- 要使用此命令，请使用 Open Excel file (
excelopen) 命令打开 Excel 文件。
输入参数
下表显示了此命令中提供的输入参数的列表。 在表中，您可以看到在 IBM RPA Studio的脚本方式及其 Designer 方式等效标签中工作时的参数名称。
| 设计器方式标签 | 脚本方式名称 | 必需的 | 接受的变量类型 | 描述 |
|---|---|---|---|---|
| Excel | file |
Required |
Excel |
用于存储 Excel 实例的变量。 |
| 索引 | index |
Optional |
Number |
要重命名的电子表格索引。 ❕ 重要信息: 索引从 1 开始，并且必须是 Excel 文件中的现有值。 |
| 名称 | name |
Optional |
Text |
要重命名的工作表的名称。 |
| 新名称 | newname |
Required |
Text |
工作表的新名称。 |
示例
打开 Excel 文件命令会打开一个 Excel 文件，并将其存储在名为 "excelFile" 的变量中。 重命名 Excel 工作表命令会找到 Index "1" 的电子表格，并将其重命名为 "FirstSheet"。
defVar --name excelFile --type Excel
// Download the following file to run the command.
excelOpen --file "Sample file" excelFile=value
excelRenameWorksheet --file ${excelFile} --index 1 --newname FirstSheet
excelClose --file ${excelFile} --save
❕ 重要信息: 要运行样本脚本，请创建文件并在 File Path 参数中添加其路径。
限制
必须关闭运行 Open Excel File (excelopen) 命令时引用的文件才能使该命令工作。