本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
Excel
Excel 動作可讓您在自動化中讀取、更新和建立 Excel 檔案。所有 Excel 動作都支援 .xlsx 和 .xlsm 檔案格式。工作手冊識別符會維護多個操作的參考。
注意
雖然可以從 .xlsm 檔案讀取值，但不支援巨集執行。
建立新的工作手冊
建立空白 Excel 檔案。輸出工作手冊識別符，您可以在後續步驟中用來更新試算表。
屬性：
工作手冊識別符 （輸出）：儲存工作手冊參考以供未來動作使用的變數名稱 （預設：
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"
空白：讀取整個工作表
包含標頭 （核取方塊）：啟用時將第一列視為欄標頭。停用時， 會使用預設命名 (Column0、Column1 等） （預設值：TRUE)
資料表 （輸出）：儲存擷取資料的變數 （預設：
excel_table)
公式處理：
動作會自動計算公式，並將結果存放在資料表中。
讀取儲存格
從儲存格取得值。用來從工作表讀取個別儲存格值。
屬性：
工作手冊識別符 （必要）：要讀取的工作手冊 （例如
workbook_id)工作表名稱 （必要）：工作表名稱 （預設：「Sheet1」)
儲存格參考 （必要）：儲存格位置 （例如 "A1")
儲存格值 （輸出）：儲存儲存格內容的變數 （預設：
cell_value)
寫入工作表
將資料表輸出至工作表。用來將資料列和資料欄的範圍寫入工作表。
屬性：
資料表 （必要）：要寫入的資料表 （例如
my_table)工作手冊識別符 （必要）：目標工作手冊 （例如
workbook_id)工作表名稱 （必要）：目標工作表 （預設：「Sheet1」)
從儲存格開始 （選用）：資料放置的開始位置 （預設："A1")
包含標頭 （核取方塊）：啟用時寫入欄標頭 （預設值：TRUE)
寫入儲存格
將值輸出至儲存格。用來更新工作表中的個別儲存格。
屬性：
要寫入的值 （必要）：儲存格的內容 （例如，「訂單 #12345」)
工作手冊識別符 （必要）：目標工作手冊 （例如
workbook_id)工作表名稱 （必要）：目標工作表 （預設：「Sheet1」)
儲存格參考 （必要）：目標儲存格位置 （例如 "A1")
寫入新資料列
將資料列新增至工作表。新資料列會附加到現有資料的結尾。
屬性：
資料列值 （必要）：新資料列的值陣列，從第一欄開始 （例如 【"Q1"、"Sales"、100】)
工作手冊識別符 （必要）：目標工作手冊 （例如
workbook_id)工作表名稱 （必要）：目標工作表 （預設：「Sheet1」)
資料驗證：
必須以陣列格式提供值
值會從第一欄開始循序寫入
建立新工作表
新增空白工作表。新的工作表會新增至工作手冊的結尾。
屬性：
工作手冊識別符 （必要）：目標工作手冊 （例如
workbook_id)工作表名稱 （必要）：新工作表的名稱 （例如「銷售資料」)
複製工作表
建立工作表的副本。新工作表會在相同的工作手冊中建立。
屬性：
工作手冊識別符 （必要）：目標工作手冊 （例如
workbook_id)要複製的工作表名稱 （必要）：來源工作表名稱 （例如「原始工作表」)
新工作表名稱 （必要）：複製工作表的名稱 （例如「原始工作表 （複製）」)
重新命名工作表
更新現有工作表的名稱。
屬性：
工作手冊識別符 （必要）：目標工作手冊 （例如
workbook_id)目前工作表名稱 （必要）：現有工作表名稱 （例如 "Sheet1")
更新工作表名稱 （必要）：工作表的新名稱 （例如 "Q1 Data")
刪除工作表
從工作手冊中移除工作表。無法刪除工作手冊的最後一個剩餘工作表。
屬性：
工作手冊識別符 （必要）：目標工作手冊 （例如
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")
Start Row （必要）：要隱藏的第一列號碼 (Excel 編號從 1 開始）
結束資料列 （選用）：要隱藏的最後一個資料列號碼。如果為空，則只會隱藏起始列
資料列編號：
Excel 資料列號碼從 1 開始 （非 0)
必須提供整數值
取消隱藏資料列
讓隱藏的資料列可見。用來顯示先前隱藏的資料列。
屬性：
工作手冊識別符 （必要）：目標工作手冊 （例如
workbook_id)工作表名稱 （必要）：目標工作表 （例如 "Sheet1")
Start Row （必要）：要取消隱藏的第一個資料列編號 (Excel 編號從 1 開始）
結束資料列 （選用）：要取消隱藏的最後一個資料列號碼。如果為空，則只會顯示起始列
最佳實務和限制
手冊識別符管理
將工作手冊識別符存放在描述性變數中 （例如
sales_workbook、report_file)在同一工作手冊上的多個動作之間重複使用相同的識別符
在執行資料操作之前，請務必建立或開啟工作手冊
範圍規格
使用精確範圍 ("A1：B10") 進行精確的資料操作
使用整個資料欄時，請使用資料欄範圍 ("A：B")
針對標頭或摘要操作使用資料列範圍 ("1：3")
將範圍保留空白以處理整個工作表
效能最佳化
盡可能讀取整個範圍，而不是個別儲存格
使用資料表而非個別儲存格寫入的批次寫入操作
只有在所有修改完成時才儲存工作手冊
限制
檔案相容性僅限於現代 Excel (.xlsx) 格式 - 不支援舊版 Excel (.xls) 檔案。
