本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

Excel 動作可讓您在自動化中讀取、更新和建立 Excel 檔案。所有 Excel 動作都支援 .xlsx 和 .xlsm 檔案格式。工作手冊識別符會維護多個操作的參考。

**注意**  
雖然可以從 .xlsm 檔案讀取值，但不支援巨集執行。

## 建立新的工作手冊
<a name="create-new-workbook"></a>

建立空白 Excel 檔案。輸出工作手冊識別符，您可以在後續步驟中用來更新試算表。

**屬性：**
+ **工作手冊識別符** （輸出）：儲存工作手冊參考以供未來動作使用的變數名稱 （預設：`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"
  + 空白：讀取整個工作表
+ **包含標頭 **（核取方塊）：啟用時將第一列視為欄標頭。停用時， 會使用預設命名 (Column0、Column1 等） （預設值：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>

將值輸出至儲存格。用來更新工作表中的個別儲存格。

**屬性：**
+ **要寫入的值** （必要）：儲存格的內容 （例如，「訂單 \$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")
+ **更新工作表名稱** （必要）：工作表的新名稱 （例如 "Q1 Data")

## 刪除工作表
<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")
+ **Start Row** （必要）：要隱藏的第一列號碼 (Excel 編號從 1 開始）
+ **結束資料列 **（選用）：要隱藏的最後一個資料列號碼。如果為空，則只會隱藏起始列

**資料列編號：**
+ Excel 資料列號碼從 1 開始 （非 0)
+ 必須提供整數值

## 取消隱藏資料列
<a name="unhide-rows"></a>

讓隱藏的資料列可見。用來顯示先前隱藏的資料列。

**屬性：**
+ **工作手冊識別符** （必要）：目標工作手冊 （例如 `workbook_id`)
+ **工作表名稱** （必要）：目標工作表 （例如 "Sheet1")
+ **Start Row** （必要）：要取消隱藏的第一個資料列編號 (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) 檔案。