ループ

ループブロックはブロックを繰り返し実行するコンテナです。コレクションを反復処理したり、固定回数の操作を繰り返したり、条件が満たされている間継続したりすることができます。

ループブロックは内部に他のブロックを保持するコンテナノードです。含まれるブロックは設定に基づいて複数回実行されます。

設定オプション

ループタイプ

4種類のループから選択できます：

For ループ（反復回数） - 固定回数実行する数値ループ：

特定の回数だけ操作を繰り返す必要がある場合に使用します。

Example: Run 5 times
- Iteration 1
- Iteration 2
- Iteration 3
- Iteration 4
- Iteration 5

ForEach ループ（コレクション） - 配列やオブジェクト内の各アイテムを反復処理するコレクションベースのループ：

アイテムのコレクションを処理する必要がある場合に使用します。

Example: Process ["apple", "banana", "orange"]
- Iteration 1: Process "apple"
- Iteration 2: Process "banana"
- Iteration 3: Process "orange"

While ループ（条件ベース） - 条件が真と評価される間、実行を継続します：

特定の条件が満たされるまでループする必要がある場合に使用します。条件は各反復の前にチェックされます。

Example: While {"<variable.i>"} < 10
- Check condition → Execute if true
- Inside loop: Increment {"<variable.i>"}
- Inside loop: Variables assigns i = {"<variable.i>"} + 1
- Check condition → Execute if true
- Check condition → Exit if false

Do-While ループ（条件ベース） - 少なくとも1回実行し、その後条件が真である間継続します：

少なくとも1回実行し、その後条件が満たされるまでループする必要がある場合に使用します。条件は各反復の後にチェックされます。

Example: Do-while {"<variable.i>"} < 10
- Execute blocks
- Inside loop: Increment {"<variable.i>"}
- Inside loop: Variables assigns i = {"<variable.i>"} + 1
- Check condition → Continue if true
- Check condition → Exit if false

少なくとも1回実行し、その後条件が満たされるまでループする必要がある場合に使用します。条件は各反復の後にチェックされます。

Example: Do-While Loop
- Execute first iteration
- Check condition → Continue if true
- Check condition → Exit if false

ループの使い方

ループの作成

ツールバーからループブロックをキャンバスにドラッグします
ループタイプとパラメータを設定します
他のブロックをループコンテナ内にドラッグします
必要に応じてブロックを接続します

結果へのアクセス

ループが完了すると、集計された結果にアクセスできます：

loop.results: すべてのループ反復からの結果の配列

使用例

API結果の処理 - ForEachループでAPIから取得した顧客レコードを処理

// API結果を反復処理
forEach(customerRecord in apiResponse.data) {
  // 各顧客レコードを処理
  processCustomer(customerRecord);
  // 必要に応じてデータベースを更新
  updateDatabase(customerRecord.id, { processed: true });
}

反復的なコンテンツ生成 - Forループで複数のコンテンツバリエーションを生成

// 5つのコンテンツバリエーションを生成
for (let i = 0; i < 5; i++) {
  // 各バリエーションに異なるトーンを使用
  const tone = tones[i];
  // AIを使用してコンテンツを生成
  const content = generateContent(prompt, { tone: tone });
  // 結果を保存
  variations.push(content);
}

Whileループによるカウンター - Whileループでカウンターを使用してアイテムを処理

// カウンターを初期化
let counter = 0;

// 条件が満たされるまで処理を続ける
while (counter < items.length && !foundTarget) {
  // 現在のアイテムを処理
  const result = processItem(items[counter]);
  
  // 目標が見つかったかチェック
  if (result.isTarget) {
    foundTarget = true;
  }
  
  // カウンターを増加
  counter++;
}

高度な機能

制限事項

コンテナブロック（ループと並列）はネストをサポートしています。ループの中にループを、ループの中に並列を、そして任意のコンテナブロックの組み合わせで複雑な多次元ワークフローを構築できます。

ループは並列ではなく順次実行されます。同時実行が必要な場合は、代わりに並列ブロックを使用してください。

入力と出力

ループタイプ：'for'、'forEach'、'while'、または'doWhile'から選択
反復回数：実行する回数（forループ）
コレクション：反復処理する配列またはオブジェクト（forEachループ）
条件：評価するブール式（while/do-whileループ）

loop.currentItem：現在処理中のアイテム
loop.index：現在の反復番号（0ベース）
loop.items：完全なコレクション（forEachループ）

loop.results：すべての反復結果の配列
構造：結果は反復順序を維持
アクセス：ループ後のブロックで利用可能

入力と出力

ループタイプ: 'for'、'forEach'、'while'、または'doWhile'から選択
反復回数: 実行する回数(forループ)
コレクション: 反復処理する配列またはオブジェクト(forEachループ)
条件: 評価するブール式(while/do-whileループ)

ループ内でのみ利用可能:

<loop.index>: 現在の反復番号(0始まり)
<loop.currentItem>: 処理中の現在のアイテム(forEachのみ)
<loop.items>: 完全なコレクション(forEachのみ)

<blockname.results>: すべての反復結果の配列(ブロック名経由でアクセス)
構造: 結果は反復順序を維持
アクセス: ループ完了後のブロックで利用可能

ベストプラクティス

適切な制限を設定: 実行時間が長くならないよう、反復回数を適切に保つ
コレクションにはForEachを使用: 配列やオブジェクトを処理する場合は、Forループの代わりにForEachを使用
エラーを適切に処理: 堅牢なワークフローのため、ループ内にエラー処理の追加を検討

ループ

On this page