Iterator を使用

Documentation Index

Fetch the complete documentation index at: https://docs.twenty.com/llms.txt

Use this file to discover all available pages before exploring further.

​

Iterator を使用するタイミング

​

Iterator の理解

1. 配列から最初のアイテムを取り出す
2. そのアイテムを使って Iterator 内のすべてのアクションを実行する
3. 次のアイテムに進む
4. すべてのアイテムが処理されるまで繰り返す

​

基本的なセットアップ

​

例: 検索結果の全員にメールを送信

​

ステップ 1: レコードを検索

1. 「Search Records」アクションを追加
2. オブジェクト: People
3. フィルター: Company が “Acme Inc” に等しい
4. これにより、People の配列が返されます

​

ステップ 2: 結果の有無を確認

1. 「Filter」アクションを追加
2. 条件: {{searchRecords.length}} が 0 より大きい
3. これにより、結果が空の場合の Iterator エラーを防止します

​

ステップ 3: Iterator を追加

1. 「Iterator」アクションを追加
2. 配列の入力: {{searchRecords}} を選択
3. これでループが作成されます

​

ステップ 4: Iterator 内にアクションを追加

1. 「Send Email」アクションを追加（Iterator 内）
2. 宛先: {{iterator.currentItem.email}}
3. 件名: こんにちは {{iterator.currentItem.firstName}}!
4. 本文: 現在のアイテムのフィールドを使用したパーソナライズメッセージ

​

結果

• 1 人目にメールを送信
• 2 人目にメールを送信
• … 5 人すべてに対して続行

​

現在のアイテムのデータにアクセスする

​

よくあるパターン

​

複数レコードを更新

1. Search Records (Tasks, Due Date < Today, Status ≠ Completed)
2. Filter (length > 0)
3. Iterator (searchRecords)
   └── Update Record
       - Object: Tasks
       - Record: {{iterator.currentItem.id}}
       - Status: Late

​

配列からレコードを作成

1. Webhook Trigger (receives items array)
2. Filter (items.length > 0)
3. Iterator (trigger.body.items)
   └── Create Record
       - Object: Order Items
       - Name: {{iterator.currentItem.name}}
       - Quantity: {{iterator.currentItem.qty}}
       - Related Order: {{trigger.body.orderId}}

​

ループ内の条件付き処理

1. Search Records (People)
2. Iterator (searchRecords)
   └── Filter (currentItem.email is not empty)
       └── Send Email
           - To: {{iterator.currentItem.email}}

​

トラブルシューティング

​

”Iterator expects an array”

✅ Correct: {{searchRecords}}
❌ Wrong: {{searchRecords[0]}}

​

Iterator が実行されない

Filter: {{searchRecords.length}} > 0

​

アクションが過剰に実行される

• Search Records により具体的なフィルターを追加する
• Search Records に上限を設定する（最大 200）
• 追加条件のために Iterator 内にフィルターを追加する

​

パフォーマンス上の考慮事項

• クレジット使用量: 各イテレーションでアクション実行分のクレジットを消費します
• 時間: 大きな配列は処理に時間がかかります
• 制限: 非常に大きな処理はバッチ化を検討してください
• レート制限: 繰り返しが多いと外部 API 呼び出しがレート制限に達する可能性があります

​

ベストプラクティス

1. エラーを避けるため、Iterator の前に配列の長さを必ず確認
2. すべてのアイテムを処理する必要がない場合はループ内にフィルターを追加
3. 何をループしているか分かるように Iterator ステップの名前を変更
4. 小さな配列でテストしてから大きなデータセットを処理する
5. ワークフローの実行を監視して、イテレーションが想定どおりに完了することを確認する

​

関連

• ワークフローのアクション
• ブランチの使い方
• ワークフロー FAQ