表格与数据-Excel/Wps表格

显示全部

Excel/Wps表格

表格与数据 / Excel/Wps表格 类动作。

打开表格

open_spreadsheet

表格与数据Excel/Wps表格

用途：打开 Excel 工作簿。

写法：打开表格 [文件路径=<文件路径>] [表名=<表名>] [显示窗口=<显示窗口>]

保存为

这个动作成功时没有可复用返回值，一般不需要写 保存为=变量名 或 返回结果=变量名。

正确示例

打开表格 文件路径='D:/报表/客户.xlsx' 表名='Sheet1' 显示窗口=true

# 说明：打开指定表格并显示窗口

错误示例

打开表格 文件路径="D:/demo.txt" 错误参数=1

为什么错：使用了不在当前参数表里的参数名。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
文件路径file_path要打开的表格文件路径；不填时继续使用当前已打开的工作簿。否无
表名sheet要打开的工作表名称或序号。否1
显示窗口visible是否把 Excel 窗口显示出来，方便手动查看。否False

返回结果

保存后通常可按字段路径继续读取。

当前没有单独声明返回字段。

返回/保存方式：这个动作成功时没有可复用返回值，一般不需要写 保存为=变量名 或 返回结果=变量名。

新建表格

create_spreadsheet

表格与数据Excel/Wps表格

用途：新建 Excel 工作簿。

写法：新建表格 [表名=<表名>] [显示窗口=<显示窗口>]

保存为

这个动作成功时没有可复用返回值，一般不需要写 保存为=变量名 或 返回结果=变量名。

正确示例

新建表格 表名=1 显示窗口=true

# 说明：新建一个表格并显示 Excel

错误示例

新建表格 表名="示例值" 错误参数=1

为什么错：使用了不在当前参数表里的参数名。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
表名sheet默认创建后要切到的表名或序号。否1
显示窗口visible是否把 Excel 窗口显示出来。否False

返回结果

保存后通常可按字段路径继续读取。

当前没有单独声明返回字段。

返回/保存方式：这个动作成功时没有可复用返回值，一般不需要写 保存为=变量名 或 返回结果=变量名。

读取表格

read_spreadsheet

表格与数据Excel/Wps表格

用途：读取 Excel 单元格或区域。

写法：读取表格 [单元格或区域=<单元格或区域>]

保存为

默认保存主结果，通常就是 内容 这个字段。

正确示例

读取表格 单元格或区域='A1:C3'

# 说明：读取一块连续区域

错误示例

读取表格 单元格或区域="示例值" 错误参数=1

为什么错：使用了不在当前参数表里的参数名。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
单元格或区域location支持 A1、A1:C3、A:C、1:3、A1,B3 这类位置写法；不填时读取已用区域。否无

返回结果

如果你要整份返回对象，而不只是主结果，可在行尾写 返回结果=变量名。

返回结果

保存后通常可按字段路径继续读取。

字段路径类型必有说明
内容未声明是未提供说明
读取模式string是未提供说明
读取范围string是未提供说明
行数integer是未提供说明
列数integer是未提供说明

返回/保存方式：普通动作需要留给后续步骤时，通常可在行尾追加 保存为=变量名，默认保存主结果字段 内容。

写入表格

write_spreadsheet

表格与数据Excel/Wps表格

用途：写入 Excel 单元格或区域。

写法：写入表格 单元格或区域=<单元格或区域> 内容=<内容>

保存为

这个动作成功时没有可复用返回值，一般不需要写 保存为=变量名 或 返回结果=变量名。

正确示例

写入表格 单元格或区域='B2' 内容='已完成'

# 说明：写入单个单元格

错误示例

写入表格 单元格或区域="示例值"

为什么错：漏写了必填参数：内容。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
单元格或区域location支持 A1、A1:C3、A1,B3 这类位置写法。是无
内容content要写入单元格、区域或多个单元格的内容。是无

返回结果

保存后通常可按字段路径继续读取。

当前没有单独声明返回字段。

返回/保存方式：这个动作成功时没有可复用返回值，一般不需要写 保存为=变量名 或 返回结果=变量名。

切换工作表

select_spreadsheet_sheet

表格与数据Excel/Wps表格

用途：切换到指定 Excel 工作表。

写法：切换工作表 表名=<表名>

保存为

这个动作成功时没有可复用返回值，一般不需要写 保存为=变量名 或 返回结果=变量名。

正确示例

切换工作表 表名='数据'

# 说明：切到名为“数据”的工作表

错误示例

切换工作表

为什么错：漏写了必填参数：表名。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
表名sheet要切换到的工作表名称或序号。是无

返回结果

保存后通常可按字段路径继续读取。

当前没有单独声明返回字段。

返回/保存方式：这个动作成功时没有可复用返回值，一般不需要写 保存为=变量名 或 返回结果=变量名。

保存表格

save_spreadsheet

表格与数据Excel/Wps表格

用途：保存 Excel 工作簿。

写法：保存表格 [文件路径=<文件路径>] [保存后关闭表格=<保存后关闭表格>] [保存后退出Excel=<保存后退出Excel>]

保存为

默认保存主结果，通常就是 文件路径 这个字段。

正确示例

保存表格 保存后关闭表格=true 保存后退出Excel=true

# 说明：保存后关闭工作簿并退出 Excel

错误示例

保存表格 文件路径="D:/demo.txt" 错误参数=1

为什么错：使用了不在当前参数表里的参数名。

展开查看参数和注意事项
中文参数英文参数用途必填默认值
文件路径file_path另存为的新文件路径；不填时覆盖当前工作簿。否无
保存后关闭表格close_after保存完成后是否关闭当前工作簿。否False
保存后退出Excelquit_after保存完成后是否退出整个 Excel 程序。否False

返回结果

如果你要整份返回对象，而不只是主结果，可在行尾写 返回结果=变量名。

返回结果

保存后通常可按字段路径继续读取。

字段路径类型必有说明
文件路径string是未提供说明

返回/保存方式：普通动作需要留给后续步骤时，通常可在行尾追加 保存为=变量名，默认保存主结果字段 文件路径。

关闭表格

close_spreadsheet

表格与数据Excel/Wps表格

用途：关闭当前 Excel 工作簿。

写法：关闭表格

保存为

这个动作成功时没有可复用返回值，一般不需要写 保存为=变量名 或 返回结果=变量名。

正确示例

关闭表格

错误示例

关闭表格 错误参数=1

为什么错：使用了不在真实参数表里的参数名。

展开查看参数和注意事项

这个命令没有参数。

返回结果

保存后通常可按字段路径继续读取。

当前没有单独声明返回字段。

返回/保存方式：这个动作成功时没有可复用返回值，一般不需要写 保存为=变量名 或 返回结果=变量名。

退出Excel

quit_excel_app

表格与数据Excel/Wps表格

用途：退出整个 Excel 程序。

写法：退出Excel

保存为

这个动作成功时没有可复用返回值，一般不需要写 保存为=变量名 或 返回结果=变量名。

正确示例

退出Excel

错误示例

退出Excel 错误参数=1

为什么错：使用了不在真实参数表里的参数名。

展开查看参数和注意事项

这个命令没有参数。

返回结果

保存后通常可按字段路径继续读取。

当前没有单独声明返回字段。

返回/保存方式：这个动作成功时没有可复用返回值，一般不需要写 保存为=变量名 或 返回结果=变量名。