Iterator verwenden

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.

​

Wann Sie Iterator verwenden sollten

​

Iterator verstehen

1. Nimmt das erste Element aus dem Array
2. Führt alle Aktionen innerhalb des Iterators mit diesem Element aus
3. Wechselt zum nächsten Element
4. Wiederholt sich, bis alle Elemente verarbeitet sind

​

Grundlegende Einrichtung

​

Beispiel: E-Mail an alle in den Suchergebnissen

​

Schritt 1: Nach Datensätzen suchen

1. Fügen Sie die Aktion Datensätze suchen hinzu
2. Objekt: Personen
3. Filter: Unternehmen ist gleich “Acme Inc”
4. Dadurch wird ein Array von Personen zurückgegeben

​

Schritt 2: Prüfen, ob Ergebnisse vorhanden sind

1. Fügen Sie eine Filter-Aktion hinzu
2. Bedingung: {{searchRecords.length}} ist größer als 0
3. Dies verhindert Iterator-Fehler bei leeren Ergebnissen

​

Schritt 3: Iterator hinzufügen

1. Fügen Sie eine Iterator-Aktion hinzu
2. Array-Eingabe: Wählen Sie {{searchRecords}} aus
3. Dadurch wird eine Schleife erstellt

​

Schritt 4: Aktionen im Iterator hinzufügen

1. Fügen Sie eine E-Mail senden-Aktion hinzu (im Iterator)
2. An: {{iterator.currentItem.email}}
3. Betreff: Hallo {{iterator.currentItem.firstName}}!
4. Text: Personalisierte Nachricht unter Verwendung der Felder des aktuellen Elements

​

Ergebnis

• Sendet E-Mail an Person 1
• Sendet E-Mail an Person 2
• … setzt dies für alle 5 fort

​

Zugriff auf Daten des aktuellen Elements

​

Häufige Muster

​

Mehrere Datensätze aktualisieren

1. Datensätze suchen (Aufgaben, Fälligkeitsdatum < Heute, Status ≠ Abgeschlossen)
2. Filter (length > 0)
3. Iterator (searchRecords)
   └── Datensatz aktualisieren
       - Objekt: Aufgaben
       - Datensatz: {{iterator.currentItem.id}}
       - Status: Late

​

Datensätze aus Array erstellen

1. Webhook-Trigger (empfängt ein Array von Positionen)
2. Filter (items.length > 0)
3. Iterator (trigger.body.items)
   └── Datensatz erstellen
       - Objekt: Bestellpositionen
       - Name: {{iterator.currentItem.name}}
       - Menge: {{iterator.currentItem.qty}}
       - Zugehörige Bestellung: {{trigger.body.orderId}}

​

Bedingte Verarbeitung innerhalb der Schleife

1. Datensätze suchen (Personen)
2. Iterator (searchRecords)
   └── Filter (currentItem.email ist nicht leer)
       └── E-Mail senden
           - An: {{iterator.currentItem.email}}

​

Fehlerbehebung

​

”Iterator erwartet ein Array”

✅ Richtig: {{searchRecords}}
❌ Falsch: {{searchRecords[0]}}

​

Iterator wird nicht ausgeführt

Filter: {{searchRecords.length}} > 0

​

Aktionen werden zu oft ausgeführt

• Fügen Sie der Aktion „Datensätze suchen“ spezifischere Filter hinzu
• Legen Sie für die Aktion „Datensätze suchen“ ein Limit fest (max. 200)
• Fügen Sie innerhalb des Iterators einen Filter für zusätzliche Bedingungen hinzu

​

Leistungsaspekte

• Credit-Verbrauch: Jede Iteration verbraucht Credits für ihre Aktionen
• Zeit: Große Arrays benötigen länger für die Verarbeitung
• Grenzwerte: Ziehen Sie für sehr große Vorgänge eine Stapelverarbeitung in Betracht
• Ratenlimits: Externe API-Aufrufe können bei vielen Iterationen auf Ratenlimits stoßen

​

Beste Praktiken

1. Prüfen Sie stets die Array-Länge vor dem Iterator, um Fehler zu vermeiden
2. Fügen Sie Filter innerhalb von Schleifen hinzu, wenn nicht alle Elemente verarbeitet werden müssen
3. Benennen Sie Ihren Iterator-Schritt um, um zu beschreiben, was durchlaufen wird
4. Testen Sie mit kleinen Arrays, bevor Sie große Datenmengen verarbeiten
5. Überwachen Sie Workflow-Ausführungen, um sicherzustellen, dass Iterationen wie erwartet abgeschlossen werden

​

Verwandt

• Workflow-Aktionen
• So verwenden Sie Verzweigungen
• Workflows-FAQ