Functions
1. Überblick
Die Funktion Custom Functions in Xentral Connect ermöglicht es dir, individuelle Logiken in JavaScript zu implementieren, die über die Standard-Flow-Elemente hinausgehen.
Custom Functions eignen sich insbesondere für:
komplexe Berechnungen oder Prüfungen
Daten-Transformationen, die sich nicht mit Standard-Assignments abbilden lassen
das Kapseln wiederkehrender Logikbausteine
das Reduzieren von Komplexität innerhalb eines Flows
Custom Functions können in jedem Flow als eigenes Element eingebunden und mit Parametern versorgt werden.
2. Zugriff auf Custom Functions
Du findest die Custom Functions in der Connect Instanz im linken Menü:
Nach dem Öffnen siehst du – falls noch keine Funktionen angelegt wurden – eine leere Übersicht.
Hier stehen dir folgende Aktionen zur Verfügung:
Hinzufügen einer neuen Custom Function
Importieren einer bestehenden Custom Function (analog zum Flow-Import)
3. Neue Custom Function anlegen
Über den Button „Hinzufügen“ lässt sich eine neue Custom Function erstellen.
Im Erstellungsdialog definierst du folgende Eigenschaften:
3.1 Name
Ein frei wählbarer Name zur Identifikation der Funktion.
3.2 Datentyp (Output Type)
Der Datentyp bestimmt, welcher Wert aus der Custom Function zurückgegeben wird:
String – wenn die Funktion einen einzelnen Textwert ausgibt
Number – für numerische Ergebnisse
Boolean – für Wahr/Falsch-Ausgaben
Object – wenn mehrere Felder in einer strukturierten Ausgabe zurückgegeben werden
3.3 Projektzuordnung
Die Custom Function kann einem Projekt zugeordnet werden, um sie logisch zu strukturieren.
3.4 Null-Werte erlauben
Mit dieser Option bestimmst du, ob der Output der Custom Function leer (null) sein darf.
3.5 Parameter hinzufügen
Du kannst beliebig viele Eingabeparameter definieren.
Jeder Parameter benötigt:
einen Bezeichner
einen Datentyp
und optional:
einen Standard-Default-Wert
eine Angabe, ob der Parameter leer sein darf
Diese Parameter stehen später im Code-Editor und beim Einsatz in einem Flow zur Verfügung.
4. JavaScript-Codeeditor
Nach dem Speichern öffnet sich der Codeeditor.
Dieser bietet dir:
Syntax-Highlighting
Autovervollständigung
Code-Beautify
Ausführbare Testfunktion
Fehlerhinweise (z. B. nicht definierte Variablen)
Hier implementierst du die eigentliche Logik der Custom Function in JavaScript.
4.1 Beispiel: Ersetzen von Zeichen in einem String
Im gezeigten Beispiel soll das Zeichen & durch das Wort “und” ersetzt werden.
Parameter (Beispiel):
myString (Typ: String)
Beispielhafte Funktion:
Der Editor weist auf Fehler hin, wenn Parameter falsch benannt sind – beispielsweise wenn „String“ statt „myString“ referenziert wird.
5. Testen einer Custom Function
Im Codeeditor befindet sich eine integrierte Test Function.
Diese ermöglicht es dir, die Funktion direkt und ohne Flow auszuführen.
Ablauf:
Parameterwerte eingeben
Absenden klicken
Ergebnis einsehen
Fehler beheben (z. B. Syntaxfehler, fehlende Leerzeichen)
Damit lässt sich die Logik schnell iterativ testen.
6. Einsatz einer Custom Function im Flow
Custom Functions können in jedem Flow verwendet werden.
Der Einsatz erfolgt über das Flow-Element:
Flow → Element hinzufügen → Custom Function
6.1 Konfiguration im Flow
Custom Function auswählen
Das Dropdown zeigt alle vorhandenen Funktionen an.
Parameterzuordnung
Die Eingabeparameter deiner Custom Function werden angezeigt.
Diese können mit Variablen aus dem Flow befüllt werden (z. B. Ergebnis aus einem Assignment).
Output-Variable definieren
Die Funktion gibt ihren Rückgabewert in eine Variable aus, die du im Flow weiterverwenden kannst.
6.2 Beispiel-Flow
Ein Assignment-Element erstellt die Variable myString mit einem Testtext.
Das Custom-Functions-Element ruft die erstellte Funktion auf und übergibt myString.
Der Output wird in einer neuen Variable gespeichert (z. B. processedString).
Ein Log-Element gibt beide Variablen aus.
6.3 Test im Flow
Beim Ausführen des Flows (Flow testen):
Im Reporting wird angezeigt, ob die Custom Function ausgeführt wurde.
Die Ausgabevariablen erscheinen im Log-Element.
7. Best Practices
Komplexe Logik kapseln:
Nutze Custom Functions, um umfangreiche Berechnungen oder Verarbeitungen aus dem Flow zu entfernen.
Wiederverwendbarkeit:
Häufig benötigte Transformationen sollten als Custom Function ausgelagert werden.
Fehler früh abfangen:
Verwende die Testfunktion, um Syntaxfehler und falsche Parameter schnell zu identifizieren.
Klare Parameternamen:
Benenne Parameter so, dass ihre Bedeutung im Flow sofort erkennbar ist.
8. Zusammenfassung
Custom Functions erweitern Xentral Connect um flexible, JavaScript-basierte Logikbausteine.
Sie bieten:
individuelle, komplexe Verarbeitung
saubere Kapselung wiederkehrender Logik
einfache Integration in Flows
komfortables Testing direkt im Editor
Damit stellen sie eine zentrale Ergänzung zu den Standard-Flow-Elementen dar und ermöglichen anspruchsvolle Anwendungsfälle, die sich sonst nur schwer abbilden lassen.
Zuletzt aktualisiert
War das hilfreich?