Lektion 04

In diesem Modul bringen wir Intelligenz und Logik in unsere Workflows. Du lernst, wie man Entscheidungen trifft, Aufgaben wiederholt und Übersetzungen sauber verwaltet. Am Ende entwerfen wir gemeinsam einen der wichtigsten E-Commerce-Workflows: die Synchronisation von Lagerbeständen.

Platz für deine Notizen:

---

Checkliste: Was du heute erreichen wirst

• Einen If-Knoten verwenden, um einen Workflow basierend auf Daten zu verzweigen.

• Einen Loop over Items-Knoten verwenden, um eine Liste von Artikeln zu verarbeiten.

• Eine Assignment Table erstellen und zur Übersetzung von Werten im Workflow nutzen.

• Die logischen Schritte eines Stock-Sync-Workflows erklären können.

• Die Faustregel kennen, wann man eine Assignment Table anstelle von vielen If-Knoten verwenden sollte.

---

Übung 1: Artikel filtern mit dem If-Knoten

Ziel: Einen Workflow bauen, der eine Liste von Artikeln liest und nur die aktiven Artikel weiterverarbeitet.

1

Workflow erstellen

• Erstelle einen neuen Workflow mit dem Namen M04-Filter-Active-Articles.

2

Artikel lesen

• Füge einen Xentral-Knoten hinzu, der eine Liste von Artikeln liest (article.list).

3

Durch Artikel loopen

• Füge einen Loop over Items-Knoten hinzu und verbinde ihn mit dem Artikel-Array aus dem Xentral-Knoten.

4

Bedingung einbauen

• Ziehe einen If-Knoten in die Schleife.

• Konfiguriere die Bedingung, um zu prüfen, ob der aktuelle Artikel aktiv ist:

  • Value 1: {{$node["Loop"].context["value"]["aktiv"]}}

  • Operation: Equal

  • Value 2 (Boolean): true

5

Log-Ausgabe

• Verbinde einen Log-Knoten mit dem true-Ausgang des If-Knotens.

• Gib im Log den Namen des aktiven Artikels aus: Aktiver Artikel gefunden: {{$node["Loop"].context["value"]["name"]}}

6

Workflow testen

• Speichere, aktiviere und teste den Workflow.

Erwartetes Ergebnis: Die Logs zeigen nur die Namen der Artikel an, die in Xentral als "aktiv" markiert sind. Inaktive Artikel tauchen im Log nicht auf.

---

Übung 2: Ländercodes übersetzen mit einer Assignment Table

Ziel: Eine Assignment Table für Ländercodes erstellen und sie in einem Workflow verwenden.

1

Assignment Table erstellen

• Gehe zum Data Explorer > Assignment Tables.

• Erstelle eine neue Tabelle mit dem Namen Country-Codes.

• Füge folgende Einträge hinzu:

  • DE → Deutschland

  • AT → Österreich

  • CH → Schweiz

• Speichere die Tabelle.

2

Workflow erstellen

• Erstelle einen neuen Workflow mit dem Namen M04-Translate-Country-Code.

• Füge einen Set-Knoten hinzu, um einen Kunden mit Ländercode zu simulieren. Name: customer, Value (JSON): {"name": "Testkunde", "country": "DE"}

3

Wert nachschlagen

• Füge einen Assignment-Knoten hinzu.

• Table: Wähle deine Country-Codes-Tabelle aus.

• Key: {{$node["customer"].json["country"]}}

4

Workflow testen

• Speichere, aktiviere und teste den Workflow.

Erwartetes Ergebnis: Der Output des Assignment-Knotens enthält den Wert Deutschland.

Bonus: Ändere den Ländercode im Set-Knoten auf AT und teste erneut. Das Ergebnis sollte jetzt Österreich sein.

---

Cheat Sheet: Wichtige Begriffe aus Modul 4

Begriff	Erklärung
If-Knoten	Ein Kontrollfluss-Element, das einen Workflow basierend auf einer oder mehreren Bedingungen in verschiedene Pfade aufteilt (Weggabelung).
Loop over Items	Ein Schleifen-Typ, der durch jedes Element eines Arrays iteriert und die Aktionen innerhalb der Schleife für jedes Element ausführt.
Iteration	Ein einzelner Durchlauf einer Schleife.
Assignment Table	Eine im Data Explorer definierte Schlüssel-Wert-Tabelle zur Verwaltung von statischen Übersetzungen und Mappings (Lookup Table).
Assignment-Knoten	Ein Workflow-Knoten, der einen Wert aus einer Assignment Table anhand eines Schlüssels nachschlägt.
Stock-Sync	Ein typischer E-Commerce-Prozess, bei dem Lagerbestände von einem führenden System (z.B. ERP) an angebundene Verkaufskanäle (z.B. Shops, Marktplätze) synchronisiert werden.