Mapping

Zweck

Das Mapping-Element transformiert ein Datenobjekt von einer Quellstruktur in eine Zielstruktur, basierend auf einem Satz vorkonfigurierter Regeln. Ein „Mapping“ ist eine wiederverwendbare Komponente, in der Sie definieren, wie Felder aus einem Quellobjekt den Feldern in einem Zielobjekt entsprechen.

Dieses Element ist unerlässlich für Datenintegrationsaufgaben, bei denen Sie Daten vom Format eines Systems in das eines anderen übersetzen müssen.

Anwendungsfälle:

• Konvertieren einer eingehenden Webhook-Payload von einem Drittanbieterdienst in das von Ihrer internen Datenbank geforderte Format.

• Transformieren eines komplexen internen Datenobjekts in eine vereinfachte Struktur, bevor es an eine externe API gesendet wird.

• Mappen von Produktdaten aus dem Format eines Lieferanten in das Format Ihrer E-Commerce-Plattform.

---

Praktische Anwendungshinweise

• Zentralisierte Transformationsregeln: Durch die Definition der Transformationslogik in einem wiederverwendbaren Mapping können Sie dieselben Regeln in mehreren Flows verwenden. Bei Änderungen am Zielsystem muss das Mapping nur an einem Ort aktualisiert werden.

• Umgang mit Null-Werten: Die Option „Leere Einträge erhalten“ (preserveNull) ist wichtig für APIs, die streng bezüglich der Anwesenheit von Feldern sind. Sie steuert, ob Felder, die auf null oder leer gemappt werden, in der Ausgabe enthalten sind oder weggelassen werden.

• Daten-Rein, Daten-Raus: Dieses Element ist ein reines Datentransformationswerkzeug. Es nimmt eine Datenstruktur als Eingabe und gibt eine neue Datenstruktur aus. Es wird oft zwischen einem Abruf- oder Auslöse-Element und einem Daten sendenden Element verwendet.

---

Konfigurationsoptionen

Option	Beschreibung	Eingabeformat	Beispielwert
Mapping	Ein Dropdown-Menü zur Auswahl des vordefinierten Mappings, das Sie anwenden möchten. Die Mapping-Regeln werden separat verwaltet.	Auswahl aus der Liste der verfügbaren Mappings.	Shopify Bestellung zu ERP Bestellung
Quelle	Das Quelldatenobjekt oder -array, das Sie transformieren möchten.	JSON-Objekt oder -Array.	{{trigger.data}}
Leere Einträge erhalten	Wenn aktiviert, werden Felder im Zielobjekt, die am Ende einen null- oder leeren Wert haben, in die Ausgabe aufgenommen. Wenn deaktiviert, werden sie weggelassen.	Checkbox (Boolean).	–
Test mapping	Eine Hilfsschaltfläche, die einen Test der Transformation basierend auf dem ersten Datensatz der Quell-DataStructure durchführt und eine Vorschau der Ausgabe anzeigt.	Klick auf die Schaltfläche.	–

---

Eingabe-/Ausgabe-Erwartungen

• Eingabe: Das Element benötigt das Quelle-Datenobjekt (oder Array), das transformiert werden soll.

• Ausgabe: Es erzeugt eine einzige Ziel-Variable. Diese Variable enthält das neue Datenobjekt, nachdem die Mapping-Regeln auf die Quelldaten angewendet wurden.

---