本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# Excel
<a name="actions-excel"></a>

Excel 操作使您能够在自动化中读取、更新和创建 Excel 文件。所有 Excel 操作都支持.xlsx 和.xlsm 文件格式。工作簿标识符维护多个操作之间的引用。

**注意**  
虽然可以从.xlsm 文件中读取值，但不支持宏执行。

## 创建新工作簿
<a name="create-new-workbook"></a>

创建一个空白的 Excel 文件。输出工作簿标识符，可用于在后续步骤中更新电子表格。

**特性：**
+ **工作簿标识符**（输出）：存储 future 操作的工作簿参考的变量名称（默认：`workbook_id`）

## 打开现有工作簿
<a name="open-existing-workbook"></a>

加载现有的 Excel 文件。返回可用于在后续步骤中更新电子表格的工作簿标识符。仅支持 Excel (.xlsx) 文件。

**特性：**
+ **Excel 文件**（必填）：要打开的.xlsx 文件，通常存储在变量中（例如）`my_file`
+ **工作簿标识符**（输出）：存储工作簿引用的变量名称（默认：`workbook_id`）

**文件要求：**
+ 必须是有效的 Excel (.xlsx) 文件
+ 文件必须可以作为媒体文件对象进行访问

## 保存工作簿
<a name="save-workbook"></a>

将更新保存到 Excel 文件中。允许您更新已保存工作簿的文件名和文件类型。

**特性：**
+ **文件名**（必填）：已保存文件的名称，不带扩展名（例如，“月度报告”）
+ **文件类型**（下拉列表）：输出格式-目前支持 XLSX（默认值：XLSX）
+ **保存的文件**（输出）：存储已保存文件对象的变量（默认：`saved_file`）

## 阅读表格
<a name="read-sheet"></a>

从一系列单元格中获取数据。该操作将输出存储在数据表变量中。

**特性：**
+ **工作簿标识符**（必填）：要读取的工作簿（例如`workbook_id`）
+ 工作@@ **表名称**（必填）：工作表或选项卡名称（默认：“Sheet1"）
+ **单元格范围**（可选）：范围规范-支持多种格式：
  + 起始单元格：“A2”（从锚点读取所有数据）
  + 确切范围：“A1: B10”
  + 列范围：“A: B”
  + 行范围：“1:3”
  + 空：读取整张表格
+ **包括标题**（复选框）：启用后，将第一行视为列标题。禁用后，使用默认命名（第 0 列、第 1 列等） （默认值：TRUE）
+ **数据表**（输出）：存储提取数据的变量（默认：`excel_table`）

**配方处理：**
+ 该操作会自动计算公式并将结果存储在数据表中。

## 读取单元格
<a name="read-cell"></a>

从单元格中获取值。用于从工作表中读取单个单元格的值。

**特性：**
+ **工作簿标识符**（必填）：要读取的工作簿（例如`workbook_id`）
+ 工作@@ **表名称**（必填）：工作表名称（默认：“Sheet1"）
+ **单元格引用**（必填）：单元格位置（例如 “A1”）
+ **单元格值**（输出）：存储单元格内容的变量（默认：`cell_value`）

## 写到工作表
<a name="write-to-sheet"></a>

将数据表输出到工作表中。用于将一系列行和列写入工作表。

**特性：**
+ **数据表**（必填）：要写入的数据表（例如`my_table`）
+ **工作簿标识符**（必填）：目标工作簿（例如`workbook_id`）
+ 工作@@ **表名称**（必填）：目标工作表（默认：“Sheet1"）
+ 从@@ **单元格开始**（可选）：数据放置的起始位置（默认：“A1”）
+ **包括标题**（复选框）：启用时写入列标题（默认值：TRUE）

## 写入手机
<a name="write-to-cell"></a>

向单元格输出一个值。用于更新工作表中的单个单元格。

**特性：**
+ **要写的值**（必填）：单元格的内容（例如，“Order \$112345”）
+ **工作簿标识符**（必填）：目标工作簿（例如`workbook_id`）
+ 工作@@ **表名称**（必填）：目标工作表（默认：“Sheet1"）
+ **单元格引用**（必填）：目标单元格位置（例如 “A1”）

## 写新行
<a name="write-new-row"></a>

向工作表中添加一行数据。新行将追加到现有数据的末尾。

**特性：**
+ **行值**（必填）：新行的值数组，从第一列开始（例如，["Q1"、“Sales”、100]）
+ **工作簿标识符**（必填）：目标工作簿（例如`workbook_id`）
+ 工作@@ **表名称**（必填）：目标工作表（默认：“Sheet1"）

**数据验证：**
+ 必须以数组格式提供值
+ 值从第一列开始按顺序写入

## 创建新工作表
<a name="create-new-sheet"></a>

添加一个空白工作表。新工作表将添加到工作簿的末尾。

