1. Store
  2. Basis
  3. DatastoreWriter
DatastoreWriter Step

DatastoreWriter

Importiert Daten eines Spreadsheets in einen Datatstore.

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: SpreadsheetDatastoreWriter

Inputs

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

Name Datentyp Beschreibung Pflichtfeld Werte
input SPREADSHEET Quell-Spreadsheet mit den zu importierenden Daten. Ja
datastoreName DATASTORE Name des Ziel-Datastores. Wenn der Datastore noch nicht existiert, wird dieser zusammen mit einem Schema neu erstellt. Das Schema erhält automatisch die Spalten des Quell-Spreadsheets. Ja
mappingdefinition STRING Optional: Die Konfiguration des Mappings. Achtung: Wenn Sie eine Mapping-Definition konfigurieren, dann wird dieses Mapping für den Import genutzt, und nicht die Spalten des Quell-Spreadsheets. D.h. wenn Sie im Mapping z.B. Spalten entfernen, dann werden diese auch nicht importiert. Nein
identifierColumn STRING Spaltenname im Quell-Spreadsheet, in der der eindeutige identifier des Datensatzes steht. Wenn leer (Standard) dann wird automatisch im Quell-Spreadsheet oder in der Mapping-Definition nach einer Spalte 'identifier' geschaut. Nein
folderColumn STRING Spaltenname im Quell-Spreadsheet, in der der Folder des Datensatzes steht. Wenn leer, dann wird der folder 'default' verwendet. Nein
identifier2Column STRING Spaltenname im Quell-Spreadsheet, in der ein optionaler (und nicht-eindeutiger) 'identifier2' des Datensatzes steht. Wenn leer (Standard) dann wird automatisch im Quell-Spreadsheet oder in der Mapping-Definition nach einer Spalte 'identifier2' geschaut. Nein
identifier3Column STRING Spaltenname im Quell-Spreadsheet, in der ein optionaler (und nicht-eindeutiger) 'identifier3' des Datensatzes steht. Wenn leer (Standard) dann wird automatisch im Quell-Spreadsheet oder in der Mapping-Definition nach einer Spalte 'identifier3' geschaut. Nein
parentIdentifierColumn STRING Optional: Spaltenname im Quell-Spreadsheet, in welcher der 'identifier' des Parent-Datensatzes steht. Wird benötigt, wenn man in einen Parent-Variant-Datastore importiert. Wenn leer (Standard) dann wird automatisch im Quell-Spreadsheet oder in der Mapping-Definition nach einer Spalte 'parent_identifier' geschaut. Nein
masterIdentifierColumn STRING Optional: Spaltenname im Quell-Spreadsheet, in welcher der 'identifier' des Master-Datensatzes steht. Wird benötigt, wenn man in einen Child-Datastore importiert. Wenn leer (Standard) dann wird automatisch im Quell-Spreadsheet oder in der Mapping-Definition nach einer Spalte 'master_identifier' geschaut. Nein
masterFolderColumn STRING Optional: Spaltenname im Quell-Spreadsheet, in welcher der folder des Master-Datensatzes steht. Wenn leer, dann wird der folder 'default' verwendet. Wird benötigt, wenn man in einen Child-Datastore importiert. Wenn leer (Standard) dann wird automatisch im Quell-Spreadsheet oder in der Mapping-Definition nach einer Spalte 'master_folder' geschaut. Nein
nameColumn STRING Optional: Spaltenname im Quell-Spreadsheet, in der der Anzeige-Name des Datensatzes steht. Dies wird nur für Anzeigezwecke im Backend verwendet. Der Wert wird in die 'name'-Spalte des Datastores geschrieben (sofern vorhanden). Wenn leer (Standard) dann wird automatisch im Quell-Spreadsheet oder in der Mapping-Definition nach einer Spalte 'name' geschaut. Nein
mode STRING Mit dem Import-Modus kann man steuern, ob man anlegen (Insert), aktualisieren (Update) oder beides (INSERTUPDATE) will. Datenzeilen werden je nach Einstellung übersprungen (SKIPPED) (z.B. bei 'nur anlegen' werden existierende Datensätze im Datastore nicht angefasst und übersprungen.) Standard ist: beides - anlegen und aktualisieren (INSERTUPDATE). Nein
  • Anlegen & aktualisieren (Standardwert)
  • Nur anlegen
  • Nur aktualisieren
