範囲を読み込み

UiPath.Excel.Activities.ExcelReadRange

Excel の範囲の値を読み取り、DataTable 型変数に格納します。範囲が指定されていない場合、スプレッドシート全体を読み取ります。範囲をセルとして指定した場合は、そのセルを開始セルとする範囲全体を読み取ります。[Excel アプリケーション スコープ] または [Excel ファイルを使用] アクティビティでのみ使用できます。

注: ソフトウェアの制約により、通貨書式が設定されているセルの読み取りでは、小数点以下第 4 位までしか読み取りません。

プロパティ

共通

• 表示名 - アクティビティの表示名です。

入力

• 範囲 - 読み込む範囲です。範囲を指定しない場合は、スプレッドシート全体を読み込みます。範囲をセルとして指定した場合は、そのセルを開始セルとする範囲全体を読み込みます。文字列と String 型変数のみがサポートされます。
• シート名 - 読み込む範囲が含まれるシートの名前です。既定では、これは "Sheet1" に設定されています。String 型変数と文字列のみがサポートされます。

その他

• プライベート - オンにした場合、変数および引数の値が Verbose レベルでログに出力されなくなります。

オプション

• ヘッダーを追加 - オンの場合は、スプレッドシートの指定した範囲の列ヘッダーも抽出されます。既定では、このチェック ボックスはオンになっています (True に設定されています)。

• 表示形式を保持 - 範囲内に表示されているとおりに値を読み込むには、このオプションを選択します (例: 通貨、日付、テキスト)。 実際の数値の書式設定は保持されず、データの表示方法のみが保持されます。 既定では、このオプションは選択されていません。

  注: [表示形式を保持] チェック ボックスをオンにすると、範囲が大きい場合にパフォーマンスの問題が生じることがあります。この問題は、このチェック ボックスをオンにすると、範囲内のセルを一括して読み込まず、1 つずつ読み込むために発生します。
• フィルターの使用 - オンの場合は、アクティビティは指定された範囲からフィルターにより除外されたものを読み取りません。既定では、このチェック ボックスは選択されていないため、一部の情報が除外されているかどうかにかかわらず、範囲全体が読み取られます。

出力

• データ テーブル - 指定した Excel の範囲から抽出したデータを DataTable 型変数に格納します。DataTable 型変数のみがサポートされます。

[範囲を読み込み] アクティビティの使用例

[範囲を読み込み] アクティビティの使い方を、複数のアクティビティを組み込んだサンプルで確認できます。

このアクティビティの使用方法を例示するために、[範囲を読み込み] アクティビティも含むオートメーション プロジェクトを構築しました。

こちらからサンプルを確認してダウンロードできます。