CSV-Datei erstellen oder erweitern

Interne ID: agorum.data.write.csv

Sie können mit diesem Knoten:

• eine CSV-Datei aus einem Array oder einer Objektstruktur erstellen
• eine bestehende CSV-Datei mit den Daten aus einem Array oder einer Objektstruktur erweitern

Aussehen des Knotens

Verhaltensweise

Die Verhaltensweise dieses Knotens variiert je nach vorhandenem Szenario und Anwendungsfall (CSV-Datei erstellen oder CSV-Datei erweitern).

CSV-Datei erstellen

Erreicht das System den Knoten im Workflow, prüft das System die gesetzten Parameter. Anschließend speichert das System die Informationen aus der Datenvariable unter Beachtung des angegebenen Zeichensatzes in eine CSV-Datei. Diese CSV-Datei legt das System in die Ausgangsvariable ab.

Wenn Sie Header-Daten übergeben oder die Option der automatischen Generierung aktiviert haben, erzeugt das System diese Daten automatisch und speichert sie als Header ab.

CSV-Datei erweitern

Erreicht das System den Knoten im Workflow, prüft das System die gesetzten Parameter. Anschließend liest das System die Informationen aus der bestehenden CSV-Datei aus und hängt den Inhalt aus der Datenvariable an das ausgelesene Ergebnis an. Die Ausgangsvariable enthält dann die erweiterte CSV-Datei.

Endpoints

Parameter

Colum 1, Colum 2, Colum 3 ...

Datenvariable

Die nachfolgenden Beispiele gelten ebenfalls für eine Ausgangsvariable und Eingangsvariable.

Für generelle Schreibweise von Variablen im Editor oder als Expression siehe Schreibweise von Variablen.

Parameter „Header automatisch generieren“ aktiviert

Das Array muss Objekte enthalten, wie folgendes Beispiel demonstriert:

[
  {
    "LastName" : "Reinhold",
    "FirstName" : "Herbst",
    "E-Mail" : "reinhold.herbst@muster.com",
    "Mobile" : "+49123456789",
    "Street" : "Musterweg 5",
    "PLZ" : "12345",
    "City" : "Musterstadt",
    "Country" : "Deutschland",
    "Telephone" : "0711123456789"
  }, 
  {
    "LastName" : "Fischer",
    "FirstName" : "Evelin",
    "E-Mail" : "evelin.fischer@muster.com",
    "Mobile" : "+49123456789",
    "Street" : "Musterstraße 5",
    "PLZ" : "12345",
    "City" : "Musterstadt",
    "Country" : "Deutschland",
    "Telephone" : "0711789996789"
  }, 
  {
    "LastName" : "Müller",
    "FirstName" : "Lisa",
    "E-Mail" : "lisa.mustermann@muster.com",
    "Mobile" : "+493333456789",
    "Street" : "Musterweg 5",
    "PLZ" : "54435",
    "City" : "Musterlingen",
    "Country" : "Deutschland",
    "Telephone" : "071117776789"
  }
]

Parameter „Header automatisch generieren“ deaktiviert

Das Array muss weitere Arrays enthalten, da sich die Zuordnung zum Header nur über ein Array herstellen lässt.

[  
   ['Max Mustermann', 'Musterstraße 1', 'Musterstadt'],
   [....]
]

Im Editor

Im Editor geben Sie den Namen der Workflow-Variable an, die das zu verwendende Array enthält. Das System platziert die Variable automatisch in der Variable des Tokens (token.variables).

dataVariable

Als Expression

Wenn Sie diesen Parameter als Expression angeben, geben Sie den vollständigen Pfad zur Variable an, von der das System den eigentlichen Namen der gewünschten Variable lesen soll.

'token.variables.nameOfDataVariable'

Header-Informationen

Im Editor

Im Editor tragen Sie die einzelnen Spaltennamen der Reihe nach ein.

Spalte 1
Spalte 2
Spalte 3
Spalte 4

Die eingetragenen Spaltennamen gibt das System in Form eines Arrays an den Knoten weiter.

Als Expression

Wenn Sie die Spaltennamen als Expression angeben, muss das Ergebnis ein Array sein. Das Array muss die Namen für die Spalten enthalten. Sie können sowohl feste Werte als auch Variablen des aktuellen Tokens verwenden.

["Column 1", "Column 2", "Column 3", "Column 4"]
token.variables.headerArray

Wenn Sie mehrere Kopfzeilen benötigen, geben Sie diese etwa wie folgt an:

[
["Row 1: Column 1", "Row 1: Column 2", "Row 1: Column 3", "Row 1: Column 4"],
["Zeile 2: Spalte 1", "Zeile 2: Spalte 2", "Zeile 2: Spalte 3", "Zeile 2: Spalte 4"]
]

Header automatisch generieren

Im Editor

Im Editor aktivieren oder deaktivieren Sie diese Funktion, indem Sie diese anhaken oder den Haken entfernen.

Im Standard ist diese Option deaktiviert.

Als Expression

Wenn Sie diesen Parameter als Expression angeben, muss das Ergebnis einen Boolean-Wert (true = wahr oder false = nicht wahr) enthalten. Sie können sowohl feste Werte als auch Variablen des aktuellen Tokens verwenden.

Trennzeichen

Im Editor

Im Editor wählen Sie über die Auswahlbox das Trennzeichen. Sie können ebenfalls eigene Werte in das Auswahlfeld eintragen.

Als Expression

Wenn Sie das Trennzeichen als Expression angeben, muss das Ergebnis einer Zeichenkette entsprechen, wie sie der Editor erwartet. Sie können sowohl feste Werte als auch Variablen des aktuellen Tokens verwenden. Für eine tab-getrennte CSV-Datei übergeben Sie die Expression '\t'.

Anführungszeichen für die übergebenen Werte

Im Editor

Im Editor wählen Sie über die Auswahlbox die Möglichkeiten für die Anführungszeichen. Sie können ebenfalls eigene Werte in das Auswahlfeld eintragen.

Als Expression

Wenn Sie diesen Parameter als Expression angeben, muss das Ergebnis einer Zeichenkette entsprechen, wie sie der Editor erwartet. Sie können sowohl feste Werte als auch Variablen des aktuellen Tokens verwenden. Wenn Sie vor und nach dem Wert einen Tab als Formatierung verwenden möchten, übergeben Sie bei der Expression '\t'.

Zeichensatz

Im Editor

Im Editor wählen Sie den Zeichensatz entweder aus der Auswahlbox oder tragen den gewünschten Zeichensatz ein.

Mehr zu den Zeichensätzen siehe https://docs.oracle.com/javase/8/docs/technotes/guides/intl/encoding.doc.html.
 

Als Expression

Wenn diesen Parameter als Expression angeben, geben Sie den vollständigen Pfad zur Variable an, in die das System das Ergebnis schreiben soll. Die übergebene Variable muss einen String enthalten.

Erweiterung der Eingangsvariable /CSV-Datei

Im Editor

Im Editor aktivieren oder deaktivieren Sie diese Funktion, indem Sie diese anhaken oder den Haken entfernen.

Im Standard ist diese Option deaktiviert.

Als Expression

Wenn Sie diesen Parameter als Expression angeben, muss das Ergebnis einen Boolean-Wert (true = wahr oder false = nicht wahr) enthalten. Sie können sowohl feste Werte als auch Variablen des aktuellen Tokens verwenden.