本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
Excel
Excel 操作使您能够在自动化中读取、更新和创建 Excel 文件。所有 Excel 操作都支持.xlsx 和.xlsm 文件格式。工作簿标识符维护多个操作之间的引用。
注意
虽然可以从.xlsm 文件中读取值，但不支持宏执行。
创建新工作簿
创建一个空白的 Excel 文件。输出工作簿标识符，可用于在后续步骤中更新电子表格。
特性：
工作簿标识符（输出）：存储 future 操作的工作簿参考的变量名称（默认：
workbook_id）
打开现有工作簿
加载现有的 Excel 文件。返回可用于在后续步骤中更新电子表格的工作簿标识符。仅支持 Excel (.xlsx) 文件。
特性：
Excel 文件（必填）：要打开的.xlsx 文件，通常存储在变量中（例如）
my_file工作簿标识符（输出）：存储工作簿引用的变量名称（默认：
workbook_id）
文件要求：
必须是有效的 Excel (.xlsx) 文件
文件必须可以作为媒体文件对象进行访问
保存工作簿
将更新保存到 Excel 文件中。允许您更新已保存工作簿的文件名和文件类型。
特性：
文件名（必填）：已保存文件的名称，不带扩展名（例如，“月度报告”）
文件类型（下拉列表）：输出格式-目前支持 XLSX（默认值：XLSX）
保存的文件（输出）：存储已保存文件对象的变量（默认：
saved_file）
阅读表格
从一系列单元格中获取数据。该操作将输出存储在数据表变量中。
特性：
工作簿标识符（必填）：要读取的工作簿（例如
workbook_id）工作@@ 表名称（必填）：工作表或选项卡名称（默认：“Sheet1"）
单元格范围（可选）：范围规范-支持多种格式：
起始单元格：“A2”（从锚点读取所有数据）
确切范围：“A1: B10”
列范围：“A: B”
行范围：“1:3”
空：读取整张表格
包括标题（复选框）：启用后，将第一行视为列标题。禁用后，使用默认命名（第 0 列、第 1 列等） （默认值：TRUE）
数据表（输出）：存储提取数据的变量（默认：
excel_table）
配方处理：
该操作会自动计算公式并将结果存储在数据表中。
读取单元格
从单元格中获取值。用于从工作表中读取单个单元格的值。
特性：
工作簿标识符（必填）：要读取的工作簿（例如
workbook_id）工作@@ 表名称（必填）：工作表名称（默认：“Sheet1"）
单元格引用（必填）：单元格位置（例如 “A1”）
单元格值（输出）：存储单元格内容的变量（默认：
cell_value）
写到工作表
将数据表输出到工作表中。用于将一系列行和列写入工作表。
特性：
数据表（必填）：要写入的数据表（例如
my_table）工作簿标识符（必填）：目标工作簿（例如
workbook_id）工作@@ 表名称（必填）：目标工作表（默认：“Sheet1"）
从@@ 单元格开始（可选）：数据放置的起始位置（默认：“A1”）
包括标题（复选框）：启用时写入列标题（默认值：TRUE）
写入手机
向单元格输出一个值。用于更新工作表中的单个单元格。
特性：
要写的值（必填）：单元格的内容（例如，“Order #12345”）
工作簿标识符（必填）：目标工作簿（例如
workbook_id）工作@@ 表名称（必填）：目标工作表（默认：“Sheet1"）
单元格引用（必填）：目标单元格位置（例如 “A1”）
写新行
向工作表中添加一行数据。新行将追加到现有数据的末尾。
特性：
行值（必填）：新行的值数组，从第一列开始（例如，["Q1"、“Sales”、100]）
工作簿标识符（必填）：目标工作簿（例如
workbook_id）工作@@ 表名称（必填）：目标工作表（默认：“Sheet1"）
数据验证：
必须以数组格式提供值
值从第一列开始按顺序写入
创建新工作表
添加一个空白工作表。新工作表将添加到工作簿的末尾。
特性：
工作簿标识符（必填）：目标工作簿（例如
workbook_id）工作@@ 表名称（必填）：新工作表的名称（例如，“销售数据”）
复印表
创建工作表的副本。新工作表是在同一个工作簿中创建的。
特性：
工作簿标识符（必填）：目标工作簿（例如
workbook_id）要复制的工作表名称（必填）：源工作表名称（例如，“原始工作表”）
新工作表名称（必填）：重复工作表的名称（例如，“原始工作表（副本）”）
重命名工作表
更新现有工作表的名称。
特性：
工作簿标识符（必填）：目标工作簿（例如
workbook_id）当前工作表名称（必填）：现有工作表名称（例如 “Sheet1”）
更新的工作表名称（必填）：工作表的新名称（例如，“第一季度数据”）
删除工作表
从工作簿中移除工作表。无法删除工作簿中最后剩下的工作表。
特性：
工作簿标识符（必填）：目标工作簿（例如
workbook_id）要删除的工作表名称（必填）：要删除的工作表（例如，“Sheet1”）
约束：
无法删除工作簿中最后剩下的工作表
设置单元格颜色
更新单元格背景颜色。用于突出显示特定范围的单元格。
特性：
单元格颜色（必填）：RGB 十六进制代码格式（例如，“FF0000” 代表红色）
工作簿标识符（必填）：目标工作簿（例如
workbook_id）工作@@ 表名称（必填）：目标工作表（例如 “Sheet1”）
单元格范围（必填）：格式范围-支持：
单节电池：“A1”
确切范围：“A1: B10”
列范围：“A: B”
行范围：“1:3”
获取单元格颜色
读取单元格背景颜色。以 RGB 十六进制代码格式输出颜色（例如，“FF0000” 代表红色）。
特性：
工作簿标识符（必填）：源工作簿（例如
workbook_id）工作@@ 表名称（必填）：源工作表（例如 “Sheet1”）
单元格引用（必填）：要读取的单元格（例如 “A1”）
单元格颜色（输出）：存储 RGB 十六进制代码的变量（默认：
cell_color）
隐藏行
使行隐藏在工作表中。数据保持不变，但不可见。
特性：
工作簿标识符（必填）：目标工作簿（例如
workbook_id）工作@@ 表名称（必填）：目标工作表（例如 “Sheet1”）
起始行（必填）：要隐藏的第一行编号（Excel 编号从 1 开始）
结束行（可选）：要隐藏的最后一行号。如果为空，则仅隐藏起始行
行号：
Excel 行号从 1 开始（不是 0）
必须提供整数值
取消隐藏行
使隐藏的行可见。用于显示以前隐藏的行。
特性：
工作簿标识符（必填）：目标工作簿（例如
workbook_id）工作@@ 表名称（必填）：目标工作表（例如 “Sheet1”）
起始行（必填）：要取消隐藏的第一行编号（Excel 编号从 1 开始）
结束行（可选）：要取消隐藏的最后一行号。如果为空，则仅显示起始行
最佳做法和限制
工作簿标识符管理
将工作簿标识符存储在描述性变量中（例如
sales_workbook，report_file）在同一工作簿的多个操作中重复使用相同的标识符
在执行数据操作之前，请务必创建或打开工作簿
范围规格
使用精确范围 (“A1: B10”) 进行精确的数据操作
处理整列时使用列范围（“A: B”）
使用行范围 (” 1:3”) 进行标题或摘要操作
将范围留空以处理整张工作表
性能优化
尽可能读取整个范围，而不是单个单元格
使用数据表进行批量写入操作，而不是单个单元格写入
仅在所有修改完成后才保存工作簿
限制
文件兼容性仅限于现代 Excel (.xlsx) 格式，不支持旧版 Excel (.xls) 文件。
