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

Standard	Veränderbar?	Weitere Endpoints möglich?
Default (Inlet)	Nein, kann nur ausgeblendet werden.	nein, nicht nötig
Default (Outlet)	Nein, kann nur ausgeblendet werden.	nein, nicht nötig

Parameter

Parameter	Beschreibung	Beispiel
Datenvariable	Definiert die Variable mit den Daten, die der Knoten verarbeitet. Die angegebene Variable muss ein Array enthalten. Wenn Sie den Parameter Header automatisch generieren aktiviert haben, muss das Array zusätzlich Objekte enthalten. Wenn Sie den Parameter Header automatisch generieren deaktiviert haben, muss das Array weitere Arrays enthalten, da sich die Zuordnung zum Header nur über ein Array herstellen lässt. Der Aufbau einer Datenvariable ist identisch zum Aufbau einer Ausgangsvariable und Eingangsvariable.	Datenvariable
Header-Informationen	Steuert, welche Spaltennamen das System als Überschriften in die CSV-Datei einträgt. Als Ergebnis erwartet das System ein Array.	Header-Informationen
Header automatisch generieren	Definiert, ob das System den Header automatisch erzeugt. Aktiviert Überprüft die Datenvariable. Falls es sich bei dem ersten Element innerhalb des Arrays um ein Objekt handelt, verwendet das System die Keys als Header. Deaktiviert Überprüft die Datenvariable. Falls es sich bei dem ersten Element innerhalb des Arrays nicht um ein Objekt handelt, erzeugt das System abhängig von der Länge des Arrays oder des ersten enthaltenen Arrays einen generischer Header mit folgender Struktur: Colum 1, Colum 2, Colum 3 ...	Header automatisch generieren
Trennzeichen	Definiert, welcher Separator das System für das Trennen der Werte verwendet.	Trennzeichen
Anführungszeichen für die übergebenen Werte	Definiert, ob das System die Werte mit Anführungszeichen in die CSV schreibt. Im Standard verwendet das System doppelte Anführungszeichen (").	Anführungszeichen für die übergebenen Werte
Zeichensatz	Legt den Zeichensatz für die zu erstellende CSV-Datei fest. Im Standard verwendet das System das Format ISO-8859-15. Der Workflow-Knoten erwartet als übergebenes Format einen String.	Zeichensatz
Erweiterung der Eingangsvariable /CSV-Datei	Definiert, ob das System die in der Eingangsvariable angegebene CSV-Datei durch die Datenvariable erweitert.	Erweiterung der Eingangsvariable /CSV-Datei
Eingangsvariable	Definiert die Variable, welche die zu erweiternde CSV-Datei enthält. Wenn Sie die Variable nicht angeben, verwendet das System automatisch die Anhänge des Workflows aus der internen Variable sys_acw_attachments.	–
Ausgangsvariable	Definiert die Variable, in die das System die erstellte oder erweiterte CSV-Datei zur Verfügung stellt.	–

Tipp: Verwenden Sie die Variablenauswahl, um einen Überblick über alle nutzbaren Variablen zu erhalten.

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.

true
false
token.variables.generateHeader

Trennzeichen

Im Editor

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

,
1234

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'.

';'
'\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'.

'_'
'\t'

Zeichensatz

Im Editor

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

ISO-8859-15

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.

token.variables.encoding

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

true
false
token.variables.EnableAppend