User Dokumentation
Mappings

Best Practices

5min

Was genau kann ich mit Mappings machen?

Mappings bieten die Möglichkeit Daten aus verschiedenen Datenstrukturen zu transformieren, damit diese ohne Probleme miteinander interagieren können. 

Möglichkeiten und Vorteile von Mappings:

  • Datenstrukturen transformieren
  • Anzeige von Quell- und Ziel-Struktur
  • visuelle Mapping-Linien
  • Einfaches Verwalten von Mappings zwischen Datenfeldern
  • Einfaches Konfigurieren von Transformatoren

Praktische Tipps / Best Practice

Können mehrere Quell-Felder auf ein Zielfeld gemapped werden?

Ja, mehrere Quell-Felder können auf ein einzelnes Zielfeld gemapped werden.

Wie wird eine Collection auf Einzelfelder gemapped?

Das gewünschte Collection-Feld der Quell-Datenstruktur muss auf das gewünschte Einzelfeld der Ziel-Datenstruktur gemapped werden. Dadurch werden alle Werte aus dem Collection-Feld in einem Array an das Ziel-Feld übergeben. Mit einem Klick auf das Filter Symbol kann die Auswahl weiter gefiltert werden. Im Feld 'Input-Variablen' gibt es die Option 'Collections'. Unter 'Konfigurieren' kann entschieden werden, wie die Daten zusammengeführt werden sollen. Diese Option ist vor allem relevant, wenn Einzelfelder auf eine Collection gemapped werden sollen. In einem zweiten Schritt können die Daten gefiltert werden. Eine Bedingung kann hinzugefügt, oder spezifische Elemente aus dem Collection-Feld ausgewählt werden (z.B. das erste Element "first" oder das vierte Element "nth, Index: 3").

Wie werden Einzelfelder auf eine Collection gemapped?

Dazu muss lediglich das gewünschte Einzelfeld der Quell-Datenstruktur auf das gewünschte Collection-Feld der Ziel-Datenstruktur gemapped werden. Mit einem Klick auf das Filter Symbol öffnet sich das Konfigurationsmenü für die Collection Transformer. Hier kann definiert werden, wie mit den gemappten Input-Feldern umgegangen werden soll.

Wie werden Transformer innerhalb von einem Feld verkettet ?

  1. Ersten Transformer erstellen. Dieser enthält eine Output-Variable (output1)
  2. Zweiten Transformer erstellen
  3. Als Input Variable des zweiten Transformer die Output-Variable des ersten Transformer auswählen (output1 als Input). So werden beide Transformer durch ein gemeinsames Value verkettet

Kann ich Outputs aus Transformern anderer Felder der Ziel-Datenstruktur nutzen?

Nein. Innerhalb der Ziel-Datenstruktur können Transformer nur innerhalb von Feldern intern verkettet werden. Es besteht jedoch die Möglichkeit, mehrere Quell-Felder auf ein Ziel-Feld zu mappen und diese dann spezifisch zu transformieren. So können die Outputs aus Transformern von verschiedenen Felder miteinander verkettet werden.

Wo kann ich einstellen, wie die Collection-Elemente in der Ziel-Datenstruktur zusammengeführt werden?

Dazu kann der Collection Transformer genutzt werden. Mit der Auwahl des Filter Symbols öffnet sich das Konfigurationsmenü für die Collection Transformer. Unter 'Collections' und 'Konfigurieren' kann der Collection Transformer konfiguriert werden. Es besteht die Möglichkeit, die Zusammenführung der Daten sowie das Filtern der Daten zu bestimmen.