繰り返し (スプレッドシートの各行)

UiPath.GSuite.Activities.ForEachRowConnections

説明

スプレッドシートの範囲から情報を読み取り保存し、後続のアクティビティ ([範囲に書き込み] など) で使用するために保存します。

注: このアクティビティでは、ページネーションを使用して多数の項目を処理し、パフォーマンスの問題を軽減します。このアクティビティでは永続性はサポートされていません。

プロジェクトの対応 OS

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

構成

• Google スプレッドシートのコネクション - アクティビティで使用する Google Workspace アカウントのコネクションです。
• コネクション - アクティビティで使用する Google Workspace アカウントのコネクションです。
• スプレッドシート - 使用する Google スプレッドシートのファイルです。フォルダー アイコンをクリックすると、Google ドライブのフォルダーを参照してスプレッドシートを選択することができます。このオプションは IResource として入力を受け入れます。プラス ボタンのメニューを使用すると、入力モードを [変数を使用] または [URL または ID] に切り替えることができます。
  • スプレッドシート URL - 対象のスプレッドシートの URL です。このフィールドは、入力モードとして [URL または ID] を選択した場合に使用できます。 このプロパティでは、String 型変数と文字列形式の値がサポートされています。
  • スプレッドシートのサンプル - 使用するスプレッドシートのテンプレートです。[スプレッドシートのテンプレートを使用] をクリックすると表示されます。Google ドライブのフォルダーを参照して、スプレッドシートを選択します。デスクトップ版の Studio では、このオプションは [範囲の種類] の横にあるプラス ボタンのメニューから利用できます。詳しくは、「テンプレートを使用する」をご覧ください。このフィールドは IResource 型の入力を受け入れます。

  • フォルダーを変更し、最新のデータを取得する必要がある場合は、[ファイル ピッカーを再読み込み] オプションを選択します。

• 範囲 - 行を反復処理する範囲です。このフィールドには、選択したスプレッドシートまたはスプレッドシートのサンプルから取得した情報が事前に入力されます。このプロパティでは、String 型変数と文字列形式の値がサポートされています。スプレッドシートの範囲の変更を加えた場合は、プラス ボタンのメニューをクリックして [範囲を更新] を選択します。

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

• 先頭行をヘッダーとする - 範囲の先頭行が、見出し行を表すかどうかを指定します。既定では、オンです。このプロパティは Boolean 値 (True、False) をサポートします。

その他のオプション

入力

• 行が空の場合 - 空の行が反復処理された場合の動作を指定します。利用可能なオプションは、[スキップ]、[処理]、[停止] です。
• 読み込む内容 - 範囲から読み込む内容を指定します。利用可能なオプションは、[値]、[値と数式]、[テキスト] です。

出力

• 処理される行の数 - アクティビティによって処理される行の総数です。[繰り返し (スプレッドシートの各行)] アクティビティの外で使用できます。これは自動生成される出力変数です。そのまま使用することも、別の名前で保存することもできます。

本文

オートメーションで使用される他のアクティビティ (例: [範囲を読み込み]) を格納するアクティビティの本体です。

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

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

注:

API 呼び出しのバッチ処理は、[繰り返し (コレクションの各要素)] 内で次のアクティビティが使用されている場合にサポートされます。

• 行を書き込み
• セルに書き込み

例

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

• シート アクティビティ
• 範囲を読み込み
• セルを読み込み
• 範囲に書き込み
• セルに書き込み