Microsoft Excel 指令

若要管理 Microsoft Excel® 工作簿作為連鎖的一部分，請新增包含 Microsoft Excel 連線指令的步驟。

注意： Microsoft Excel 連接器支援啟用巨集的 Excel 工作簿 (XLSM) 檔案，但不會執行任何 Virtual Basic for Applications (VBA) 巨集或基於事件的巨集，例如 Workbook Open、BeforeSave 或 SheetCalculate。

從檔案建立工作簿

使用Create Workbook from Files 指令，根據分隔符分隔的值檔案的資料，建立或更新 Excel 工作簿與工作表。

請注意，根據連接器的設定方式，您有兩個輸出選項：

如果使用GroundRunner ，請輸入 Javascript Object Notation (JSON) 物件。
如果使用CloudRunner ，请在链中指定其命令输出或资源。

摘要資訊

摘要資訊	詳細資訊
檔案	指定要在工作簿中建立為獨立工作表的檔案：對於基於鏈中輸出或資源的檔案，按一下為每個檔案新增，選擇其輸出或資源，並輸入工作表名稱（最多 31 個字元）。祕訣：若要從網路位置擷取檔案，請使用File Utilities connector'sGet file 指令。若要指定檔案為 JSON，請選擇啟用變數，然後輸入 JSON 或從先前命令的輸出中選擇 JSON 物件。JSON 格式為 [ {「檔案」: "fullPathToFile_1", 「名稱」: 「工作表名稱_1」}, {「檔案」: "fullPathToFile_2", 「名稱」: 「工作表名稱_2」} ] 注意：若要在 JSON 中包含先前命令的輸出檔案，請輸入其在 GroundRunner 處理資料夾中位置的完整路徑。
分隔符號	選擇檔案中使用的分隔符。
工作簿名稱	若要根據檔案建立新工作簿，請輸入唯一的名稱以協助識別。注意：如果未提供副檔名，該命令會自動建立附加`.xlsx` 副檔名。
現有工作簿	若要將檔案的資料新增至現有的工作簿，而非新增工作簿，請選取要更新的工作簿檔案。任何在Files 中輸入名稱的工作表都會被覆蓋。重要：對受保護檔案使用此指令時，產生的工作簿不會受到保護。這表示您在處理受保護檔案時，必須手動重新新增加密。

输出

輸出	輸出類型
XLSX 工作簿	檔案

退出代碼

代碼	類型	詳細資訊
0	成功	指令成功
1	錯誤	一般故障

列出工作表

若要建立 Excel 工作簿中所有工作表的 JSON 清單，請使用List Sheets 指令。

摘要資訊

摘要資訊	詳細資訊
工作簿檔案	輸入要列出工作表的 XLS 或 XLSX 工作簿。
密碼	如果工作簿檔案是受密碼保護的 XLSX 工作簿，請輸入其密碼。

输出

輸出	輸出類型
工作表 JSON	檔案

退出代碼

代碼	類型	詳細資訊
0	成功	指令成功
1	錯誤	一般故障

工作表轉 CSV

若要將 Excel 工作簿的工作表中的資料轉換為表格檔案，請使用工作表轉 CSV 指令。

備註：工作表轉 CSV 指令會擷取工作表中最後一次計算的值；不會執行公式計算來更新值。對於停用自動計算的工作表，請在執行鏈之前手動計算並儲存值，以確保準確性。

摘要資訊

摘要資訊	詳細資訊
工作簿檔案	輸入 XLS 或 XLSX 工作簿，並輸入要轉換為表格檔案的工作表。
密碼	如果工作簿檔案是受密碼保護的 XLSX 工作簿，請輸入其密碼。
分隔符號	選擇要在輸出檔案中使用的分隔符。
工作表名稱	輸入要轉換的工作簿工作表名稱。若要以索引來識別工作表，請留空。
工作表索引	輸入要轉換的工作表在工作簿中的索引位置，第一個工作表為`1` ，最後一個工作表為`-1` 。若要以工作表名稱識別工作表，請留空。
開始儲存格	輸入工作表資料第一行和第一列中要轉換的儲存格。
結束列	在 A1 表示法中，輸入要轉換的資料結束所在列的字母，例如 A、B 或 C，但不包括行號。註記：指令會忽略工作表中此列之後的任何資料。
結束行	在 A1 表示法中，輸入要轉換的資料結束的行數，例如 10、200、3000，但不含列字母。要忽略該行，請輸入`0` 。註記：指令會忽略此行之後列中的任何資料。
使用格式化的儲存格數值	若要轉換儲存格的顯示值而非原始值，例如處理日期/時間，請勾選此方塊。
預覽結果	若要啟用輸出檔案的預覽，請勾選此方塊。
串流模式	僅適用於大型 XLSX 檔案。建議使用於 20 MB 以上的檔案。以較小的資料視窗讀取檔案，以減少記憶體使用量。當此設定與格式化值選項同時啟用時，某些公式，尤其是引用檔案中較遠儲存格的公式，可能無法正常運作。

