Excel 合併
按照所設定的順序，將多個 Excel 檔案的內容合併為一個檔案。
指令可用性: IBM RPA SaaS 及 IBM RPA 內部部署
Script 語法
IBM RPA 的專有 Script 語言具有類似於其他程式設計語言的語法。 Script 語法在 Script 檔中定義指令的語法。 您可以在 IBM RPA Studio的 Script 模式中使用此語法。
excelMerge --directory(String) [--filemask(String)] [--outputfile(String)] [--compatibilitymode(Boolean)] --fileordering(FileOrdering) (String)=file (Numeric)=numberoftabs
相依關係
- 若要使用此指令，請使用 開啟 Excel 檔案 (
excelopen) 指令開啟 Excel 檔案。
輸入參數
下表顯示此指令中可用的輸入參數清單。 在表格中，當您在 IBM RPA Studio的 Script 模式及其 Designer 模式對等標籤中工作時，可以看到參數名稱。
| 設計程式模式標籤 | Script 模式名稱 | 必要 | 接受的變數類型 | 說明 |
|---|---|---|---|---|
| 目錄 | directory |
Required |
Text |
檔案所在目錄的完整路徑。 |
| 檔案遮罩 | filemask |
Optional |
Text |
在搜尋中套用的過濾器。 必須如下所示插入: FILENAME.FILE_EXTENSION。 以下是一些範例:- *.xlsx: 過濾副檔名為 ". xlsx" 的所有檔案; - name: 過濾名稱中包含單字 "name" 的所有檔案。❕ 重要事項: 請勿在 FILENAME中使用大寫字母或空格。 |
| 輸出檔 | outputfile |
Optional |
Text |
Excel 檔案合併至其中的檔案路徑。 |
| 相容模式 | compatibilitymode |
Optional |
Boolean |
如果任何 Excel 檔案的副檔名與 File mask 參數中指定的副檔名不同，則應該使用此選項。 |
| 檔案排序 | fileordering |
Required |
FileOrdering |
將檔案內容儲存到輸出檔案的順序。 |
輸出參數
| 設計程式模式標籤 | Script 模式名稱 | 接受的變數類型 | 說明 |
|---|---|---|---|
| 檔案 | file | Text |
傳回一個變數，其值為包含合併內容的檔案的完整路徑。 |
| 工作表數目 | numberoftabs | Number |
傳回所建立的工作表數。 |
範例
下列程式碼範例示範如何將特定目錄中的所有檔案合併至一個檔案。
defVar --name sourceFileFolder --type String
defVar --name sheetsQuantity --type Numeric
excelMerge --directory "Enter source directory" --outputfile "Enter the destination excel file" --fileordering "None" sourceFileFolder=file sheetsQuantity=numberoftabs
logMessage --message "\r\n${sourceFileFolder}\r\n${sheetsQuantity}" --type "Info"
限制
如果在 輸出檔 參數中輸入不存在的檔案，則會建立包含 Directory 檔案內容的新檔案。