Transformer
Bezeichnung | Definition |
|---|---|
String Replacer | Ersetzt einen bestimmten Wert durch einen String |
Tag Stripper | |
HTML Entities | |
Mask | |
New Line to Bar | |
PHP Transformer | Erlaubt es, eine eigene Bedienung mithilfe eines PHP Editors zu erstellen |
Datum formatieren | Lässt ein Datenfeld in ein bestimmtes Datumsformat wandeln. Es stehen Timestamp und Datum zur Verfügung |
Zeichen zählen | |
Verknüpfung | |
Zeichenfolge wiederholen | |
Zeichenfolge bestimmen | |
Teil-Zeichenfolge zurückgeben | |
Zahl runden | |
Extremwert zurückgeben | |
Text ersetzen | Erlaubt es, Texte und Wörter durch anderen Text / andere Zeichenfolgen zu ersetzen |
Summe | |
Case Converter | |
Char Trimmer | |
Sortieren | |
Cast | Wandelt den Wert eines bestimmten Datenfelds in einen ausgewählten Datentypen. Zur Verfügung stehen int, float, bool und string |
Wert-Zuweisung | Erlaubt es, einem Datenfeld einen bestimmten Wert zuzuweisen. Zur Verfügung stehen string, int, float, bool, text, date und null. Hier können sowohl statische Werte als auch Variablen eingegeben werden. |
Betrag/absoluter Wert | |
Grundrechenarten | |
Ein Transformator kann erstellt werden, indem zunächst ein Datenfeld aus der Quell- oder Ziel-Datenstruktur ausgewählt wird. Durch das Klicken auf den Kreis bzw. den Trichter vor dem Datenfeld öffnet sich ein Fenster, welches eine Übersicht von allen bereits vorhandenen Transformatoren auflistet. Sollten noch keine Transformatoren vorhanden sein, werden lediglich die Input- und Output- Variablen des Feldes angezeigt.
Beim Auswählen des Feldes '+ Transformer hinzufügen' wird automatisch ein neuer Transformer hinzugefügt, der neu konfiguriert werden kann.
Mit einem Klick auf das Zahnrad-Symbol öffnet sich die Konfiguration des Transformators.
Unter "Basis Konfiguration" kann der Transformator benannt werden und es können Input Variablen ausgewählt werden. Dabei wird zwischen source, object, output und config Variablen sowie dem Collection Index unterschieden:
- source: Input-Variablen, d. h. Felder aus der Quell-Datenstruktur, die auf das aktuelle Feld gemappt sind
- object: Felder aus der Quell-Datenstruktur
- output: Felder, die in einem anderen Transformer des Mappings definiert wurden
- config: Global definierte Konfigurationswerte
- Collection Index: Der Collection Index speichert den Feldnamen von Collection Elementen ab. Wenn beispielsweise das Quell-Feld "number" auf ein Collection-Feld der Ziel-Datenstruktur gemappt wird, kann mit dem Collection Index der Feldname "number" angesteuert werden. Dieser kann dann beispielsweise als Filterbedingung genutzt oder mit dem Transformator "Wert-Zuweisung" als Output definiert werden
Auf Variablen wird immer mittels Dotnotation und doppelt geschweiften Klammern zugegriffen. Die Input-Variable "id" würde demnach mit "{{source.id}}" angesprochen werden. Alternativ kann aber auch das Dropdown Menü für die Auswahl von Variablen genutzt werden.
Außerdem kann die Output-Variable umbenannt werden (Default ist auf "output 1").
Unter "Bedingungen" können Bedingungen festgelegt werden, unter denen der Transformator ausgeführt wird. Unter "Verfügbare Variablen" sind die Variablen aufgelistet, die in der Basis-Konfiguration als Input Variablen definiert wurden. Mit Klick auf die Variable kann sie in die Zwischenablage kopiert werden.
Eine Bedingung besteht aus einem Feld, einem Operator und einem Wert. Anstatt eines statischen Wertes kann hier auch eine Variable ausgewählt werden, sodass zwei Felder miteinander verglichen werden. Mit den Buttons rechts kann die Bedingung geleert oder gelöscht werden. Außerdem kann die Filterbedingung mit "+und" weiter geschachtelt werden. Links kann per Klick bestimmt werden, ob es eine "und"- (&) oder eine "oder"-Bedingung (or) ist. Mit "+ und Bedingung" können beliebig viele Bedingungen hinzugefügt werden.
Unter "Transformer Konfiguration" kann der jeweilige Transformer konfiguriert werden. Die Konfiguration unterscheidet sich je nach Transformator (s. o.).
Auch hier sind unter "Verfügbare Variablen" die Variablen aufgelistet, die in der Basis-Konfiguration als Input Variablen definiert wurden. Mit Klick auf die Variable kann sie in die Zwischenablage kopiert werden.
Transformatoren können innerhalb von einzelnen Feldern verkettet werden. Um zwei Transformatoren zu verketten, muss zunächst ein beliebiger Transformer erstellt werden. Anschließend wird eine Variable benötigt, die beide Transformatoren miteinander verbindet. Das Output-Value des ersten Transformers wird in diesem Fall als Input-Value des zweiten Transformers genutzt.
So wird beim Ausführen zunächst der erste Transformer durchlaufen und erhält ein Output-Value. Dieses wird nun als Input-Value für den zweiten Transformer genutzt. So können beliebig viele Transformatoren miteinander verkettet werden.
Um Transformatoren von verschiedenen Feldern zu verketten, gibt es die Möglichkeit, die gewünschten Felder bereits in der Quell-Datenstruktur zu transformieren und anschließend die transformierte Quell-Variable in der Ziel-Datenstruktur zu nutzen. Eine Verkettung von Transformatoren verschiedener Felder der Ziel-Datenstruktur ist nicht möglich.
Mit einem Klick auf das Filter Symbol öffnet sich das Konfigurationsmenü für die Collection Transformer. Unter "Collections" und weiter "Konfigurieren" kann der Collection Transformer konfiguriert werden.
Zunächst kann entschieden werden, wie die Daten zusammengeführt werden sollen. Diese Option ist vor allem relevant, wenn Einzelfelder auf eine Collection gemapped werden sollen. Folgende Optionen sind verfügbar:
- Feste Anzahl
- Multiplikation
- Summe
- Zuordnung
In einem zweiten Schritt können die Daten dann gefiltert werden. Hier kann eine Bedingung hinzugefügt werden oder spezifische Elemente aus dem Collection-Feld ausgewählt werden (z.B. das erste Element "first" oder das vierte Element "nth, Index: 3").