**特性：**
+ **工作簿标识符**（必填）：目标工作簿（例如`workbook_id`）
+ 工作@@ **表名称**（必填）：新工作表的名称（例如，“销售数据”）

## 复印表
<a name="copy-sheet"></a>

创建工作表的副本。新工作表是在同一个工作簿中创建的。

**特性：**
+ **工作簿标识符**（必填）：目标工作簿（例如`workbook_id`）
+ **要复制的工作表名称**（必填）：源工作表名称（例如，“原始工作表”）
+ **新工作表名称**（必填）：重复工作表的名称（例如，“原始工作表（副本）”）

## 重命名工作表
<a name="rename-sheet"></a>

更新现有工作表的名称。

**特性：**
+ **工作簿标识符**（必填）：目标工作簿（例如`workbook_id`）
+ **当前工作表名称**（必填）：现有工作表名称（例如 “Sheet1”）
+ **更新的工作表名称**（必填）：工作表的新名称（例如，“第一季度数据”）

## 删除工作表
<a name="delete-sheet"></a>

从工作簿中移除工作表。无法删除工作簿中最后剩下的工作表。

**特性：**
+ **工作簿标识符**（必填）：目标工作簿（例如`workbook_id`）
+ **要删除的工作表名称**（必填）：要删除的工作表（例如，“Sheet1”）

**约束**：
+ 无法删除工作簿中最后剩下的工作表

## 设置单元格颜色
<a name="set-cell-color"></a>

更新单元格背景颜色。用于突出显示特定范围的单元格。

**特性：**
+ **单元格颜色**（必填）：RGB 十六进制代码格式（例如，“FF0000” 代表红色）
+ **工作簿标识符**（必填）：目标工作簿（例如`workbook_id`）
+ 工作@@ **表名称**（必填）：目标工作表（例如 “Sheet1”）
+ **单元格范围**（必填）：格式范围-支持：
  + 单节电池：“A1”
  + 确切范围：“A1: B10”
  + 列范围：“A: B”
  + 行范围：“1:3”

## 获取单元格颜色
<a name="get-cell-color"></a>

读取单元格背景颜色。以 RGB 十六进制代码格式输出颜色（例如，“FF0000” 代表红色）。

**特性：**
+ **工作簿标识符**（必填）：源工作簿（例如`workbook_id`）
+ 工作@@ **表名称**（必填）：源工作表（例如 “Sheet1”）
+ **单元格引用**（必填）：要读取的单元格（例如 “A1”）
+ **单元格颜色**（输出）：存储 RGB 十六进制代码的变量（默认：`cell_color`）

## 隐藏行
<a name="hide-rows"></a>

使行隐藏在工作表中。数据保持不变，但不可见。

**特性：**
+ **工作簿标识符**（必填）：目标工作簿（例如`workbook_id`）
+ 工作@@ **表名称**（必填）：目标工作表（例如 “Sheet1”）
+ **起始行**（必填）：要隐藏的第一行编号（Excel 编号从 1 开始）
+ **结束行**（可选）：要隐藏的最后一行号。如果为空，则仅隐藏起始行

**行号：**
+ Excel 行号从 1 开始（不是 0）
+ 必须提供整数值

## 取消隐藏行
<a name="unhide-rows"></a>

使隐藏的行可见。用于显示以前隐藏的行。

**特性：**
+ **工作簿标识符**（必填）：目标工作簿（例如`workbook_id`）
+ 工作@@ **表名称**（必填）：目标工作表（例如 “Sheet1”）
+ **起始行**（必填）：要取消隐藏的第一行编号（Excel 编号从 1 开始）
+ **结束行**（可选）：要取消隐藏的最后一行号。如果为空，则仅显示起始行

## 最佳做法和限制
<a name="excel-best-practices-limitations"></a>

### 工作簿标识符管理
<a name="excel-workbook-identifier-management"></a>
+ 将工作簿标识符存储在描述性变量中（例如`sales_workbook`，`report_file`）
+ 在同一工作簿的多个操作中重复使用相同的标识符
+ 在执行数据操作之前，请务必创建或打开工作簿

### 范围规格
<a name="excel-range-specifications"></a>
+ 使用精确范围 (“A1: B10”) 进行精确的数据操作
+ 处理整列时使用列范围（“A: B”）
+ 使用行范围 (” 1:3”) 进行标题或摘要操作
+ 将范围留空以处理整张工作表

### 性能优化
<a name="excel-performance-optimization"></a>
+ 尽可能读取整个范围，而不是单个单元格
+ 使用数据表进行批量写入操作，而不是单个单元格写入
+ 仅在所有修改完成后才保存工作簿

### 限制
<a name="excel-limitation"></a>

文件兼容性仅限于现代 Excel (.xlsx) 格式，不支持旧版 Excel (.xls) 文件。