tagMode STRING Der Tag Import Modus legt fest, ob Sie gesetzte Tags beibehalten, neue Tags einfügen, nicht verwendete Tags entfernen oder neue Tags einfügen und nicht verwendete Tags entfernen wollen. Nein
  • - Lassen wie es gerade ist - (Standardwert)
  • Anhängen
  • Ersetzen
  • Ersetzen wenn nicht leer
updateProcessingStatus STRING Resettet den processing status der betroffenen Datensätze auf den gesetzten Wert. Standard ist: - Lassen wie es gerade ist oder UNPROCESSED- Nein
  • - Lassen wie es gerade ist oder UNPROCESSED -
  • UNPROCESSED
  • INPROCESS
  • PROCESSED_SUCCESS
  • PROCESSED_ERROR
  • PROCESSED_MARK_DELETE
autoExtendSchema STRING Aktiviert - Neue Spalten im Quell-Spreadsheet werden automatisch dem Datastore-Schema hinzugefügt. (Bitte mit Bedacht verwenden!). Deaktiviert (Standard) - Das Datastore-Schema bleibt unangetastet, auch wenn das Quell-Spreadsheet neue Spalten beinhaltet. Nein
  • Deaktiviert
  • Aktiviert - Automatische Schema-Eweiterung
untouchedRecordsMode STRING Legt fest, ob und wie unangetastete Datensätze berechnet werden. Unberührte Datensätze sind Datensätze, die sich im Datenspeicher befinden, aber nicht in der Eingabetabelle enthalten waren. Ein typischer Anwendungsfall ist z. B. die Ermittlung von Datensätzen, die gestern importiert wurden, aber in der heutigen Importdatei fehlen. Nein
  • Deaktiviert (Standard) (Standardwert)
    Keine Berechnung von unangetasteten Datensätzen. Dies ist besser für die Leistung, wenn unangetasteten Datensätze nicht verwendet werden.
  • Alle Folder
    Das Spreadsheet "Untouched Records" enthält alle nicht unangetasteten Datensätze des Datastores.
  • Nur 'betroffene' Folder
    Das Spreadsheet "Untouched Records" enthält nur Datensätze der betroffenen Ordner, die von importierten Objekten 'berührt' wurden.
blockingMode STRING Experimentell: Verschiedene Optionen zum Testen, die Einfluss auf die Importgeschwindigkeit von einfachen Importen in einen Datastore haben. (z.B. Import ohne Parent/Variant bzw. Master/Child Beziehungen) Nein
  • Standard (blockierend, Langsamer) (Standardwert)
  • Schneller (Nicht-blockierend)

Outputs

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

Name Datentyp Beschreibung
insertResultMessages STRINGLIST Eine Liste von Nachrichten mit den Ergebnissen des Imports.
newAndUpdatedRecords SPREADSHEET Ein SPREADSHEET welches neue und aktualisierte (in dieser Reihenfolge) Datensätze enthält.
Folgende Felder sind im Output enthalten:

Feld Beschreibung Datentyp Pflichtfeld Standardwert
datastorename Text
folder Text
identifier Text
identifier2 Text
identifier3 Text
datastoretags Liste (Trennzeichen ; )
parent_identifier Text
master_folder Text
master_identifier Text
newRecords SPREADSHEET Ein SPREADSHEET welches nur neue Datensätze enthält.
Folgende Felder sind im Output enthalten:

Feld Beschreibung Datentyp Pflichtfeld Standardwert
datastorename Text
folder Text
identifier Text
identifier2 Text
identifier3 Text
datastoretags Liste (Trennzeichen ; )
parent_identifier Text
master_folder Text
master_identifier Text
updatedRecords SPREADSHEET Ein SPREADSHEET mit aktualiserten (angefassten) Datensätzen (egal ob inhaltlich geändert oder nicht).
Folgende Felder sind im Output enthalten:

Feld Beschreibung Datentyp Pflichtfeld Standardwert
datastorename Text
folder Text
identifier Text
identifier2 Text
identifier3 Text
datastoretags Liste (Trennzeichen ; )
parent_identifier Text
master_folder Text
master_identifier Text
updatedRecordsWithChangedContent SPREADSHEET Ein SPREADSHEET mit Datensätzen, bei denen mindestens ein Feld 'inhaltlich' geändert wurde. (Hinweis: Funktioniert nicht in der Step-Vorschau, sondern nur bei einer echten Flow-Ausführung)
Folgende Felder sind im Output enthalten:

