Xentral Connect v2: User Dokum...
Mappings

Transformer

7min

Verfügbare Transformatoren



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



Transformatoren anwenden

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.

Beispiel 'Transformer hinzufügen'
Beispiel 'Transformer hinzufügen'


Konfiguration des Transformators

Mit einem Klick auf das Zahnrad-Symbol öffnet sich die Konfiguration des Transformators. 

Document image


Basis Konfiguration

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"). 

Bedingungen

Document image


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.

Transformer Konfiguration

Document image


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 verketten

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.

Collection Transformer

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.

Document image


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").