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 oder eine einmalige Daten-Migration.

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 oder eine einmalige Daten-Migration.

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 (ext. Version: 2.0)
CSVWriter (ext. Version: 2.0)
2.0 Kann ein SPREADSHEET in eine CSV-Datei schreiben.
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 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)
CSVWriter Step CSVWriter (ext. Version: 2.0)
CSVWriter (ext. Version: 2.0)
2.0 Kann ein SPREADSHEET in eine CSV-Datei schreiben.
CSV Daten
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").

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.
KeyValueSpreadsheet Step KeyValueSpreadsheet
KeyValueSpreadsheet
- Konvertiert ein SPREADSHEET in ein Special Spreadsheet, das als Key-Value-Map verwendet werden kann.
CSVWriter Step CSVWriter (ext. Version: 2.0)
CSVWriter (ext. Version: 2.0)
2.0 Kann ein SPREADSHEET in eine CSV-Datei schreiben.
CSV Daten
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.
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.
DatastoreBackup Step DatastoreBackup (ext. Version: 2.0)
DatastoreBackup (ext. Version: 2.0)
2.0 Erstellt ein Backup von einem Datastore als ZIP-Datei. (Datastore-Schema, Datastore-Definition und Datastore-Daten als CSV-Datei).
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 , XML Daten , JSON Daten , Nachrichten , Reports / Auswertungen
WorkspaceBackup Step WorkspaceBackup
WorkspaceBackup
- Erstellt eine Sicherung eines Workspace als ZIP-Datei. (Projekte, Flows, Datastore-Schemas).
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
FlowList Step FlowList (ext. Version: 2.0)
FlowList (ext. Version: 2.0)
2.0 Listet alle Flows des aktuellen Workspace auf. Es kann zur Analyse und Überwachung der Flow-Konfigurationen genutzt werden.
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.
CSV Daten abrufen / auslesen
AccountBackup Step AccountBackup (ext. Version: 2.0)
AccountBackup (ext. Version: 2.0)
2.0 Erstellt ein Backup Ihres Kundenaccounts als ZIP-Datei.(Projects, Flows, Datastore-schemas, Mappingsets, Workspaces).
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