Excel 値の取得
列と行の座標を使用して、Excel ファイル内のセルの値を取得します。
コマンドの可用性: IBM RPA SaaS および IBM RPA オンプレミス
スクリプト構文
IBM RPA の専有スクリプト言語の構文は、他のプログラミング言語と似ています。 スクリプト構文は、スクリプト・ファイル内のコマンドの構文を定義します。 この構文は、 IBM RPA Studioの 「スクリプト」 モードで操作できます。
excelGet --file(Excel) [--getfirstsheet(Boolean)] --sheet(String) [--usingcell(Boolean)] --cell(String) --row(Numeric) --column(Numeric) (Scalar)=value
依存関係
- このコマンドを使用するには、 Excel ファイルを開く (
excelopen) コマンドを使用して Excel ファイルを開きます。
入力パラメーター
以下の表は、このコマンドで使用可能な入力パラメーターのリストを示しています。 この表では、 IBM RPA Studioのスクリプト・モードで作業しているときのパラメーター名と、それに相当する Designer モードのラベルを確認できます。
| 「デザイナー」モードのラベル | 「スクリプト」モードの名前 | 必須 | 使用可能な変数タイプ | Description |
|---|---|---|---|---|
| ファイル | file |
Required |
Excel |
Excel インスタンスを保管する変数。 |
| 最初のシートを使用 | getfirstsheet |
Optional |
Boolean |
ファイルの最初のスプレッドシートの入力された座標に対応する値を取得します。 |
| シート | sheet |
Required when the Use First Sheet parameter is disabled |
Text |
値の取得元となるワークシートの名前。 |
| セルの指定 | usingcell |
Optional |
Boolean |
これを有効にすると、cell パラメーターで完全なセル座標が使用されます。 |
| セル | cell |
Required when the Specify Cell parameter is enabled |
Text |
値の取得元のセル。 例:「B3」。 |
| 行 | row |
Required when the Specify Cell parameter is disabled |
Number |
値を入力する必要がある行座標に対応するエレメント。 例: "A1" の "1" |
| 列 | column |
Required when the Specify Cell parameter is disabled |
Number |
値を入力する必要がある列座標に対応するエレメント。 例: "A1" の "A" |
出力パラメーター
| 「デザイナー」モードのラベル | 「スクリプト」モードの名前 | 使用可能な変数タイプ | Description |
|---|---|---|---|
| 値 | 値 | Primitives |
入力された座標を介して検出されたセルから取得された値を持つ変数を返します。 |
例
このスクリプトは、「Excel ファイルを開く」コマンドを使用して Excel ファイルを開き、それを「OpenExcel File」変数に格納します。 「Excel 値の取得」 コマンドは、この変数と Use First Sheet パラメーターおよび Specify Cell パラメーターを使用して、 A1 セルの値を取得します。 「Excel を閉じる」によってファイルを閉じ、「メッセージのログ」コマンドによって、IBM RPA Studio コンソールから取得した値を記録します。
defVar --name openedExcelFile --type Excel
defVar --name obtainedValue --type String
excelOpen --file "samplefile" --savechangesopenedExcelFile=value
excelGet --file ${openedExcelFile} --getfirstsheet--usingcell--cell A1 obtainedValue=value
excelClose --file ${openedExcelFile} --save
logMessage --message "Obtained Value: ${obtainedValue}\r\n" --type "Info"
❕ 重要: サンプル・スクリプトを実行するには、ファイルを作成して「A1」セルに入力してから、 Open Excel File (excelopen) コマンドにそのパスを入力する必要があります。
制限
IBM RPA は、形式に関係なく、日付値と時刻を表示します。
例: 01/14/2022-> 01/14/2022 12:00:00AM