Mapper Step Mapper


Wandelt ein Spreadsheet in ein anderes um.

Dokumentation im Handbuch aufrufen

Über Synesty Studio für Basis

Mit Synesty als No Code Middleware verbinden Sie Basis mit anderen Schnittstellen, APIs und Systemen ohne Programmierung per Drag&Drop. Automatisieren Sie Geschäftsprozesse und Integrationen wie EDI Datenimport / Export.

Wir unterstützen Datenformate wie CSV, Excel (XLS/XLSX), XML oder JSON und ermöglichen auch HTTP-Konnektoren zu REST- oder GraphQL-APIs. Kunden nutzen es auch für Auswertungen, ETL-Aufgaben oder Feed-Optimierung.
Unser No Code Flow-Editor und unsere Low Code Scripting Tools ermöglichen kreative Anpassungen für jede Art von Integration.

Zum Add-On

Wird oft in Verbindung mit folgenden Add-Ons verwendet:

Über Synesty Studio für Basis

Mit Synesty als No Code Middleware verbinden Sie Basis mit anderen Schnittstellen, APIs und Systemen ohne Programmierung per Drag&Drop. Automatisieren Sie Geschäftsprozesse und Integrationen wie EDI Datenimport / Export.

Wir unterstützen Datenformate wie CSV, Excel (XLS/XLSX), XML oder JSON und ermöglichen auch HTTP-Konnektoren zu REST- oder GraphQL-APIs. Kunden nutzen es auch für Auswertungen, ETL-Aufgaben oder Feed-Optimierung.
Unser No Code Flow-Editor und unsere Low Code Scripting Tools ermöglichen kreative Anpassungen für jede Art von Integration.

Zum Add-On

Wird oft in Verbindung mit folgenden Add-Ons verwendet:

Dieser Step wurde umbenannt. Vorheriger Name: SpreadsheetMapper

Inputs

Das sind die Optionen, mit denen man den Step konfigurieren kann.

Name Datentyp Beschreibung Pflichtfeld Werte
source SPREADSHEET Das zu mappende Quell-Spreadsheet. Ja
mappingdefinition STRING Die Mapping-Definition enthält die Konfiguration aller Ergebnis-Spalten. Nein
targetSchemaName STRING Optional: Name eines Schemas mit initialen Ziel-Spalten. Wenn gefüllt, dann wird das Mapping beim ersten Laden der Konfiguration mit den Spalten dieses Schemas gefüllt. Es kann nur ausgewählt werden, wenn noch nicht auf 'Konfigurieren' geklickt wurde. Später kann man 'Schema laden' in der Konfigurationsansicht nutzen, um ein anderes Schema zu laden. Nein
disableWarnings STRINGLIST Optional um verschiedene Warnungen zu deaktivieren. Nein
  • Unterdrücke Warnung für 'ungemappte Werte' in Mappingsets.
  • Unterdrücke Verarbeitungsfehler (z.B. Syntax Fehler, fehlende Quellspalten usw.)
mappingMode STRING Der Mapping-Modus, der bestimmt, wie das Mapping auf das Quell-Spreadsheet angewendet wird. Default - Nur die Spalten in der Mapping-Definition sind auch in der Ausgabe (WYSIWYG). 'Pass-through unmapped source columns' bedeutet, dass Spalten des Quell-Spreadsheets mit durchgereicht werden. D.h. dass das Ergebnis-Spreadsheet alle Spalten des Quell-Spreadsheet + Spalten aus der Mapping-Definition beinhaltet. Nein
  • Standard - Ausgabe nur gemappter Spalten
  • Ungemappte Spalten werden durchgereicht (gemappte Spalten ersetzen Quellspalten, neue Spalten erscheinen am Ende).
  • Ungemappte Spalten werden durchgereicht, aber gemappte Spalten erscheinen zuerst (gemappte Spalten ersetzen Quellspalten, neue Spalten erscheinen zuerst).
