Skip to content

CSVWriter - Basis

Version: 2.0

← Basis Add-On Übersicht

Der CSVWriter ist das Pendant zum CSVReader. Damit kann man aus einem Spreadsheet eine CSV- oder TXT-Datei erzeugen. 

Dabei kann man einstellen wie genau die Datei eingelesen werden soll. Das betrifft typische Einstellungen wie:

  • Spaltentrenner (z.B. Komma, Semikolon, Tabulator)
  • Textqualifier (in der Regel doppelte Anführungszeichen, die jeden Spaltenwert umschließen)
  • Encoding: Spielt immer dann eine Rolle wenn Umlaute nicht korrekt dargestellt werden (z.B. UTF-8 oder ISO-8859-1)
  • Dateiname

Die einzelnen Inputs, Outputs und Konfigurationsoptionen dieses Steps werden weiter unten erklärt.

 

Anwendungsbeispiel

Der SpreadsheetCSV findet sich häufiger nach einem Mapper, um eine CSV-Datei aus einem zuvor bearbeiteten Spreadsheet zu erzeugen. 

Die so erzeugte Datei kann anschließend z.B. mit einem FTPUpload auf einen FTP-Server hochgeladen werden. 

Automatisch Zeilenumbrüche entfernen

Die Option trimMode kann man automatisch Zeilenumbrüche oder Leerzeichen in allen Spalten entfernen.


Inputs

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

NameDatentypBeschreibungPflichtfeldWerte
inputSPREADSHEETLISTSpreadsheet mit den Daten.Ja
filenameSTRINGDer Dateiname der Ausgabe.Nein
delimiterSTRINGDas Trennzeichen der Ergebnisdatei (Standard: ';' (Semikolon)).Ja
  • ;
  • ,
  • |
  • Tabulator
  • Leerzeichen
  • Kleiner Als Zeichen
  • Größer Als Zeichen
encodingSTRINGDie Kodierung der Ergebnisdatei (Standard: UTF-8).Ja
  • UTF-8
  • UTF-16
  • ISO-8859-1
  • ISO-8859-2
  • ISO-8859-4
  • ISO-8859-5
  • ISO-8859-15
  • cp1252 (Windows-1252, ANSI)
  • MacCentralEurope
  • US-ASCII
  • KOI8-R
textqualifierSTRINGDer Qualifier, in den alle Spalten eingepackt sind. (Standard: " (doppelte Anführungszeichen))Ja
  • "
  • '
  • |
  • Keine
trimModeSTRINGOptional: Wählen Sie, wie jede Spalte automatisch getrimmt werden soll, z.B. durch Entfernen von Leerzeichen und Zeilenumbrüchen. Standard: kein Trimmen.Nein
  • -- Kein Trimmen --
  • Leerzeichen an beiden Enden, aber Zeilenumbrüche behalten.
  • Trim Leerzeichen von beiden Enden und ersetzen der Zeilenumbrüche durch Leerzeichen.
  • Trim Leerzeichen von beiden Enden und Entfernen von leeren Zeilen.
  • Trim Leerzeichen von beiden Enden und Entfernen von Zeilenumbrüchen
  • Jede Zeile trimmen, dann verbinden. Das Ergebnis ist eine einzeilige Zeichenkette.
targetLineendSTRINGDas plattformspezifische Zeilenendezeichen (WINDOWS, UNIX).Nein
  • Windows CRLF
  • UNIX LF
limitRecordsSTRINGBegrenzt die Anzahl der Datensätze, die in die Ergebnisdatei geschrieben wurden (Header + Datensätze). (Hinweis zu Zeilenumbrüchen: wenn 1 Datensatz Zeilenumbrüche enthält, die dazu führen, dass mehrere Zeilen in die Datei geschrieben werden.)Nein
printHeaderSTRINGWenn ja, enthält die erste Zeile der CSV-Datei die Kopfzeile.Ja
  • Ja
  • Nein
removeColumnsSTRINGOptional: Geben Sie eine kommagetrennte Liste von Spalten an, die in der Ausgabe entfernt werden sollen.Nein
createEmptyFilesSTRINGWenn JA, wird die Datei leer sein (0 bytes), wenn das Spreadsheet keine Datenzeilen enthält. Wenn NEIN, dann enthält die Datei mindestens die Kopfzeile (nur wenn printHeader = Ja). Standard: JaNein
  • Ja, erlaubt die Erstellung von leeren Dateien.
  • Nein, Erstellung von leeren Dateien nicht erlauben.
modeSTRINGVerstecktes Feld, wenn die Ausgabe eine einzelne Datei oder mehrere Dateien ist.Ja
escapeCharacterSTRINGDas Zeichen, das für das Escapen von Textqualifizierern verwendet werden soll (Standard: " (double quote))Nein
  • "
  • \
  • [none]

Outputs

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

NameDatentypBeschreibungWerte
outputFILEThe written file.
outputNumWrittenRowsNUMBERAnzahl der geschriebenen Zeilen der Ausgabedatei.
outputFilesizeNUMBERGröße der Ausgabedatei in Bytes.