Auf dieser Seite
Schritt „Für jeden Eintrag“
Der Schritt wiederholt die Schritte in seinem Rahmen für jeden Eintrag einer Liste. Als Liste nimmst du ein Datenfeld, etwa {{steps.tabelle_1.rows}} aus „Zeile suchen“ oder eine Liste aus dem Auslöser, oder du schreibst Werte mit Komma (bzw. einen je Zeile). Ein Objekt wird zu Einträgen mit key und value.
Im Rahmen stehen dir {{loop.item}} (bei Tabellenzeilen z. B. {{loop.item.email}}), {{loop.index}} (ab 0), {{loop.position}} (ab 1), {{loop.count}}, {{loop.first}} und {{loop.last}} zur Verfügung. In einer inneren Schleife erreichst du die äußere über {{loop.parent.item}}. Ein „Filter“ im Rahmen überspringt nur den aktuellen Eintrag.
In den Rahmen passen alle Schritte, die sofort arbeiten, dazu HTTP-Anfragen (sie laufen je Eintrag nacheinander) und die Tabellen-Schritte. Nicht möglich sind „Warten“, „Warten bis Zeitpunkt“, „Warten auf Ereignis“, „Ergebnis zurückgeben“ und mehr als zwei Schleifen ineinander. Ruft die Schleife eine Automatisierung auf, die selbst wartet, schalte dort „Auf Ergebnis warten“ aus.
Ergebnis einer Schleife
Nach der Schleife liest du unter {{steps.schleife_1.items}} je Durchlauf den Eintrag und die Ergebnisse der Schritte im Rahmen, dazu {{steps.schleife_1.count}} und {{steps.schleife_1.errors}}. Im Reiter „Läufe“ steht der erste Durchlauf vollständig, spätere zeigen ihre Fehler mit „Eintrag N“. Die Statistik zählt, wie viele Einträge verarbeitet wurden.
Nach einer Verzweigung gemeinsam weiter
Unter jeder Verzweigung (Wenn/Dann, Aufteilen, Verzweigen, Warten auf Ereignis, Fehler-Weg) findest du den Button „Danach für alle Wege“. Schritte, die du dort einfügst, laufen nach dem Weg, der genommen wurde, egal ob Ja oder Nein. Der Button steht unter jedem Weg, nach dem noch nichts kommt, auch am Ende eines Schleifen-Rahmens oder eines inneren Wegs. Im Ablauf führt ein Knoten „Alle Wege“ die Wege wieder zusammen. Bestehende Automatisierungen ändern sich dadurch nicht: Ohne Schritte danach endet jeder Weg wie bisher.
Schritt „Datum und Zeit“
Rechnet mit Zeitpunkten: jetzt, Minuten bis Monate addieren oder abziehen, formatieren, den Abstand zweier Zeitpunkte, Anfang oder Ende von Tag, Woche und Monat, in eine andere Zeitzone umrechnen oder Text als Datum lesen. Gerechnet wird in der Zeitzone des Projekts, Sommer- und Winterzeit sind berücksichtigt. Ein Monat weiter vom 31. landet am letzten Tag des kürzeren Monats (31. Jänner plus 1 Monat ergibt 28. bzw. 29. Februar). Das Ergebnis steht unter {{steps.datum_1.value}}, dazu .iso, .date, .time und .unix.
„Bei Fehler“ je Schritt
HTTP-Anfragen, Chat-Nachrichten, Webhooks, Versand-Schritte, Rabattcodes, „Kontakt anlegen oder aktualisieren“, Datum und Zeit, Tabellen-Schritte und „Automatisierung aufrufen“ haben unten einen aufklappbaren Bereich „Bei Fehler“. Anhalten beendet den Lauf als fehlgeschlagen, Weiter macht mit dem nächsten Schritt weiter, Fehler-Weg teilt den Ablauf in Erfolg und Fehler. Versand-Schritte gehen ohne Angabe wie bisher weiter, alle anderen halten an. Den Fehlertext liest du in späteren Schritten als {{steps.<kurzname>.error}}; Schritte ohne eigenes Ergebnis bekommen dafür im selben Bereich einen Kurznamen.
Neue Versuche: bis zu drei, mit einer ersten Wartezeit zwischen 10 Sekunden und 1 Stunde. Jeder weitere Versuch wartet doppelt so lang, höchstens 1 Stunde. Erst wenn alle Versuche scheitern, greift die Einstellung darüber. Fehler, die ein neuer Versuch nicht behebt (z. B. eine gesperrte Adresse oder ein Kreis von Aufrufen), werden nicht wiederholt. Bei „Automatisierung aufrufen“ wird nur neu versucht, solange die aufgerufene Automatisierung pausiert ist. Fehler in ihr wiederholt BirdBuild nicht, sonst gingen ihre Mails und Nachrichten mehrfach raus. Im Protokoll steht jeder Versuch mit „Versuch N“.
Automatisierung mit Rückgabe aufrufen
Gib einer Automatisierung den Auslöser „Von einer anderen Automatisierung aufgerufen“ und leg dort ihre Eingaben fest (Name und Art: Text, Zahl, Ja/Nein, Datum oder Liste). Sie liest sie als {{trigger.<name>}} und endet mit „Ergebnis zurückgeben“, das benannte Werte zurückgibt.
In der aufrufenden Automatisierung wählst du sie im Schritt „Automatisierung aufrufen“ und füllst die Eingaben. Mit „Auf Ergebnis warten“ (Standard) wartet der Lauf, bis sie fertig ist, auch über Wartezeiten hinweg, und liest danach {{steps.aufruf_1.result.<name>}}. Scheitert die aufgerufene Automatisierung, greift „Bei Fehler“ des Aufruf-Schritts. Ohne Warten läuft sie nebenher. Anders als „Andere Automatisierung starten“ bekommt sie Eingaben und liefert ein Ergebnis. Aufrufe dürfen höchstens fünf Ebenen tief gehen, und eine Automatisierung kann sich nicht selbst im Kreis aufrufen.
Datentabellen
Unter Studio → Automatisierungen → Datentabellen legst du eigene Tabellen an, etwa für Gutschein-Kontingente, Teilnehmerlisten oder Zählerstände. Jede Spalte hat einen Namen, einen Kurznamen für Platzhalter und eine Art (Text, Zahl, Ja/Nein, Datum). Sobald eine Automatisierung die Tabelle verwendet, behält eine umbenannte Spalte ihren Kurznamen. Zeilen bearbeitest du direkt in der Tabelle, alles speichert automatisch. Suche und Seiten helfen bei großen Tabellen, CSV-Dateien kannst du einlesen (anhängen oder ersetzen) und herunterladen.
Die Schritte „Zeile suchen“, „Zeile anlegen“, „Zeile aktualisieren“ und „Zeile löschen“ arbeiten mit Filtern je Spalte oder einer Zeilen-ID. „Zeile suchen“ liefert die erste oder alle Treffer ({{steps.tabelle_1.row.<kurzname>}}, .rows, .count, .found). „Zeile aktualisieren“ kann eine fehlende Zeile auf Wunsch anlegen. Nichts gefunden ist kein Fehler.
Grenzen
Die Grenzen schützen nur vor Missbrauch: höchstens 500 Einträge je Schleife und 2.000 ausgeführte Schritte je Lauf (Schleifen und aufgerufene Automatisierungen zusammen), je Projekt 25 Tabellen mit bis zu 30 Spalten, 10.000 Zeilen und 2.000 Zeichen je Zelle, zusammen 2 MB je Projekt und 8 MB je Konto. Je Lauf gehen höchstens 100 Aufrufe nach außen (KI-Aufgaben, Apps, HTTP-Anfragen und Chat-Nachrichten zusammen); eine KI-Aufgabe in einer Schleife kostet je Eintrag einen KI-Credit. Wird eine Grenze erreicht, steht der Grund im Protokoll. Datentabellen sind Teil der Konto-Sicherung und werden mit dem Projekt bzw. Konto gelöscht.
Häufige Fragen
Wie schicke ich für jedes bestellte Produkt eine Anfrage an meine Warenwirtschaft?
Nimm den Auslöser „Bestellung eingegangen“ und leg den Schritt „Für jeden Eintrag“ an. Als Liste wählst du das Datenfeld „Produkte (IDs)“ aus dem Auslöser. In den Rahmen kommt eine „HTTP-Anfrage“, die {{loop.item}} verwendet, also die Produkt-ID. Die Anfragen laufen nacheinander, die Antworten stehen danach unter {{steps.schleife_1.items}}.
Was passiert mit meinen bestehenden Automatisierungen?
Nichts. Ohne Schritte unter „Danach für alle Wege“ endet jeder Weg wie bisher, und Schritte ohne Angabe bei „Bei Fehler“ verhalten sich wie vorher.
Warum wird ein Fehler nicht neu versucht?
Manche Fehler behebt ein neuer Versuch nicht, etwa eine gesperrte Adresse, fehlende Zugangsdaten, ein Kreis von Aufrufen oder eine erreichte Grenze. Dann greift sofort die Einstellung unter „Bei Fehler“.
Kann ich eine Datentabelle löschen, die noch verwendet wird?
Ja, BirdBuild nennt dir vorher die Automatisierungen, die sie verwenden. Deren Tabellen-Schritte schlagen danach mit „Tabelle nicht gefunden“ fehl, bis du eine andere Tabelle wählst.