Make Iterator und Aggregator: Bestellpositionen richtig verarbeiten
Kurz gesagt: Ein Iterator nimmt eine Liste, etwa die Positionen einer Shop-Bestellung, und gibt jeden Eintrag als eigenes Bündel weiter, sodass die folgenden Module einmal pro Position laufen. Ein Aggregator macht das Gegenteil: Er sammelt mehrere Bündel wieder zu einem einzigen Ergebnis, zum Beispiel zu einem Text für eine Mail oder einem Array für ein anderes Modul. Entscheidend ist beim Aggregator das richtige Quellmodul, meist der Iterator, sonst fasst er falsche Bündel zusammen. Da jedes Modul nach dem Iterator pro Position Operationen verbraucht, lohnt es sich, nur dort zu zerlegen, wo es wirklich nötig ist.
Das typische Problem
Ein Onlinehändler für Fahrradzubehör schickt jede Shop-Bestellung per Make in eine Google-Tabelle. Bestellt jemand eine Klingel, zwei Schläuche und eine Lampe, erscheint in der Tabelle aber nur eine Zeile, oft mit der ersten Position oder einem unlesbaren Textblock aus allen Positionen. Der Grund: Die Bestellung kommt als ein Bündel an, die Positionen stecken darin als Array, also als Liste von Objekten. Das Tabellenmodul schreibt eine Zeile pro Bündel. Ohne Iterator bleibt es bei einem.
Wie Make Listen sieht
Im Ausgabefenster eines Moduls erkennen Sie Arrays an eckigen Klammern und nummerierten Einträgen. Bei einer Shopify- oder WooCommerce-Bestellung heißt das Feld etwa „Line items“ oder „Positionen“. Jeder Eintrag enthält Artikelnummer, Name, Menge und Preis. Klicken Sie nach einem Testlauf auf die Blase über dem Auslösermodul und klappen Sie das Array auf, damit Sie die genaue Struktur kennen, bevor Sie weiterbauen.
Schritt 1: Iterator einfügen
Fügen Sie nach dem Auslöser aus den Werkzeugen von Make (Flow Control) den Iterator ein. Im Feld „Array“ wählen Sie aus dem Auslöser das Positionen-Array aus, nicht ein einzelnes Feld daraus. Nach dem nächsten Testlauf zeigt der Iterator so viele Bündel, wie die Bestellung Positionen hat. Die Make-Hilfe zum Iterator beschreibt das Verhalten und die verfügbaren Felder.
Ab jetzt stehen Ihnen in den folgenden Modulen die Felder der einzelnen Position zur Verfügung: Name, Menge, Einzelpreis. Felder aus dem Auslöser, etwa Bestellnummer und Kundenname, können Sie weiterhin verwenden. Sie wiederholen sich einfach für jede Position.
Schritt 2: Eine Zeile pro Position schreiben
Hängen Sie das Modul „Zeile hinzufügen“ für Google Sheets an den Iterator. Ordnen Sie zu:
| Spalte | Quelle |
|---|---|
| Bestellnummer | Auslöser |
| Datum | Auslöser |
| Artikelnummer | Iterator |
| Artikelname | Iterator |
| Menge | Iterator |
| Einzelpreis | Iterator |
Nach einem Testlauf mit der Beispielbestellung stehen drei Zeilen in der Tabelle, jeweils mit derselben Bestellnummer. Damit lassen sich Auswertungen nach Artikel endlich sauber erstellen.
Schritt 3: Wieder bündeln mit dem Text-Aggregator
Oft brauchen Sie die Positionen zusätzlich als Liste in einem einzigen Text, etwa für eine Mail an das Lager: „1 x Klingel, 2 x Schlauch 28 Zoll, 1 x Lampe“. Dafür eignet sich der Text-Aggregator.
- Fügen Sie nach dem Iterator den Text-Aggregator ein.
- Wählen Sie als Quellmodul den Iterator.
- Tragen Sie im Textfeld pro Position ein, was erscheinen soll, zum Beispiel Menge, ein „x“ und den Artikelnamen.
- Setzen Sie als Trennzeichen einen Zeilenumbruch oder ein Komma.
Das Ergebnis ist ein einziges Bündel mit einem Textfeld, das Sie im Mailmodul danach verwenden. Die Mail geht damit einmal pro Bestellung raus, nicht dreimal.
Schritt 4: Der Array-Aggregator für andere Systeme
Manche Module erwarten selbst ein Array, etwa die Rechnungserstellung in einem Buchhaltungsprogramm, die mehrere Rechnungspositionen auf einmal annimmt. Hier nutzen Sie den Array-Aggregator.
- Quellmodul ist wieder der Iterator.
- Bei „Zielstruktur“ wählen Sie, sofern verfügbar, das Feld des Zielmoduls, etwa „Rechnungspositionen“. Make zeigt dann genau die Felder an, die das Zielsystem pro Position erwartet.
- Ordnen Sie Menge, Bezeichnung und Preis aus dem Iterator zu.
Im Zielmodul wählen Sie anschließend das Array aus dem Aggregator aus. Damit entsteht eine Rechnung mit allen Positionen, statt drei Rechnungen mit je einer. Weitere Varianten erklärt die Übersicht zu Aggregatoren.
Summen bilden mit dem numerischen Aggregator
Der Fahrradzubehör-Händler möchte für die Versandplanung wissen, wie viele Teile eine Bestellung insgesamt enthält und wie schwer das Paket wird. Für solche Kennzahlen gibt es den numerischen Aggregator:
- Nach dem Iterator den numerischen Aggregator einfügen, Quellmodul wieder der Iterator.
- Als Funktion
SUMwählen. Daneben stehen unter anderem Durchschnitt, Anzahl, Minimum und Maximum zur Auswahl. - Im Wertfeld für die Stückzahl einfach die Menge zuordnen. Für das Gesamtgewicht verwenden Sie einen kleinen Ausdruck aus Menge mal Artikelgewicht, sofern das Gewicht in den Positionsdaten mitkommt.
Für die reine Stückzahl geht es sogar ohne Iterator: sum(map(Positionen; Menge)) direkt im Feld liefert dasselbe Ergebnis. Liegt das Gesamtgewicht dann über einer Grenze, die Sie selbst festlegen, kann ein Filter danach automatisch einen anderen Versanddienst wählen oder das Lager bitten, die Sendung aufzuteilen.
Das Quellmodul richtig wählen
Der Aggregator fasst alle Bündel zusammen, die seit dem gewählten Quellmodul entstanden sind. Wählen Sie den Auslöser statt des Iterators, versucht Make alle Bestellungen eines Durchlaufs zusammenzuwerfen. Das führt zu Mails mit Positionen aus fremden Bestellungen, wenn der Auslöser mehrere Bestellungen auf einmal liefert. Faustregel: Quellmodul ist das Modul, das die Liste aufgeteilt hat.
Die Option „Group by“ hilft, wenn Sie innerhalb einer Liste gruppieren wollen, zum Beispiel alle Positionen nach Lieferant. Dann entsteht pro Lieferant ein Ergebnis, mit dem Sie jeweils eine Bestellmail an diesen Lieferanten schicken.
Operationen im Blick behalten
Jedes Modul nach dem Iterator läuft einmal pro Position und zählt jeweils als Operation. Bei zehn Positionen und drei Modulen sind das dreißig Operationen pro Bestellung, plus Auslöser und Aggregator. Bei vielen Bestellungen summiert sich das.
Sparsam bauen Sie so:
- Module, die nur einmal pro Bestellung nötig sind, vor den Iterator oder nach den Aggregator setzen
- statt Zeile für Zeile Google-Sheets-Module verwenden, die mehrere Zeilen auf einmal schreiben, falls verfügbar
- Funktionen wie
map()oderjoin()direkt in Feldern nutzen, wenn Sie nur einen einfachen Text aus einem Array brauchen, ganz ohne Iterator
Ein Beispiel für den letzten Punkt: Für eine Mail mit allen Artikelnamen reicht im Textfeld oft join(map(Positionen; Name); ", "). Das spart Iterator und Aggregator komplett.
Typische Fehler auf einen Blick
- Iterator auf ein einzelnes Feld statt auf das Array gesetzt
- Aggregator mit falschem Quellmodul
- Mail-Modul zwischen Iterator und Aggregator, sodass mehrere Mails rausgehen
- Router nach dem Iterator, der die Bündel unbeabsichtigt verdoppelt
Häufige Fragen
Wann brauche ich einen Iterator gar nicht?
Wenn ein Modul bereits pro Eintrag ein eigenes Bündel liefert, etwa „Suchen“-Module, die mehrere Treffer einzeln ausgeben. Dann iteriert Make automatisch.
Kann ich E-Mail-Anhänge genauso verarbeiten?
Ja. Anhänge kommen ebenfalls als Array. Mit dem Iterator speichern Sie jeden Anhang einzeln, etwa in einem Cloud-Ordner.
Warum zeigt der Aggregator nur ein leeres Ergebnis?
Meist ist das Quellmodul falsch gewählt oder zwischen Iterator und Aggregator filtert ein Filter alles heraus.
Werden Ihre Bestelldaten in Make noch doppelt oder unvollständig verarbeitet, bringen wir das Szenario gern in Ordnung, Kontakt über das Anfrageformular.