cacheMode STRING Ja, um Caching zu aktivieren. Das kann langsame Verarbeitung bei Verwendung des SpreadsheetMapper beschleunigen, wenn das Ergebnis-Spreadsheet von min. zwei weiteren Steps verarbeitet wird. (Hinweis: Der Zugriff von Varianten-Zeilen auf Parent-Zeilen funktioniert, aber der Zugriff von Child-Zeilen auf Master-Zeilen funktioniert nicht. D.h. man kann ${parent['columnname']} benutzen, jedoch nicht ${master['columnname']}.) Nein
  • Ja
  • Nein (Standardwert)

Outputs

Das sind die Ergebnisse des Steps, die von nachfolgenden Steps, nach der Ausführung verwendet werden können.

Name Datentyp Beschreibung
spreadsheet SPREADSHEET Das Ergebnis-Spreadsheet mit dem Ergebnis der Umwandlung. Hinweis: Dieses Spreadsheet ist 'lazy'. D.h. dieses Spreadsheet wird erst gefüllt, wenn ein späterer Step des eigentliche Ergebnis-Spreadsheet dieses Steps verarbeitet. (z.B. wenn Sie einen eine CSV-Datei mit dem SpreadsheetCSVWriter schreiben).
unmappedValues SPREADSHEET Ein SPREADSHEET mit Informationen zu ungemappten Werten von Spalten, welche auf Mappingsets zugreifen. Sie können diese Liste benutzen, um daraufhin die Mappingsets manuell zu verfolgständigen. Dieses Spreadsheet ist auf max. 1000 Zeilen pro Spalte mit ungemappten Werten begrenzt. Der ungemappte Wert wird aus Performancegründen nach 100 Zeichen abgeschnitten.
errors SPREADSHEET Ein Spreadsheet, welches nur beim Mapping aufgetretene Fehler beinhaltet (hilfreich zum Debugging). Sie können es benutzen, um z.B. eine CSV-Datei von Mapping-Fehlern zu erstellen. Hinweis: Dieses Spreadsheet ist 'lazy'. D.h. dieses Spreadsheet wird erst gefüllt, wenn ein späterer Step des eigentliche Ergebnis-Spreadsheet dieses Steps verarbeitet. (z.B. wenn Sie einen eine CSV-Datei mit dem SpreadsheetCSVWriter schreiben).

Hilfe oder Projektsupport gewünscht?

Wenn Sie Hilfe bei der Einrichtung dieses Steps benötigen oder ein Projekt umsetzen wollen, dann unterstützen Sie unsere verifizierten Partner. Partner finden

Mapper wird oft in Verbindung mit folgenden Steps verwendet:

Name Version Beschreibung Anwendungsfall
Filter Step
Filter
Filter
- Kann ein Spreadheet nach einem bestimmten Ausdruck in der Freemarker-Syntax filtern und gibt nur Zeilen zurück, die der Filterbedingung entsprechen. Es wird auch ein zweites SPREADSHEET ausgegeben, das das negative Ergebnis enthält (Zeilen, die nicht der Filterbedingung entsprechen).
DatastoreWriter Step
DatastoreWriter
DatastoreWriter
- Importiert Daten eines Spreadsheets in einen Datatstore.
CSVWriter Step
CSVWriter
CSVWriter
- (Veraltet: Bitte v2.0 benutzen) Kann ein SPREADSHEET in eine CSV-Datei schreiben.
Dateien , CSV Daten
SpreadsheetAppend Step
SpreadsheetAppend
SpreadsheetAppend
- Fügt mehrere Spreadsheets zusammen.
ExcelWriter Step
ExcelWriter
ExcelWriter
- Kann ein SPREADSHEET in eine Excel-Datei schreiben.
Dateien
SpreadsheetUrlDownload Step
SpreadsheetUrlDownload
SpreadsheetUrlDownload
- Dieser Step kann mehrere HTTP Calls basierend auf einem SPREADSHEET oder einer SPREADSHEETLIST ausführen. Sie können den Step benutzen, um verschiedene Arten von Webservices/APIs zu verbinden. Einfache Calls und Stapel-Verarbeitung mehrerer Zeilen wird unterstützt.
HTTP-Requests ausführen (Daten abrufen) , HTTP-Requests ausführen (Daten senden)
ColumnSplitToRows Step
ColumnSplitToRows
ColumnSplitToRows
- Splitten Sie eine Spalte durch Trennzeichen und erstellen Sie neue Zeilen für jeden gesplitteten Wert (z.B. erstellen Sie 3 neue Zeilen aus der Spalte mit "rot, grün, blau").
TextHTMLWriter Step
TextHTMLWriter
TextHTMLWriter
- Dieser Step erzeugt einen Text (STRING). Sie können damit HTML, Klartext, XML und andere textuelle Ausgabeformate erstellen. Sie können Freemarker verwenden, um die Ausgabe dynamisch zu generieren (siehe Freemarker Manual). Die Template-Sprache ermöglicht es Ihnen, die Ausgaben vorheriger Steps zur Erzeugung einer dynamischeren Ausgabe zu verwenden.
Dateien senden oder hochladen , XML Daten erstellen bzw. setzen / aktualisieren , JSON Daten erstellen bzw. setzen / aktualisieren , Nachrichten senden , Reports / Auswertungen erstellen bzw. setzen / aktualisieren
StopFlowIf Step
StopFlowIf
StopFlowIf
- Stoppt den Flow, wenn eine Bedingung wahr (TRUE) ist.
KeyValueSpreadsheet Step
KeyValueSpreadsheet
KeyValueSpreadsheet
- Konvertiert ein SPREADSHEET in ein Special Spreadsheet, das als Key-Value-Map verwendet werden kann.

