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

UiPath.GSuite.Activities.ForEachRowConnections

説明

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

繰り返し実行するアクティビティを [繰り返し (スプレッドシートの各行)] アクティビティに追加します。これらのアクティビティを設定するときは、[その他を表示] ボタンのメニューから [変数を使用] > [CurrentRow] の順に選択して、反復処理で各行に対してアクションが繰り返されるように指定します。詳しくは、「「繰り返し」系アクティビティで項目を反復処理する」をご覧ください。

注:

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

プロジェクトの対応 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 呼び出しのバッチ処理は、[繰り返し (コレクションの各要素)] 内で次のアクティビティが使用されている場合にサポートされます。

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

例

詳しくは、以下のリソースもご覧ください。

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