Transformatoren

Transformatoren sind zentrale Bausteine im Xentral Connect Flow Editor, mit denen du Daten innerhalb eines Workflows verändern, umwandeln oder neu strukturieren kannst.

1. Transformator hinzufügen

1

Öffne den Flow: Öffne deinen Flow im Flow-Editor.

2

Neues Element hinzufügen: Klicke im Flow auf das Plus-Icon (+), um ein neues Element hinzuzufügen.

3

Bereich auswählen: Wähle im Menü den Bereich Transformatoren aus.

4

Transformator auswählen: Du siehst nun eine Liste mit verschiedenen Transformatoren, die jeweils eine bestimmte Funktion erfüllen (z. B. mathematische Operationen, String-Manipulation, Datumsfunktionen usw.).

5

Transformator hinzufügen: Wähle den gewünschten Transformator aus und füge ihn deinem Flow hinzu.

Bildschirmfoto 2025-10-30 um 07.54.55.png

2. Transformator konfigurieren

Sobald du den Transformator hinzugefügt hast, öffnet sich in der rechten Sidebar die Konfigurationsmaske.

Diese ist bei allen Transformatoren ähnlich aufgebaut:

Bereich	Beschreibung
Bezeichnung	Eindeutiger Name des Transformators im Flow.
Kommentar	Optionale Beschreibung zur besseren Nachvollziehbarkeit.
Konfiguration	Je nach Transformator können hier zusätzliche Optionen eingestellt werden.
Eingabevariable	Hier gibst du an, welche Variable der Transformator verarbeiten soll (z. B. {{output.data}}).
Ausgabevariable	Hier legst du fest, in welche Variable das Ergebnis geschrieben wird (z. B. transformedData).

Bildschirmfoto 2025-10-30 um 07.56.04.png

3. Nach bestimmten Funktionen suchen

Die Komponentenbibliothek bietet eine leistungsfähige Suchfunktion, über die du gezielt nach bestimmten Transformatoren oder enthaltenen Funktionen suchen kannst.

Beispiel:

Wenn du nach der PHP-Funktion round() suchst, gib einfach “round” in das Suchfeld der Komponentenbibliothek ein. Der passende Transformator wird dir vorgeschlagen.

Nachdem du ihn hinzufügst, siehst du in der Konfiguration, dass die gewünschte round-Funktion integriert ist und direkt verwendet werden kann.

Bildschirmfoto 2025-10-30 um 07.58.50.png

4. Best Practise: Arbeiten mit dem Transformator “Listenfunktionen”

Im folgenden Beispiel siehst du, wie du Transformatoren miteinander kombinierst, um Daten in einer Liste dynamisch aufzubauen und im Log auszugeben.

1

Leere Liste erstellen

• Öffne die Komponentenbibliothek und füge das Element „Listenfunktionen“ hinzu.

• Wähle als Funktion “Leere Liste”.

• Definiere eine Output-Variable, z. B. emptyList.

2

Element definieren

• Füge den Transformator „Zuordnung“ hinzu.

• Definiere dort die gewünschten Eigenschaften deines Elements, z. B.:

Beispiel

{
  "id": 1,
  "name": "Testelement"
}

• Speichere das Ergebnis in einer Variablen, z. B. element.

3

Element zur Liste hinzufügen

• Füge erneut die Listenfunktionen-Komponente hinzu.

• Wähle als Funktion “Zu Liste hinzufügen”.

• Definiere:

  • Liste: {{output.emptyList}}

  • Neues Element: {{output.element}}

  • Output-Variable: emptyList (so wird das Element direkt in die bestehende Liste eingefügt)

4

Liste im Log ausgeben

• Füge eine Log-Nachricht hinzu.

• Gib dort deine Liste (emptyList) als Payload aus.

• Führe den Workflow testweise aus.

5

Ergebnis prüfen

• Öffne im Reporting die Log-Messages des Flows.

• Du siehst dort deine Liste mit dem hinzugefügten Element.

---