「Excel範囲を読み込む」アクテビティについてご紹介します。アクテビティの概要と使用例を参考に使い方をご説明します。
1. アクティビティのプログラム名
RCA.Activities.Excel.ExcelReadRange
2. 説明
クイックアクセス： 「ツールボックス」 > 「Excel」 > 「Excel範囲を読み込む」
指定した範囲の値をExcelファイルから読み込み、DataTable型の変数に格納します。
※動作を確認したコボットStudioのバージョン：2.0.1.3
※バージョンによって文言などが一部異なる場合がございます
3. プロパティ
| プロパティ項目 | プロパティ名 | 入力欄 | 説明 |
|---|---|---|---|
| オプション | フィルターを使用 | チェック項目 | フィルターを使用可能 |
| フォーマットを保持 | チェック項目 | Excelの表示形式を保持 | |
| ヘッダを追加 | チェック項目 | ヘッダーを追加する | |
| その他 | パブリック | チェック項目 | アクテビティ内の変数と引数がログファイルに書き込まれ、センターにプッシュされる |
| 表示名 | 値を入力（String型） | アクティビティ名を変更 | |
| 出力 | データテーブル | 値を入力（DataTable型） | 読み取った値を指定した変数に格納 |
| 入力 | シート名 | 値を入力（String型） | シート名を指定 |
| 範囲 | 値を入力（String型） | 範囲を指定 |
4. 使い方
「Excel範囲を読み込む」アクティビティの使用例を参考に説明します。
【例】メッセージボックスに「sample.xlsx」のセル番号A1～A3の値を表示する
まず、Excelアプリケーションを開くためのアクティビティについてです。
コボットStudioの①「Excelアプリケーション範囲」アクティビティを、指定のシーケンス内にドラックアンドドロップで配置します。アクティビティを追加後、値を読み込みたいExcelファイルのパスを指定します。下記画面キャプチャのイメージです。
値を読み込む「sample.xlsx」を開くため、
②「プロパティ」＞「ファイル」＞「ワークブックパス」へ「sample.xlsxのパス」
を入力すると「Excelアプリケーション範囲」の設定が完成します。
次に、表示対象となる「sample.xlsx」のセル番号A1～A3の値を取得するアクティビティです。
コボットStudioの③「Excel範囲を読み込む」アクティビティを、「Excelアプリケーション範囲」内にドラックアンドドロップで配置します。アクテビティを追加した後、読み込み先シート名とセル範囲、そして読み込んだ値を格納する変数を設定します。下記画面キャプチャのイメージです。
「sample.xlsx」からセル番号A1～A3の値を読み込み変数へ格納するため、
④「プロパティ」＞「出力」＞「データテーブル」に［Ctrl + K］（変数を作成するショートカットキー）で「dtsample」を入力後Enterキー
⑤「プロパティ」＞「入力」＞「シート名」に「sample.xlsx」のシート名「"Sheet1"」
⑥「プロダクト」＞「入力」＞「セル」に「sample.xlsx」の読み込みたいセル範囲「"A1:A3"」
を入力すると「Excelセル範囲を読み込む」の設定が完成します。
※［Ctrl + K］ とは、『［Ctrlキー］を押しながら［K キー］を押す』という意味です。
次は、範囲を指定して読み込んだ値を行ごとに処理を行い表示するアクティビティについてです。
「Excel範囲を読み込む」アクティビティで取得した値を行ごとに処理するためには、「ツールボックス」＞「データテーブル」の「行ごとに処理」を使用します。
コボットStudioの⑦「行ごとに処理」アクテビティを、「Excelアプリケーション範囲」アクテビティ内へドラックアンドドロップで配置します。アクテビティを追加した後、「Excel範囲を読み込む」アクティビティで取得した値を行ごとに処理するため、
⑧「プロパティ」＞「入力」＞「データテーブル」へ④で値を格納した「dtsample」
を入力し「行ごとに処理」の設定が完成します。
行ごとに処理を行った値を表示するためには、「ツールボックス」＞「データテーブル」の「メッセージボックス」アクテビティをを使用します。⑨「メッセージボックス」アクテビティを、「行ごとに処理」アクテビティ内へドラックアンドドロップで配置します。アクテビティを追加した後、処理した値を表示するために、
⑩「プロパティ」＞「入力」＞「テキスト」にセル番号A1「row(0).ToString」
を入力すると「メッセージボックス」の設定が完成します。（※データテーブルについてはこちらの記事をご参照ください。）
下記画面キャプチャのイメージは、ロボット実行後、「sample.xlsx」から取得した値が表示されるメッセージボックスのイメージ図です。