Weitere Steps in Basis


Name Version Beschreibung Anwendungsfall
ExcelWriter Step
ExcelWriter
ExcelWriter
- Kann ein SPREADSHEET in eine Excel-Datei schreiben.
Dateien
ColumnRenamer Step
ColumnRenamer
ColumnRenamer
- Umbennen von Spalten in einem SPREADSHEET.
CSVWriter Step
CSVWriter (ext. Version: 2.0)
CSVWriter (ext. Version: 2.0)
2.0 Kann ein SPREADSHEET in eine CSV-Datei schreiben.
LookupFilter Step
LookupFilter
LookupFilter
- Filtert ein SPREADSHEET gegen einen Datastore und gibt nur die Zeilen zurück, die im Datastore existieren bzw. nicht existieren. Das kann man z.B. nach einem Mapper nutzen, um nach neuen oder bereits im Datastore existierenden Produkten zu filtern.
AccountBackup Step
AccountBackup
AccountBackup
- Erstellt ein Backup Ihres Kundenaccounts als ZIP-Datei.(Projects, Flows, Datastore-schemas, Mappingsets, Workspaces).
CSVWriter Step
CSVWriter
CSVWriter
- (Veraltet: Bitte v2.0 benutzen) Kann ein SPREADSHEET in eine CSV-Datei schreiben.
Dateien , CSV Daten
ExcelSheetUpdate Step
ExcelSheetUpdate
ExcelSheetUpdate
- Kann Daten eines Tabellenblattes einer Excel-Datei aktualiseren, erweitern (anhängen) oder ein neues Tabellenblatt erzeugen.
Dateien
Mapper Step
Mapper
Mapper
- Wandelt ein Spreadsheet in ein anderes um.
SearchDatastore Step
SearchDatastore
SearchDatastore
- Erlaubt die Suche in einem Datastore mit der Rückgabe von Daten als SPREADSHEET.
Reports / Auswertungen abrufen / auslesen
FlowList Step
FlowList
FlowList
- Listet alle Flows des aktuellen Workspace auf. Es kann zur Analyse und Überwachung der Flow-Konfigurationen genutzt werden.
StopFlowIf Step
StopFlowIf
StopFlowIf
- Stoppt den Flow, wenn eine Bedingung wahr (TRUE) ist.
CSVReader Step
CSVReader
CSVReader
- (Veraltet: Bitte v2.0 benutzen) Kann eine einzelne Datei oder eine Liste von CSV/XLS-Dateien in ein Spreadsheet-Objekt zur weiteren Verarbeitung einlesen. Mehrere Dateien mit den gleichen Headern werden zu einer einzigen Spreadsheet zusammengeführt. Der Header des Ergebnisses wird immer aus der ersten Datei übernommen.
Dateien , CSV Daten
Filter Step
Filter
Filter
- Kann ein Spreadheet nach einem bestimmten Ausdruck in der Freemarker-Syntax filtern und gibt nur Zeilen zurück, die der Filterbedingung entsprechen. Es wird auch ein zweites SPREADSHEET ausgegeben, das das negative Ergebnis enthält (Zeilen, die nicht der Filterbedingung entsprechen).
SpreadsheetAppend Step
SpreadsheetAppend
SpreadsheetAppend
- Fügt mehrere Spreadsheets zusammen.
ColumnRemover Step
ColumnRemover
ColumnRemover
- Kann Spalten aus einem SPREADSHEET entfernen. Unterstützt Include/Exclude-Modus, statische und dynamische Spaltenfilter.
FileLineFilter Step
FileLineFilter
FileLineFilter
- Filtern einer FILE Zeile für Zeile und Ausgabe einer neuen FILE, die nur Zeilen enthält, die dem Filter RegEx (regulärer Ausdruck) entsprechen.
TextHTMLWriter Step
TextHTMLWriter
TextHTMLWriter
- Dieser Step erzeugt einen Text (STRING). Sie können damit HTML, Klartext, XML und andere textuelle Ausgabeformate erstellen. Sie können Freemarker verwenden, um die Ausgabe dynamisch zu generieren (siehe Freemarker Manual). Die Template-Sprache ermöglicht es Ihnen, die Ausgaben vorheriger Steps zur Erzeugung einer dynamischeren Ausgabe zu verwenden.
Dateien senden oder hochladen , XML Daten erstellen bzw. setzen / aktualisieren , JSON Daten erstellen bzw. setzen / aktualisieren , Nachrichten senden , Reports / Auswertungen erstellen bzw. setzen / aktualisieren
DatastoreWriter Step
DatastoreWriter
DatastoreWriter
- Importiert Daten eines Spreadsheets in einen Datatstore.
MultiColumnFunction Step
MultiColumnFunction
MultiColumnFunction
- Wendet eine Funktion auf mehrere Spalten eines SPREADSHEET an. Unterstützt Include/Exclude-Modus, statische und dynamische Spaltenfilter.
StringToFile Step
StringToFile
StringToFile
- Dieser Step erhält einen String als Eingabe und konvertiert ihn in eine temporäre Datei mit einem zufälligen Namen. Ein anderer Step kann verwendet werden, um diese Datei in etwas Bestimmtes umzubenennen.
Dateien senden oder hochladen
CSVReader Step
CSVReader (ext. Version: 2.0)
CSVReader (ext. Version: 2.0)
2.0 Kann eine einzelne Datei oder eine Liste von CSV-Dateien in ein Spreadsheet-Objekt zur weiteren Verarbeitung einlesen. Mehrere Dateien mit den gleichen Headern werden zu einer einzigen Spreadsheet zusammengeführt. Der Header des Ergebnisses wird immer aus der ersten Datei übernommen.
MultiColumnSplitToRows Step
MultiColumnSplitToRows
MultiColumnSplitToRows
- Splittet eine Spalte anhand eines Trenners und erstellt neue Zeilen. Jede Spalte wird mit dem Wert an der Split-Position gefüllt (z. B. wird eine Zeile mit "color=red,green,blue" und "size=S,M,L" zu 3 Zeilen. [{Farbe=rot, Größe=S}, {Farbe=grün, Größe=M}, {Farbe=blau, Größe=L}).
HTMLWriter Step
HTMLWriter
HTMLWriter
- Wandelt ein Spreadsheet in eine einfache HTML-Tabelle um.
DatastoreBackup Step
DatastoreBackup
DatastoreBackup
- Erstellt ein Backup von einem Datastore als ZIP-Datei. (Datastore-Schema, Datastore-Definition und Datastore-Daten als CSV-Datei).
Dateien
SearchInDatastoreByIdentifiers Step
SearchInDatastoreByIdentifiers
SearchInDatastoreByIdentifiers
- Sucht Datensätze in einem Datastore mit einem SPREADSHEET, das einen identifier (1-3) enthält.
Datensätze abrufen / auslesen
ExcelReader Step
ExcelReader
ExcelReader
- Liest eine Excel Datei (.xls oder .xlsx) in ein SPREADSHEET.
Dateien