Daten konvertieren

Interne ID: agorum.mapping.transform

Mit diesem Knoten konvertieren Sie Daten in ein anderes Zielformat, um etwa Rechnungsdaten an eine Buchhaltungsschnittstelle zu übergeben. Für die Konvertierung verwendet das System ein Mapping, das aus Quell- und Zielfeldern besteht. Diese Mappings definieren Sie wiederum in Metadaten-Kollektionen.

Für das Definieren von Mappings und dem Verwenden des Mapping-Editors siehe mapping_source und mapping_target.

Aussehen des Knotens

Verhaltensweise

Erreicht das System den Knoten im Workflow, prüft es die gesetzten Parameter. Das gewählte Mapping stellt das System in der Ergebnisvariablen zur Verfügung. Wenn keine Ergebnisvariable angegeben ist, legt das System das Mapping direkt in die Workflow-Variable (token.variables) ab.

Endpoints

Standard	Veränderbar?	Weitere Endpoints möglich?
Default (Inlet)	Nein, kann nur ausgeblendet werden.	nein, nicht nötig
Default (Outlet)	Nein, kann nur ausgeblendet werden.	nein, nicht nötig

Parameter

Parameter	Beschreibung	Beispiel
Mapping	Definiert die Mappingdefinition, die das System dazu verwendet, um die Inhalte des Buchungsstapels zu erzeugen. Sie können das zu verwendende Mapping direkt wählen oder ein neues Mapping über die Editieren-Schaltfäche erstellen. Damit Sie bei der Definition eines neuen Mappings Quell- und Zielmappings wählen können, müssen Sie diese vorab innerhalb der metadata-collection.yml und dort innerhalb der jeweiligen Dokumententypdefinition als Quelle oder Ziel definieren. Für das Definieren von Mappings siehe metadata-collection.yml definieren.	Mapping
Datenvariable	Definiert die Variable mit den zu konvertierenden Daten. Übergeben Sie zwingend die Variable ag_metadata_collection, da der Knoten diese Variable zur Transformation benötigt. Der Aufbau einer Datenvariableist identisch zum Aufbau einer Ergebnisvariable.	Datenvariable
Ergebnisvariable	Definiert die Variable, in der das System das Mapping zur Verfügung stellt. Wenn Sie die Variable nicht angeben, legt das System das Mapping direkt in die Workflow-Variable (token.variables) ab.	–

Tipp: Verwenden Sie die Variablenauswahl, um einen Überblick über alle nutzbaren Variablen zu erhalten.

Mapping

Im Editor

Im Editor wählen Sie das gewünschte Mapping. Über öffnen Sie den Mapping-Editor und können das Mapping bearbeiten und neue Mappings anlegen.

Als Expression

Wenn Sie diesen Parameter als Expression angeben, geben Sie den vollständigen Pfad zur Variable an, in der das zu verwendende Mapping hinterlegt ist.

token.variables.mappingDefinition

Datenvariable

Die nachfolgenden Beispiele gelten ebenfalls für eine Ausgangsvariable.

Für generelle Schreibweise von Variablen im Editor oder als Expression siehe Schreibweise von Variablen.

Im Editor

Im Editor geben Sie den Namen der Workflow-Variable an. Das System platziert die Variable automatisch in der Variable des Tokens (token.variables).

dataVariable

Als Expression

Wenn Sie diesen Parameter als Expression angeben, geben Sie den vollständigen Pfad zur Variable an, von der das System den eigentlichen Namen der gewünschten Variable lesen soll.

'token.variables.nameOfDataVariable'