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

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

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

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

グローバル セッション オプションを使用し、Excel advanced package による Microsoft Excel のセッションを共有することは、このオプションではできません。

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

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

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

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

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

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

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