範囲を読み込み

UiPath.MicrosoftOffice365.Activities.Excel.ReadRange

説明

Microsoft Graph の GetRange API を使用して、ブック ([ブック]) のワークシート ([シート名]) 内の指定したセル範囲 ([範囲]) から値を取得します。アクティビティは、セル データの範囲を取得すると、その値を DataTable ([データ テーブル]) に出力します。

スコープ

このアクティビティには、次のスコープが必要です。

• Sites.Read.All

OR

• Sites.ReadWrite.All

プロジェクトの対応 OS

Windows - レガシ |Windows

構成

プロパティ

共通

• 表示名 - アクティビティの表示名です。 このプロパティは、String 型変数と文字列形式の値をサポートします。

入力

• [範囲] - 読み込むセルの範囲です。範囲が指定されていない場合、シート全体が読み込まれます。A1 形式の表記でセルの範囲を入力します (例: "A1:A5")。このプロパティは、String 型変数と文字列形式の値をサポートします。
• シート名 - データの読み込み元シートの名前です。 このプロパティは、String 型変数と文字列形式の値をサポートします。
• ブック - データの読み込み元 DriveItem です。このオブジェクトは [ファイルやフォルダーを探す] アクティビティを使用して取得できます。[ファイルやフォルダーを探す] アクティビティの出力プロパティ変数 ([最初] または [結果]) または [ブックを作成] アクティビティの出力プロパティ変数 ([ブック]) を使用します。[ファイルやフォルダーを探す] アクティビティの [結果] 出力プロパティを使用する場合、必ず配列内の使用する項目を指定してください (例: myWorkbooks(0))。

その他

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

オプション

• ヘッダーを追加 - 選択した場合、範囲内の最初の行が [データ テーブル] の列ヘッダーとして追加されます。 このフィールドでは、Boolean 値がサポートされています。

• 値の種類 ｰ ドキュメントから読み取るデータの種類です。ドロップダウン リストを使用して、次の 3 つのオプションのいずれかを選択します。

  • 値 ｰ 既定値です。行内のセルのコード化された値 (つまりバックエンド) を取得します。これは Excel ワークシートに表示されるフォーマット値とは異なる可能性があります (例: ワークシートでセルが 23.00 と表示されている場合に、コード化された値として 23 が返される)。
  • 式 - 指定されたセルの式のみを取得します (例: =SUM(A1,B1))。[式] を選択しても、指定したセルに式が含まれていない場合、戻り値は既定で [値] に設定されます。
  • テキスト - セルの Excel ワークシート値を取得します (例: ワークシートでセルが 23.00 と表示されている場合、テキスト値として 23.00 が返されます)。

出力

• データ テーブル - 読み込みの結果です。このフィールドでは DataTable 変数のみをサポートします。後続のアクティビティで出力データを使用する予定がある場合は必須です。データ テーブルの内容を取得するには、[データ テーブル] 入力プロパティを持つアクティビティ (例 : [データ テーブルを出力]、[繰り返し (各行)]、[CSV に追加] など) を使用します。

動作のしくみ

以下の手順とメッセージ シーケンス ダイアグラムは、設計時 (つまり、アクティビティの依存関係と入/出力プロパティ) から実行時に至るまでの、アクティビティの動作のしくみの例を示したものです。

1. 手順を完了します。
2. プロジェクトに [Microsoft Office 365 スコープ] アクティビティを追加します。
3. DriveItem オブジェクトを出力するアクティビティを追加するか外部プロセスを実行します (例 : [ファイルやフォルダーを探す]、[ブックを作成]、[アイテムをコピー])。
4. [Microsoft Office 365 スコープ] アクティビティ内に [範囲を読み込み] アクティビティを追加します。
5. [入力] セクションのプロパティに値を入力します。
6. [出力] セクションのプロパティのために DataTable 型変数を作成し、入力します。

7. アクティビティを実行します。

   • 入力したプロパティ値は、GetRange API に渡されます。
   • API は、[出力] セクションのプロパティ変数に DataTable の値を返します。