Datentransformation

Datentransformationsvorgänge zum Filtern, Zuordnen und Gruppieren von Sammlungen.

Transformiert Daten mithilfe einer Vielzahl von Vorgängen. Der Datentransformationsknoten und seine einzelnen Vorgangsknoten (Filter, Zuordnung, Gruppieren nach) sind als separate auswählbare Knoten in der Knotenpalette verfügbar.

Wann Datentransformation im Vergleich zu Skript verwendet werden sollte

Verwenden Sie Datentransformationsvorgänge, wenn es sich bei der Transformation um einen Vorgang auf Feldebene auf einer Sammlung handelt. Die verfügbaren Operationen umfassen:

• Filtern
• Zuordnung
• Gruppierung

Verwenden Sie ein Skript, wenn die Transformation bedingte Logik, Arithmetik oder String-Manipulation erfordert oder wenn kein dedizierter Vorgang den Fall abdeckt. Beide können kombiniert werden: Ein Datentransformationsvorgang kann eine Sammlung filtern oder umgestalten und dann das Ergebnis an einen Skriptknoten übergeben.

Ausgabe

Alle Knoten für Datentransformationsvorgänge geben ihr Ergebnis als output aus, auf die später als $vars.<nodeName>.output zugegriffen werden kann.

Filter

Behält nur die Einträge in einer Sammlung bei, die Ihren Bedingungen entsprechen.

Konfiguration

Feld	Erforderlich	Beschreibung
Eingabe	Ja	Die zu filternde Sammlung (Array). Referenzieren als $vars.<nodeName>.output.
Bedingungen	Ja	Mindestens eine Bedingung. Ein Eintrag wird nur beibehalten, wenn alle Bedingungen erfüllt sind.

Beispiel

Nur Aufträge mit einem status von "completed" beibehalten:

• Eingabe: $vars.fetchOrders1.output.body
• Bedingung: status ist gleich completed

Ausgabe verfügbar als $vars.filter1.output.

Karte

Transformiert jeden Eintrag in einer Sammlung, indem seine Felder geändert oder umgestaltet werden.

Konfiguration

Feld	Erforderlich	Beschreibung
Eingabe	Ja	Die zu transformierende Sammlung (Array).
Feldzuordnungen	Ja	Definieren Sie für jedes Zielfeld den Namen und das Quellfeld oder den Quellausdruck.

Beispiel

Benennen Sie die Felder firstName und lastName in first und last um:

Zielfeld	Quellzuordnung
first	firstName
last	lastName

Ausgabe verfügbar als $vars.map1.output.

Gruppieren nach

Gruppiert eine Sammlung nach einem freigegebenen Feld und aggregiert Werte wie Gesamtwerte, Durchschnittswerte oder Anzahlen.

Konfiguration

Feld	Erforderlich	Beschreibung
Eingabe	Ja	Die zu gruppierende Sammlung (Array).
„Gruppieren nach“-Feld	Ja	Das Feld, dessen Wert die Gruppe bestimmt.
Aggregationen	Nein	Zusätzliche berechnete Felder pro Gruppe (Anzahl, Summe, Durchschnitt, Min., Max., Erste, Letzte, Sammeln).

Beispiel

Gruppieren Sie eine Liste von Aufträgen nach region und zählen Sie die Anzahl der Aufträge pro Region:

• Eingabe: $vars.fetchOrders1.output.body
• Gruppieren nach: region
• Aggregation: orderCount = Count

Ausgabe verfügbar als $vars.groupBy1.output.

Häufige Probleme

Problem	Resolution
Ausgabe ist nach dem Filter leer	Die Bedingungen stimmen mit keinen Einträgen überein. Überprüfen Sie die Eingabesammlung in der Execution Trace, um die Feldnamen und Werte zu überprüfen.
Die Zuordnungsausgabe enthält undefined Felder	Der Quellfeldpfad ist in den Eingabeeinträgen nicht vorhanden. Verwenden Sie die Ausführungsablaufverfolgung, um die Eingabestruktur zu bestätigen.