Produkte eines Projektes auslesen und Hersteller aktualisieren

Templates: Eltern-Flow und Kind-Flow Beispiel

In diesem Tutorial lernst du, wie du mithilfe zweier Templates aus der Flow-Library eine Eltern-Kind-Flow-Struktur erstellst.

Der Elternflow sammelt Produkte eines Projektes ein und iteriert über sie; der Kindflow aktualisiert für jedes Produkt den Hersteller.

---

---

⭐ Übersicht

Du baust folgende Logik:

1. Parent Flow

   • Ruft alle Produkte eines Projekts über die Xentral API ab

   • Durchläuft das Produkt-Array

   • Ruft für jedes Produkt den Child Flow auf

2. Child Flow

   • Nimmt die Product ID entgegen

   • Baut einen Update-Payload

   • Aktualisiert das Produkt (z. B. Manufacturer)

---

1) Templates importieren

1. Öffne die Flow Library.

2. Importiere die folgenden Templates:

   • [TEMPLATE] Kind-Flow Beispiel: Von Eltern-Flow getriggerter Eintrag verarbeiten

   • [TEMPLATE] Eltern-Flow Beispiel: Einträge iterieren und Kind-Flow starten

3. Stimme den Nutzungsbedingungen zu und aktiviere beide Flows.

4. Die Flows erscheinen anschließend in deinem Connect Backend → Default Project.

---

2) Elternflow konfigurieren

Öffne den Elternflow über das Pinsel-Symbol.

2.1 Struktur des Templates (Startzustand)

Das Template enthält:

• ein statisches Array als Beispiel

• eine Schleife, die dieses Array iteriert

• einen Platzhalter für den Child Flow

Ersetze im Schleifen-Element den Platzhalter durch deinen importierten Kind-Flow.

---

3) Testlauf mit Template-Daten

1. Klicke Workflow testen.

2. Im Reporting siehst du anschließend:

   • Erfolgreiche Parent-Execution

   • Je ein Trigger für den Child Flow pro Beispielprodukt

So stellst du sicher, dass die Parent–Child-Verkettung korrekt funktioniert.

---

4) Echte Produkte per API abrufen (statt Template-Daten)

Jetzt ersetzt du die Beispielwerte durch dynamische API-Daten.

4.1 Assignment entfernen

Lösche oder deaktiviere das statische Beispiel-Assignment.

4.2 Xentral-API-Connector hinzufügen

1. Füge einen Xentral API Connector ein.

2. Wähle:

   • Products → List

3. Filtere die Produkte nach einem bestimmten Projekt:

   (Beispiel: projectName = "Connect Prio")

Hinweis: Details zum Filteraufbau findest du in der Developer-Dokumentation.

1. Benenne die Ergebnisvariable:

   products

4.3 Response prüfen

Deaktiviere nach Bedarf die nachfolgenden Elemente und führe einen Test aus.

Im Reporting siehst du den Payload:

• data enthält das Array mit deinen Produkten

---

5) Schleife konfigurieren

1. Aktiviere die Schleife wieder.

2. Stelle ein:

   • Zu iterierende Elemente: {{output.products.data}}

   • Iterations Element: product

   • Parameter im internen Trigger

     • {{output.product.id}}

     • ggfls. weitere Felder

3. Optional: Stelle im Connector den Minimal Header ein, wenn du nur IDs brauchst.

Nach einem Test solltest du sehen, dass für jedes Produkt der Child Flow gestartet wurde.

---

6) Child Flow konfigurieren (Hersteller aktualisieren)

Jetzt öffnest du den Kind-Flow.

6.1 Vorhandene Parameter

Der Child Flow erhält bereits:

• Product ID (vom Parent Flow)

• Case Identifier (für Reporting)

6.2 Update-Payload aufbauen

1. Öffne die Xentral API Dokumentation für:

   • Product → Update

2. Finde das gewünschte Feld, im Beispiel:

   • manufacturer.name

3. Erstelle nun ein neues Assignment:

   • Variable: productUpdate

   • Setze z. B.:

productUpdate.manufacturer.name = "xentral-connect-test"

6.3 API-Call zum Updaten hinzufügen

1. Füge einen weiteren Xentral API Connector hinzu.

2. Wähle:

   • Product → Update

3. Parameter:

   • Product ID = Input vom Parent Flow

   • Payload = productUpdate

Jetzt ist der Child Flow bereit für echte Produkt-Updates.

---

7) Gesamttest

1. Gehe zurück in den Parent Flow.

2. Starte einen Testlauf.

Erwartetes Ergebnis:

• Parent Flow holt Produkte ab

• Für jedes Produkt wird der Child Flow gestartet

• Child Flow schreibt den neuen Hersteller-Wert

Im Reporting des Child Flows kannst du jede Iteration öffnen und sehen, ob:

• der Update-Call erfolgreich war

• die API-Antwort gültig ist

---

8) Ergebnis in Xentral prüfen

Öffne die Artikel in deiner Xentral-Instanz und prüfe, ob der Hersteller aktualisiert wurde.

---

9) Optional: Parameter, Erweiterungen & Best Practices

🔧 Parameter hinzufügen

Du kannst Update-Werte (z. B. Herstellername) auch parametrisierbar machen:

• Öffne im Child Flow Workflow bearbeiten

• Füge Parameter hinzu

• Übergib Werte vom Parent Flow oder direkt aus der Kundeninstanz

🔧 Weitere Felder aktualisieren

Erweitere das Assignment um zusätzliche API-Felder wie:

• Kategorie

• EAN

• Beschreibung

• Freifelder

🏷️ Flow-Benennung

Benenne beide Flows sinnvoll um:

Parent Flow Beispiel:

• “Produkte aus bestimmtem Projekt laden und einzeln starten”

Child Flow Beispiel:

• “Hersteller am Produkt aktualisieren”

---

✅ Abschluss

Du hast jetzt eine voll funktionsfähige Parent–Child Flow Architektur aufgebaut:

• Produkte werden dynamisch über die Xentral API geladen

• Eine Schleife übergibt jedes Produkt an den Child Flow

• Der Child Flow führt ein Update am Produkt durch

• Alles lässt sich flexibel erweitern und parametrisieren