输出

輸出	輸出類型
輸出 CSV	檔案

退出代碼

代碼	類型	詳細資訊
0	成功	指令成功
1	錯誤	一般故障

支援

社群

Workiva 支援中心

Microsoft Excel 指令

注意： Microsoft Excel 連接器支援啟用巨集的 Excel 工作簿 (XLSM) 檔案，但不會執行任何 Virtual Basic for Applications (VBA) 巨集或基於事件的巨集，例如 Workbook Open、BeforeSave 或 SheetCalculate。

從檔案建立工作簿

摘要資訊

祕訣：若要從網路位置擷取檔案，請使用File Utilities connector'sGet file 指令。

注意：若要在 JSON 中包含先前命令的輸出檔案，請輸入其在 GroundRunner 處理資料夾中位置的完整路徑。

注意：如果未提供副檔名，該命令會自動建立附加`.xlsx` 副檔名。

重要：對受保護檔案使用此指令時，產生的工作簿不會受到保護。這表示您在處理受保護檔案時，必須手動重新新增加密。

输出

退出代碼

列出工作表

摘要資訊

输出

退出代碼

工作表轉 CSV

備註：工作表轉 CSV 指令會擷取工作表中最後一次計算的值；不會執行公式計算來更新值。對於停用自動計算的工作表，請在執行鏈之前手動計算並儲存值，以確保準確性。

摘要資訊

註記：指令會忽略工作表中此列之後的任何資料。

註記：指令會忽略此行之後列中的任何資料。

输出

退出代碼

Workiva 支援中心

Microsoft Excel 指令

注意： Microsoft Excel 連接器支援啟用巨集的 Excel 工作簿 (XLSM) 檔案，但不會執行任何 Virtual Basic for Applications (VBA) 巨集或基於事件的巨集，例如 Workbook Open、BeforeSave 或 SheetCalculate。

從檔案建立工作簿

摘要資訊

祕訣： 若要從網路位置擷取檔案，請使用File Utilities connector'sGet file 指令 。

注意： 若要在 JSON 中包含先前命令的輸出檔案，請輸入其在 GroundRunner 處理資料夾中位置的完整路徑。

注意： 如果未提供副檔名，該命令會自動建立附加.xlsx 副檔名。

重要： 對受保護檔案使用此指令時，產生的工作簿不會受到保護。這表示您在處理受保護檔案時，必須手動重新新增加密。

输出

退出代碼

列出工作表

摘要資訊

输出

退出代碼

工作表轉 CSV

備註： 工作表轉 CSV 指令會擷取工作表中最後一次計算的值；不會執行公式計算來更新值。對於停用自動計算的工作表，請在執行鏈之前手動計算並儲存值，以確保準確性。

摘要資訊

註記： 指令會忽略工作表中此列之後的任何資料。

註記： 指令會忽略此行之後列中的任何資料。

输出

退出代碼

祕訣：若要從網路位置擷取檔案，請使用File Utilities connector'sGet file 指令。

注意：若要在 JSON 中包含先前命令的輸出檔案，請輸入其在 GroundRunner 處理資料夾中位置的完整路徑。

注意：如果未提供副檔名，該命令會自動建立附加`.xlsx` 副檔名。

重要：對受保護檔案使用此指令時，產生的工作簿不會受到保護。這表示您在處理受保護檔案時，必須手動重新新增加密。

備註：工作表轉 CSV 指令會擷取工作表中最後一次計算的值；不會執行公式計算來更新值。對於停用自動計算的工作表，請在執行鏈之前手動計算並儲存值，以確保準確性。

註記：指令會忽略工作表中此列之後的任何資料。

註記：指令會忽略此行之後列中的任何資料。