反復子関連の条件

ループ反復子は、ループ内の現在の反復を追跡する変数です。これは、ループの実行回数を制御し、各反復中にリストまたは配列内の要素にアクセスするために使用されます。

たとえば、項目のリストをループする場合、ループ反復子を使用すると、ループが完了するまで各項目に 1 つずつアクセスできます。ループ パッケージ は、ループの反復を制御するためのいくつかの反復子の条件を提供します。
表 1. ループ反復子
反復子 説明
CSV/TXT の各行に対して 指定した CSV またはテキスト ファイルの各行に対して一連の アクション を繰り返し、現在の行の値をレコード変数に代入します。「[CSV/TXT の各行に対して] 反復子の使用」を参照してください。
データ テーブル の各行に対して 指定したテーブルの各行に対して一連の アクション を繰り返し、現在の行の値をレコード変数に代入します。「[テーブルの各行用] 反復子の使用」を参照してください。
SQL クエリ データセットの各行 指定した SQL クエリ データセットの各行に対して一連の アクション を繰り返し、現在の行の値をレコード変数に代入します。データベース接続を確立するときに使用したセッション名を指定します。
ディクショナリ 内の各キーに対して 指定したディクショナリ変数の各キーに対して一連の アクション を繰り返し、現在のキーの名前を変数に代入します。
注: Bot が [ディクショナリ] > [書き込み] アクション を含む [ループ] アクション を実行すると、Bot はディクショナリの元のアイテム数だけを反復します。これには、[書き込み] アクション を使用して挿入されたアイテムは無視されます。
ディクショナリ 内の各値に対して 指定したディクショナリ変数の各値に対して一連のアクションを繰り返し、現在の値を変数に代入します。この変数型はさまざまなサブタイプ (String、Number、Boolean など) を格納できるので、アクションを構成するときに変数のクイック作成を行った場合、変数は Any タイプになります。
注: Bot が [ディクショナリ] > [書き込み] アクション を含む [ループ] アクションを実行すると、Bot はディクショナリの元のアイテム数だけを反復します。これには、[書き込み] アクション を使用して挿入されたアイテムは無視されます。
メールボックス内の各 E メールに対して 指定したメールボックス内の各 E メールに対して一連の アクション を繰り返します。「[メール ボックス内の各 E メールに対して] 反復子の使用」を参照してください。
ワークシート内の各行 (Excel の基本操作 または Excel の高度な操作) ワークシート内のデータを含む各行に対して一連の アクション を繰り返し、現在の行の値をレコード変数に代入します。Excel の基本操作 または Excel の高度な操作 ワークシートを開くときに使用したセッション名を入力します。アクション を繰り返す対象 (すべての行、指定した行、または指定したセル範囲) を指定します。[この変数に現在の行を代入] リストからレコード変数を選択するか、新しい変数を作成します。「レコード変数」を参照してください。
この反復子は、セル値を文字列データ型として取得します。数値、パーセント、通貨、指数、日付などの Excel セル形式をサポートしています。たとえば、[通貨] 表示形式のセルから値がテーブル変数またはレコード変数に渡された場合、通貨記号は保持されます。
  • 非文字列演算を実行するには、値を変換する必要があります。
  • Excel の高度な操作 では、[ワークシート内の各行] に対してループ反復子を選択すると、セルの表示テキストまたは値のいずれかを読み取る [読み取り] オプションが表示されます。

    たとえば、セルのコンテンツが 70% の場合、[セル値の読み取り] オプションは値を 70 として読み取り、% 形式を無視します。一方、[閲覧可能なテキストの読み取り] オプションは 70% として読み取ります。

    Recommendation: [セル値の読み取り] オプションをセルからの読み取り値として使用して、閲覧可能なテキストの読み取りよりもパフォーマンスを向上させます。

[グローバル セッション] オプションを使用し、Excel の高度な操作 パッケージ による Microsoft Excel のセッションを共有することは、このオプションではできません。

代替ソリューション: [複数のセルを取得] アクション を使用し、データをデータテーブル変数に保存した後で、[データ テーブル] オプションを選択して ループ パッケージ を使用します。
フォルダー内の各ファイル 指定したフォルダー内の各ファイルに対して一連の アクション を繰り返し、次の 2 つのキーが含まれたディクショナリ変数に現在のファイルのプロパティを代入します。name キーはファイル名、extension キーはファイル拡張子を格納しています。

異なる拡張子のファイルを開くには、変数オプションを使用して、フォルダー パス、ファイル名、ファイル拡張子を割り当てます。まず、フォルダー パスの変数 $sFolder$ を作成します。次に、フォルダー パス内のファイルに対して、ファイル名に対応する $name$ と、ファイル拡張子に対応する $extension$ という 2 つの変数を作成します。ファイルを開くには、$sFolder$\$name$.$extension$ のように変数を文字列として組み合わせます。拡張子をさまざまなファイル タイプや開くオプションに対応させるためには、条件付きロジックを追加できます。

フォルダーの各フォルダー 指定したフォルダー内の各フォルダーに対して一連の アクション を繰り返し、現在のフォルダー名を文字列変数に代入します。

[すべてのサブフォルダーを含む] オプションを使用して、隠しフォルダーを含むフォルダー内の各サブフォルダーを再帰的に反復処理します。
リストの各項目に対して 指定したリスト内の各項目に対して一連の アクション を繰り返し、現在の項目を変数に代入します。アクション をリスト内のすべての項目で繰り返すか、リスト内の一定範囲の項目でのみ繰り返すかを指定します。この変数型はさまざまなサブタイプ (文字列、数値、Boolean など)を格納できるので、アクション を構成するときに変数のクイック作成を行った場合、変数は [任意] のタイプになります。
注: リスト内のインデックスは 0 から始まります。たとえば、リストの 3 番目の位置から 6 番目の位置までの項目にアクションを繰り返すには、該当するフィールドに「2」と「5」を指定します。
n 回 指定した回数だけコンテナ内で アクション を繰り返します。反復回数は、数値変数に代入することができます。
レコード内の各値 指定したレコードの各値に アクション セットを繰り返し、変数に現在の値を割り当てます。この変数型はさまざまなサブタイプ (String、Number、Boolean など) を格納できるので、アクションを構成するときに変数のクイック作成を行った場合、変数は Any タイプになります。
カレンダーの各会議 指定したカレンダー内の各ミーティングに対して一連の アクション を繰り返すには、このオプションを使用します。「Microsoft 365 Calendar アクションをループ内で使用する」を参照してください。
ワークシート内の各行 (Microsoft 365 Excel) ワークシート内でデータを含む各行に対して一連の アクション を繰り返します。
  • ワークシートを開くときに使用したセッション名を入力します。
  • アクション を繰り返す対象 (すべての行または指定した行) を指定します。
  • 現在の行の値をレコード変数に代入できます。
キュー内の各作業項目 (ワークロード) キュー内の各作業項目に対して、アクションのセットを繰り返し、作業項目をレコード変数に割り当てます。レコード変数は、workitemId、workitemValues、workitemMetadata の 3 つの固定キー値を返します。「キュー内の各作業項目用の反復子の使用」を参照してください。
XML Dataset の各ノードに対して XML Dataset 内の各ノードに対して一連の アクション を繰り返し、現在のノードを文字列変数に代入します。XML ファイルを開くときに使用したセッション名を入力します。