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.:

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

VorherigeBearbeiter in Auftrag anpassen

Zuletzt aktualisiert

War das hilfreich?