取得 Excel 表格
從 Excel 檔案中具有指定列和直欄座標的表格取得值。
指令可用性: IBM RPA SaaS 及 IBM RPA 內部部署
Script 語法
IBM RPA 的專有 Script 語言具有類似於其他程式設計語言的語法。 Script 語法在 Script 檔中定義指令的語法。 您可以在 IBM RPA Studio的 Script 模式中使用此語法。
excelGetTable --file(Excel) [--getfirstsheet(Boolean)] --sheet(String) [--entiretable(Boolean)] [--userange(Boolean)] --range(String) --fromrow(Numeric) --fromcolumn(Numeric) [--torow(Numeric)] [--tocolumn(Numeric)] [--hasheaders(Boolean)] (DataTable)=value (Numeric)=rows (Numeric)=columns
相依關係
- 若要使用此指令，請使用 開啟 Excel 檔案 (
excelopen) 指令開啟 Excel 檔案。
輸入參數
下表顯示此指令中可用的輸入參數清單。 在表格中，當您在 IBM RPA Studio的 Script 模式及其 Designer 模式對等標籤中工作時，可以看到參數名稱。
| 設計程式模式標籤 | Script 模式名稱 | 必要 | 接受的變數類型 | 說明 |
|---|---|---|---|---|
| Excel 實例 | file |
Required |
Excel |
儲存 Excel 實例的變數。 |
| 使用第一個試算表 | getfirstsheet |
Optional |
Boolean |
啟用以讀取第一個試算表中可用的資料。 |
| 試算表 | sheet |
Required when the Use First Spreadsheet parameter is disabled |
Text |
包含所需表格的試算表名稱。 |
| 取得整個表格 | entiretable |
Optional |
Boolean |
啟用以取得整個表格的值。 |
| 使用間隔 | userange |
Optional |
Boolean |
啟用以設定表格資料格之間的間隔。 |
| 間隔 | range |
Required when the Use Interval parameter is enabled |
Text |
指定從中擷取表格的資料格範圍。 此範圍是透過以冒號 (:) 區隔第一個和最後一個資料格來定義。 範例: A1:D5 |
| 來源列 | fromrow |
Required when the Use Interval parameter is disabled |
Number |
設定必須從中擷取資料的起始列。 |
| 來源直欄 | fromcolumn |
Required when the Use Interval parameter is disabled |
Number |
設定必須從中擷取資料的起始直欄。 |
| 目標列 | torow |
Optional |
Number |
定義要從中擷取資料的最後一列。 |
| 目標直欄 | tocolumn |
Optional |
Number |
定義要從中擷取資料的最後一直欄。 |
| 具有標頭 | hasheaders |
Optional |
Boolean |
啟用以使用試算表的第一列作為標頭。 |
輸出參數
| 設計程式模式標籤 | Script 模式名稱 | 接受的變數類型 | 說明 |
|---|---|---|---|
| 表格 | 值 | Data Table |
傳回從 Excel 檔案取得的資料表。 |
| 列數 | rows | Number |
傳回所取得資料表的總列數。 |
| 直欄 | 直欄 | Number |
傳回所取得資料表的總直欄數。 |
範例
此指令會從名為 "excelFile" 的 Excel 檔案中擷取第一個試算表的所有內容。 之後，資料表的內容以及有問題試算表的列數和欄數會顯示在 IBM RPA Studio 主控台上。
defVar --name excelFile --type Excel
defVar --name dataTable --type DataTable
defVar --name rows --type Numeric
defVar --name columns --type Numeric
excelOpen --file "file" excelFile=value
excelGetTable --file ${excelFile} --getfirstsheet--entiretabledataTable=value rows=rows columns=columns
excelClose --file ${excelFile} --save
logMessage --message "\r\nData Table: ${dataTable}\r\nRows: ${rows}\r\nColumns: ${columns}\r\n" --type "Info"
// Result: Data Table: Info 01, Info 02, Info 03
// Rows: 1
// Columns: 3
❕ 重要事項: 若要執行範例 Script ，您必須使用或建立檔案，填寫 A、B 及 C 直欄的 "1" 列，然後在 開啟 Excel 檔案 指令的 File path 參數中輸入檔案路徑。
限制
IBM RPA 會顯示日期值及時間，不論其格式為何。
範例： 01/14/2022 -> 01/14/2022 12:00:00AM