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

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

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

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

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

代替ソリューション: 複数のセルを取得 アクション を使用してデータをデータテーブル変数に保存し、その後、ループ パッケージ を使用して データテーブル オプションを選択します。

スプレッドシートの表の各行について

(Apple Numbers)
  • セッション名を指定するには、次のいずれかのオプションを使用します。
    • セッション名: スプレッドシートを開く アクションで開く際に使用したセッション名を入力します。
    • 変数: 開く アクションで追加したセッション変数を入力します。
  • 値を取得するテーブル名を指定します。
  • 次のいずれかのオプションを選択してループ処理を行います。
    • すべての行: このオプションを選択すると、そのテーブル内のすべての行と列を含む、テーブル全体からすべてのデータを抽出します。
    • 特定の行: このオプションを選択すると、テーブル内の指定された行からのみデータを抽出します。 次のフィールドに入力してください。
      • 開始行: 値を取得したい行番号を指定します。 たとえば、10
      • 終了行: 値を取得したい行番号を指定してください。 例：40
    • セルの範囲: このオプションを選択すると、開始セルと終了セルで定義された指定の長方形ブロックのセルからデータを抽出できます（例：B2 から D5 まで）。 次のフィールドに入力してください。
      • 開始セル 値を取得するセルのアドレスを指定します。 たとえば、A1
      • 終了セル 値を取得したいセルのアドレスを指定します。 たとえば、C20
  • 値の種類 オプションから、セルに表示されているテキストまたは値のいずれかを選択して読み取ります。
    • 表示テキスト
    • セル値

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

  • 現在の値をこの変数に割り当てる フィールドで、出力を保持するレコード変数を選択するか、新しく作成します。 さらに、キーと、そのキーがマッピングされる変数を指定することで、出力を複数の変数に格納することもできます。
フォルダー内の各ファイル 指定したフォルダー内の各ファイルに アクション セットを繰り返し、次の 2 つのキーが含まれたディクショナリ変数に現在のファイルのプロパティを割り当てます。name キーはファイル名、extension キーはファイル拡張子を格納しています。

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

すべてのサブフォルダーを含む オプションを使用して、隠しフォルダーを含むフォルダー内の各サブフォルダーを再帰的に反復処理します。
リストの各項目に対して 指定したリスト内の各項目にアクション セットを繰り返し、変数に現在の項目を割り当てます。 アクション をリスト内のすべての項目で繰り返すか、リスト内の一定範囲の項目でのみ繰り返すかを指定します。 この変数型はさまざまなサブタイプ (文字列、数値、Boolean など)を格納できるので、アクション を構成するときに変数のクイック作成を行った場合、変数は [任意] のタイプになります。
注: リスト内のインデックスは 0 から始まります。 たとえば、リストの 3 番目の位置から 6 番目の位置までの項目にアクションを繰り返すには、該当するフィールドに[2]と[5]を指定します。
n 回 指定した回数だけコンテナ内で アクション を繰り返します。 反復回数は、数値変数に代入することができます。
レコード内の各値 指定したレコードの各値に アクション セットを繰り返し、変数に現在の値を割り当てます。 この変数型はさまざまなサブタイプ (文字列、数値、Boolean など)を格納できるので、アクションを構成するときに変数のクイック作成を行った場合、変数は Any のタイプになります。
カレンダーの各会議 指定したカレンダー内の各ミーティングにアクション セットを繰り返すには、このオプションを使用します。 [Microsoft 365 Calendar アクションをループ内で使用する]を参照してください。
ワークシート内の各行 (Microsoft 365 Excel) ワークシート内でデータを含む各行にアクション セットを繰り返します。
  • ワークシートを開くときに使用したセッション名を入力します。
  • アクション を繰り返す対象 (すべての行または指定した行) を指定します。
  • レコード変数に現在の行の値を割り当てることができます。
メールボックス（Apple Mail）内の各メール Using the For each mail in mail box iterator for Apple Mailをご覧ください。
メールボックス内の各メールに対して (Microsoft 365 Outlook) Microsoft 365 Outlookの受信トレイ内の各 E メールに対して一連の アクション を繰り返します。
  • [接続] アクション で使用したセッション名を入力します。
  • イテレータを使用するメールのステータスを指定します。 例えば、まだ読んでいないメールに使用するには、Unread を選択します。
  • メールの並び替え フィールドで以下のオプションのいずれかを選択して、メールの並べ替え順序を設定します:
    • 新しい順: Microsoft 365 Outlook パッケージ バージョンが 1.6.1 以降に更新されると、既存の自動化と新しい自動化にはこの設定が有効になり、メールボックス内のすべてのメールはデフォルトで LIFO メソッドでソートされます。
    • 古い順: この設定は、メールボックス内のメールを FIFO 方式でソートすることを可能にします。 この設定は、ループ イテレータを使用して実行できるすべての Microsoft 365 Outlook アクション に適用されます。例:
      • ステータスの変更
      • 削除
      • 転送
      • 返信
      • 添付ファイルを保存
      • E メールを保存
  • メッセージ形式を HTML またはプレーン テキストのいずれかに設定します。
  • 特定のタイムゾーンを選択してください。
Microsoft Outlook (macOS) - メールボックス内の各メール Microsoft Outlook (macOS) のためのループ イテレータを使用していますを参照してください。
ユーザー（Microsoft Teams）の各チャットについて ユーザーの各チャット用 反復子（イテレータ）の使用をご覧ください。
チーム内の各チャンネルに対して (Microsoft Teams) チームの各チャンネル 反復子（イテレータ）の使用をご覧ください。
チャンネル内の各メッセージに対して (Microsoft Teams) チャンネル内の各メッセージを繰り返し処理するイテレータの使用をご覧ください。
チャット内の各メッセージに対して (Microsoft Teams) チャット内の各メッセージを繰り返し処理するイテレータの使用をご覧ください。
各チーム（Microsoft Teams） 各チーム用 反復子の使用をご覧ください。
キュー (ワークロード) 内の各作業項目に対して キュー内の各作業項目にアクション セットを繰り返し、レコード変数に作業項目を割り当てます。 Record 変数は、workitemId、workitemValues、およびworkitemMetadataという3つの固定キー値を返します。 キュー内の各作業項目用の反復子の使用をご覧ください。
XML Dataset の各ノードに対して XML Dataset 内の各ノードに対して一連の アクション を繰り返し、現在のノードを文字列変数に代入します。 XML ファイルを開くときに使用したセッション名を入力します。