Group@1

Der Node Group@1 ist ein rein struktureller No-op-Container. Er gruppiert eine Menge von Nodes unter einem Namen, sodass der grafische Editor sie zusammenklappen und ausblenden kann — wie eine benannte Subroutine oder Region. Er hat keine Auswirkung auf die Pipeline-Daten oder die Ausführung: Nodes innerhalb einer Group auszuführen ist identisch damit, sie inline aufzulisten. Der einzige Zweck dieses Nodes ist die visuelle Organisation einer Pipeline.

Adapter-Voraussetzungen

• Allgemeine Verfügbarkeit: Alle Adapter unterstützen diesen Node-Typ.

Node-Konfiguration

Zu den allgemeinen Feldern siehe Überblick. Die gruppierten Nodes werden im transformations-Array des Nodes platziert und laufen der Reihe nach auf demselben Datenkontext.

Konfigurationseigenschaften

Eigenschaft	Typ	Erforderlich	Beschreibung
name	string	Nein	Anzeigename der Gruppe, wird als deren Beschriftung im Editor angezeigt
description	string	Nein	Optionale längere Beschreibung
transformations	array	Nein	Die gruppierten Child-Nodes, ausgeführt der Reihe nach auf demselben Kontext

Beispiel: Gruppierung von Feld-Setup-Nodes

transformations:
- type: Group@1
  name: Set status field
  transformations:
    - type: SetPrimitiveValue@1
      targetPath: $.status
      value: active
      valueType: String
    - type: Logger@1
      message: "status set"

Hinweise zum Verhalten

• Group@1 ist ein No-op: Er liest oder schreibt niemals Daten und verzweigt niemals. Nodes zu gruppieren vs. sie inline aufzulisten erzeugt identische Pipeline-Läufe.
• Child-Nodes laufen auf demselben Datenkontext (wie If@1/Switch@1), sodass JSONPath-Aliase wie $.full innerhalb einer Iteration genau so aufgelöst werden, wie sie es ohne die Gruppe täten.
• Gruppen können verschachtelt werden (eine Gruppe innerhalb einer Gruppe).
• Der Node trägt im generierten Pipeline-Schema einen Hinweis x-nodeKind: "group", damit der Editor ihn als zusammenklappbare Region darstellen kann.