範囲を読み込み

UiPath.GSuite.Activities.ReadRangeConnections

説明

指定した範囲の内容を読み取って保存します。他のアクティビティ (例: [範囲に書き込み]) で使用できます。

スコープ

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

• https://www.googleapis.com/auth/drive.readonly
• https://www.googleapis.com/auth/spreadsheets.readonly
• https://www.googleapis.com/auth/spreadsheets
• https://www.googleapis.com/auth/drive

プロジェクトの対応 OS

Windows | クロスプラットフォーム

構成

• Google スプレッドシートのコネクション - アクティビティで使用する Google Workspace アカウントのコネクションです。

• スプレッドシート - 読み取るスプレッドシートを選択します。また、変数を使用するか、URL または ID の指定するか、あるいは範囲の列を含むスプレッドシートのテンプレートを定義できます。テンプレートを使用することで、アクティビティは範囲と列を生成できます。フォルダー アイコンをクリックすると、Google ドライブのフォルダーを参照してスプレッドシートを選択することができます。このオプションは IResource として入力を受け入れます。プラス ボタンのメニューを使用すると、入力モードを [変数を使用] または [URL または ID] のモード (String) に切り替えることができます。

  • [変数を使用] を選択すると、[スプレッドシートを作成] などの他のアクティビティの出力変数を使用できます。
  • スプレッドシート URL - 対象のスプレッドシートの URL または ID です。このフィールドは、入力モードとして [URL または ID] を選択した場合に使用できます。このプロパティでは、String 型変数と文字列形式の値がサポートされています。詳しくは、「スプレッドシート ID の取得方法」をご覧ください。
  • スプレッドシートのサンプル - 変数ファイルと同じ範囲と列の構造を持つファイルを選択します。[スプレッドシートのテンプレートを使用] をクリックすると表示されます。Google ドライブのフォルダーを参照して、スプレッドシートを選択します。デスクトップ版の Studio では、このオプションは [範囲] の横にあるプラス ボタンのメニューから利用できます。詳しくは、「テンプレートを使用する」をご覧ください。

  • フォルダーを変更してから最新のデータを取得する必要がある場合は、[ブラウザーを再読み込み] オプションを選択します。

• 範囲 - スプレッドシートの設定後に読み込む範囲を選択するか、カスタム範囲 (例: Sheet1!C5:F10) または名前付き範囲名を追加します (例: Clients)。 このフィールドには、選択したスプレッドシートまたはスプレッドシートのサンプルから取得した情報が事前に入力されます。 このプロパティでは、String 型の変数と文字列形式の値がサポートされています。

  • シートを変更してから最新のデータを取得する必要がある場合は、[範囲を更新] オプションを選択します。

• 先頭行をヘッダーとする - 範囲の先頭行が、見出し行であるかどうかを指定します。このプロパティでは Boolean 値がサポートされています。
• 読み込む内容 - 読み込む値の種類を指定します。利用可能なオプションは、[値]、[値と数式]、[テキスト] です。

その他のオプション

出力

• 読み込まれる範囲 - データ テーブルとしての、読み込まれる範囲のデータへの参照です。他のアクティビティで使用できます。
• 情報を読み込み - RangeInformation 変数に保存されている、選択した範囲の詳細です。

要求に関する既知の制限事項

範囲を扱う場合は、要求/応答の制限に注意してください。制限は 4 MB です。たとえば、読み取り要求の場合は平均 10,000 セル (セル 1 つあたり 20 文字) で、書き込み要求の場合は平均 4,000 セル (セル 1 つあたり 20 文字) です。

例

以下の記事もご覧ください。

• シート アクティビティ
• 範囲に書き込み
• スプレッドシートを作成
• 繰り返し (スプレッドシートの各行)