Lektion 05

Willkommen im Power-User-Modul! Heute verlassen wir die ausgetretenen Pfade der Standard-Bausteine und lernen drei extrem mächtige Werkzeuge kennen, mit denen du praktisch jede denkbare Daten-Transformation und -Analyse umsetzen kannst: Custom Functions, Datasets und Text Templates.

Platz für deine Notizen:

---

Checkliste: Was du heute erreichen wirst

• Eine einfache JavaScript-Funktion in einem Function-Knoten schreiben.

• Die Logik der Dataset-Stages $match und $group erklären können.

• Ein Text Template mit einer for-Schleife und Variablen in Twig erstellen.

• Für ein gegebenes Problem das passende Transformations-Werkzeug auswählen können.

---

Übung 1: Namen formatieren mit einer Custom Function

Ziel: Einen Workflow bauen, der einen Namen in ein einheitliches Format (Nachname, Vorname) umwandelt.

1

Workflow erstellen

• Erstelle einen neuen Workflow mit dem Namen M05-Format-Name.

• Füge einen Set-Knoten hinzu, um die Input-Daten zu simulieren. Name: person, Value (JSON):

{"firstName": "Max", "lastName": "Mustermann"}

2

Function-Knoten hinzufügen

• Füge einen Function-Knoten hinzu.

• Kopiere den folgenden JavaScript-Code in den Editor:

Function (JavaScript)

const input = $input.item.json;

// Baue den neuen Namen im Format "Nachname, Vorname"
const formattedName = `${input.lastName}, ${input.firstName}`;

// Gib das Ergebnis als Objekt zurück
return { 
  fullName: formattedName 
};

3

Workflow testen

• Speichere, aktiviere und teste den Workflow.

Erwartetes Ergebnis: Der Output des Function-Knotens ist ein JSON-Objekt, das so aussieht: {"fullName": "Mustermann, Max"}.

---

Übung 2: Eine CSV-Datei mit einem Text Template erstellen

Ziel: Eine Liste von Benutzern in eine saubere CSV-Struktur umwandeln.

1

Workflow erstellen

• Erstelle einen neuen Workflow mit dem Namen M05-Create-User-CSV.

• Füge einen Set-Knoten hinzu, um eine Benutzerliste zu simulieren. Name: users, Value (JSON):

[
  {"name": "Alice", "email": "[email protected]", "role": "Admin"},
  {"name": "Bob", "email": "[email protected]", "role": "User"},
  {"name": "Charlie", "email": "[email protected]", "role": "User"}
]

2

Text Template-Knoten hinzufügen

• Füge einen Text Template-Knoten hinzu.

• Kopiere den folgenden Twig-Code in das Template-Feld:

Text Template (Twig)

3

Workflow testen

• Speichere, aktiviere und teste den Workflow.

Erwartetes Ergebnis: Der Output des Text Template-Knotens ist ein einzelner String, der eine perfekt formatierte CSV darstellt:

Name;Email;Rolle
Alice;[email protected];Admin
Bob;[email protected];User
Charlie;[email protected];User

---

Cheat Sheet: Wichtige Begriffe aus Modul 5

Begriff	Erklärung
Custom Function	Ein Knoten, der die Ausführung von eigenem JavaScript-Code innerhalb eines Workflows ermöglicht.
Dataset	Ein Werkzeug zur Ausführung von Aggregations-Pipelines (ähnlich MongoDB) auf Daten, die im Data Store gespeichert sind. Dient zur Analyse, Gruppierung und Transformation großer Datenmengen.
Aggregation Pipeline	Eine Kette von Verarbeitungsschritten (Stages), bei der die Ausgabe eines Schritts die Eingabe für den nächsten ist.
Stage ($match, $group)	Ein einzelner Verarbeitungsschritt in einer Aggregation Pipeline. $match filtert Daten, $group gruppiert und aggregiert sie.
Text Template	Ein Knoten, der eine Template-Engine (Twig) verwendet, um dynamisch textbasierte Dateien (wie CSV, XML, HTML) aus JSON-Daten zu erzeugen.
Twig	Eine weit verbreitete und einfach zu erlernende Template-Sprache, die in Connect für den Text Template-Knoten verwendet wird.