Mapper

Wandelt ein Spreadsheet in ein anderes um.

Ü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

Passende Vorlagen

Wird oft in Verbindung mit folgenden Add-Ons verwendet:

Über Synesty Studio für Basis

Zum Add-On

Passende Vorlagen

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 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 DatastoreWriter	-	Importiert Daten eines Spreadsheets in einen Datatstore.
CSVWriter CSVWriter	-	(Veraltet: Bitte v2.0 benutzen) Kann ein SPREADSHEET in eine CSV-Datei schreiben.	Dateien , CSV Daten
SpreadsheetAppend SpreadsheetAppend	-	Fügt mehrere Spreadsheets zusammen.
ExcelWriter ExcelWriter	-	Kann ein SPREADSHEET in eine Excel-Datei schreiben.	Dateien
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 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 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 StopFlowIf	-	Stoppt den Flow, wenn eine Bedingung wahr (TRUE) ist.
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 ExcelWriter	-	Kann ein SPREADSHEET in eine Excel-Datei schreiben.	Dateien
ColumnRenamer ColumnRenamer	-	Umbennen von Spalten in einem SPREADSHEET.
CSVWriter (ext. Version: 2.0) CSVWriter (ext. Version: 2.0)	2.0	Kann ein SPREADSHEET in eine CSV-Datei schreiben.	CSV Daten
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 AccountBackup	-	Erstellt ein Backup Ihres Kundenaccounts als ZIP-Datei.(Projects, Flows, Datastore-schemas, Mappingsets, Workspaces).
CSVWriter CSVWriter	-	(Veraltet: Bitte v2.0 benutzen) Kann ein SPREADSHEET in eine CSV-Datei schreiben.	Dateien , CSV Daten
ExcelSheetUpdate ExcelSheetUpdate	-	Kann Daten eines Tabellenblattes einer Excel-Datei aktualiseren, erweitern (anhängen) oder ein neues Tabellenblatt erzeugen.	Dateien
Mapper Mapper	-	Wandelt ein Spreadsheet in ein anderes um.
SearchDatastore SearchDatastore	-	Erlaubt die Suche in einem Datastore mit der Rückgabe von Daten als SPREADSHEET.	Reports / Auswertungen abrufen / auslesen
FlowList FlowList	-	Listet alle Flows des aktuellen Workspace auf. Es kann zur Analyse und Überwachung der Flow-Konfigurationen genutzt werden.
StopFlowIf StopFlowIf	-	Stoppt den Flow, wenn eine Bedingung wahr (TRUE) ist.
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 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 SpreadsheetAppend	-	Fügt mehrere Spreadsheets zusammen.
ColumnRemover ColumnRemover	-	Kann Spalten aus einem SPREADSHEET entfernen. Unterstützt Include/Exclude-Modus, statische und dynamische Spaltenfilter.
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 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 DatastoreWriter	-	Importiert Daten eines Spreadsheets in einen Datatstore.
MultiColumnFunction MultiColumnFunction	-	Wendet eine Funktion auf mehrere Spalten eines SPREADSHEET an. Unterstützt Include/Exclude-Modus, statische und dynamische Spaltenfilter.
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 (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
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 HTMLWriter	-	Wandelt ein Spreadsheet in eine einfache HTML-Tabelle um.
DatastoreBackup DatastoreBackup	-	Erstellt ein Backup von einem Datastore als ZIP-Datei. (Datastore-Schema, Datastore-Definition und Datastore-Daten als CSV-Datei).	Dateien
SearchInDatastoreByIdentifiers SearchInDatastoreByIdentifiers	-	Sucht Datensätze in einem Datastore mit einem SPREADSHEET, das einen identifier (1-3) enthält.	Datensätze abrufen / auslesen
ExcelReader ExcelReader	-	Liest eine Excel Datei (.xls oder .xlsx) in ein SPREADSHEET.	Dateien