Daten gruppieren

Interne ID: agorum.data.groupby

Mit diesem Knoten gruppieren Sie Datenstrukturen unter der Angabe von Objektkeys.

Aussehen des Knotens

Verhaltensweise

Erreicht das System den Knoten im Workflow, prüft das System die gesetzten Parameter. Die Datenvariable enthält ein Array mit mehreren Datenstrukturen und gruppiert diese anhand der Objektkeys, die Sie im Gruppierungsparameter angeben. Das System gibt die gruppierten Objekte als Array in der Ergebnisvariable zurück.

Endpoints

Standard	Veränderbar?	Weitere Endpoints möglich?
Default (Inlet)	Nein, kann nur ausgeblendet werden.	nein, nicht nötig
Default (Outlet)	Nein, kann nur ausgeblendet werden.	nein, nicht nötig

Parameter

Parameter	Beschreibung	Beispiel
Datenvariable	Definiert die Variable an mit den zu gruppierenden Objektarrays. Der Aufbau einer Datenvariable ist identisch zum Aufbau einer Ergebnisvariable.	Datenvariable
Gruppierungsparameter	Steuert, welche Objektkeys das System als Gruppierungsparameter verwendet. Als Ergebnis erwartet der Workflow-Knoten ein Array.	Gruppierungsparameter
Ergebnisvariable	Definiert die Variable, in der das System die gruppierten Objekte als Array zur Verfügung stellt.	–

Tipp: Verwenden Sie die Variablenauswahl, um einen Überblick über alle nutzbaren Variablen zu erhalten.

Datenvariable

Die nachfolgenden Beispiele gelten ebenfalls für eine Ergebnisvariable.

Für generelle Schreibweise von Variablen im Editor oder als Expression siehe Schreibweise von Variablen.

Im Editor

Im Editor geben Sie den Namen der Workflow-Variable an, die das zu verwendende Array enthält. Das System platziert die Variable automatisch in der Variable des Tokens (token.variables).

dataVariable

Als Expression

Wenn Sie diesen Parameter als Expression angeben, geben Sie den vollständigen Pfad zur Variable an, von der das System den eigentlichen Namen der gewünschten Variable lesen soll.

'token.variables.nameOfDataVariable'

Gruppierungsparameter

Im Editor

Im Editor geben Sie die einzelnen Gruppierungsparameter nacheinander an.

job_position
age

Diese angegebenen Parameter gibt das System als Array an den Knoten weiter.

Als Expression

Wenn Sie diesen Parameter als Expression angeben, muss das Ergebnis ein Array sein, das die Gruppierungsparameter enthält. Sie können sowohl feste Werte als auch Variablen des aktuellen Tokens verwenden.

["job_position", "age"]
token.variables.groupingParameters

Beispiel 1: Angabe nur eines Gruppierungsparameters

Die Datenvariable enthält folgende Objekte:

[{
  firstName: "Maximilian",
  lastName: "Müller",
  job_position: "Sales Manager"
 },
 { 
  firstName: "Martina",
  lastName: "Müller",
  job_position: "Sales Manager"
 },
 { 
  firstName: "Stefan",
  lastName: "Knopf",
  job_position: "Manager"
 },
 {
  firstName: "Daniel", 
  lastName: "Fischer",
  job_position: "Manager" 
 }
]

Als Gruppierungsparameter geben Sie job_position an.

Die Ergebnisvariable enthält folgende Objekte:

[
 [
  {
   firstName: "Maximilian",
   lastName: "Müller",
   job_position: "Sales Manager"
  },
  { 
   firstName: "Martina",
   lastName: "Müller",
   job_position: "Sales Manager"
  }
 ],
 [
  { 
   firstName: "Stefan",
   lastName: "Knopf",
   job_position: "Manager"
  },
  {
   firstName: "Daniel",
   lastName: "Fischer",
   job_position: "Manager"
  }
 ]
]

Beispiel 2: Angabe von zwei Gruppierungsparametern

Die Datenvariable enthält folgende Objekte:

[{
  firstName: "Maximilian",
  lastName: "Müller",
  job_position: "Sales Manager"
 },
 { 
  firstName: "Martina",
  lastName: "Müller",
  job_position: "Sales Manager"
 },
 { 
  firstName: "Stefan",
  lastName: "Knopf",
  job_position: "Manager"
 },
 {
  firstName: "Daniel", 
  lastName: "Fischer",
  job_position: "Manager" 
 }
]

Falls Sie neben der Job-Position zusätzlich nach dem Nachnamen gruppieren möchten, verwenden Sie die Gruppierungsparameter job_position und lastName.

Die Ergebnisvariable enthält folgende Objekte:

[
 [
  {
   firstName: "Maximilian",
   lastName: "Müller",
   job_position: "Sales Manager"
  },
  { 
   firstName: "Martina",
   lastName: "Müller",
   job_position: "Sales Manager"
  }
 ],
 [
  { 
   firstName: "Stefan",
   lastName: "Knopf",
   job_position: "Manager"
  }
 ], 
 [
  {
   firstName: "Daniel",
   lastName: "Fischer",
   job_position: "Manager"
  }
 ]
]