Feld Beschreibung Datentyp Pflichtfeld Standardwert
datastorename Text
folder Text
identifier Text
identifier2 Text
identifier3 Text
datastoretags Liste (Trennzeichen ; )
parent_identifier Text
master_folder Text
master_identifier Text
untouchedRecords SPREADSHEET Ein SPREADSHEET mit 'nicht angefassten' Datensätzen.
Folgende Felder sind im Output enthalten:

Feld Beschreibung Datentyp Pflichtfeld Standardwert
datastorename Text
folder Text
identifier Text
identifier2 Text
identifier3 Text
datastoretags Liste (Trennzeichen ; )
parent_identifier Text
master_folder Text
master_identifier Text
errors SPREADSHEET Ein SPREADSHEET mit Import-Fehlern.
numRecordsInsert NUMBER Anzahl neu angelegter Datensätze.
numRecordsUpdate NUMBER Anzahl aktualisierter (im Sinne von 'angefasster') Datensätze (egal ob inhaltlich geändert oder nicht).
numRecordsUpdateWithChangedContent NUMBER Anzahl aktualisierter Datensätze, bei denen mindestens ein Feld 'inhaltlich' geändert wurde. (Hinweis: Funktioniert nicht in der Step-Vorschau, sondern nur bei einer echten Flow-Ausführung)
numRecordsInsertUpdate NUMBER Gesamtanzahl angelegter und aktualisierter Datensätze.
numRecordsUntouched NUMBER Anzahl 'nicht-angefasster' Datensätze. Das sind Datensätze, die im Datastore existieren, aber nicht im Quell-Spreadsheet.
numRecordsSkipped NUMBER Anzahl Datensätze, die 'übersprungen' wurden (abhängig vom Import-Modus). z.B. für 'Nur anlegen' werden Datensätze übersprungen, die bereits existieren und aktualisiert werden würden.

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

DatastoreWriter wird oft in Verbindung mit folgenden Steps verwendet:

Name Version Beschreibung Anwendungsfall
SearchDatastore Step SearchDatastore
SearchDatastore
- Erlaubt die Suche in einem Datastore mit der Rückgabe von Daten als SPREADSHEET.
Reports / Auswertungen abrufen / auslesen
Mapper Step Mapper
Mapper
- Wandelt ein Spreadsheet in ein anderes um.
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).
UrlDownload Step UrlDownload
UrlDownload
- Dieser Step greift auf eine URL zu und läd den Inhalt herunter. Das Ergebnis ist ein Wer von Typ String.
HTTP-Requests ausführen (Daten abrufen) , HTTP-Requests ausführen (Daten senden)
PlentyAddOrders Step PlentyAddOrders (ext. Version: REST 1.0 )
PlentyAddOrders (ext. Version: REST 1.0 )
REST 1.0 Dieser Step ermöglicht es Bestellungen in einen plentymarkets Shop zu importieren und Zahlungen zu erstellen oder vorhandene Zahlungen mit Bestellungen zu verknüpfen.
Bestellungen bzw. Auftragsdaten übertragen oder aktualisieren
StopFlowIf Step StopFlowIf
StopFlowIf
- Stoppt den Flow, wenn eine Bedingung wahr (TRUE) ist.
FTPSingleFileDownload Step FTPSingleFileDownload
FTPSingleFileDownload
- Dieser Step lädt eine einzelne Datei von FTP herunter. Derzeit können Sie einen Dateinamen Präfix und Suffix angeben, um nach den Dateien zu filtern, die Sie herunterladen möchten. Wenn es mehrere Dateien gibt, die den Kriterien entsprechen, wird nur die erste genommen. Die Dateien werden nach absteigendem Änderungsdatum auf FTP geordnet, so dass die neueste Datei aus einer Liste entfernt wird.
Dateien empfangen oder herunterladen
FlowTrigger Step FlowTrigger
FlowTrigger
- Ein Step, welcher einen Flow in einem separaten Run starten (triggern) kann. Flow-Variablen können durch den Aufrufer überschrieben werden.

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