Flower

← Alle Module · Daten & Formate

csv

Liest und schreibt CSV-Tabellen (RFC-4180) mit DACH-typischen Vorgaben — Trennzeichen Semikolon, automatische Encoding-Erkennung und Kopfzeile. Damit lassen sich Exporte aus Excel, Webportalen oder Fachsystemen auslesen, zeilenweise verarbeiten, anhängen oder neu erzeugen.

Block-Einstellungen

Gelten für den ganzen Modul-Block (im Editor oben im Inspektor, in YAML direkt unter dem Modulnamen).

FeldTypPflichtBeschreibung
dateiTextjaPfad zur CSV-Datei (für alle Aktionen Pflicht; Pfad-Stichwörter wie 'desktop' werden aufgelöst).
trennzeichenText—Spaltentrenner; nur das erste Zeichen zählt. Standard ';' (Excel-DACH-kompatibel).
hat-kopfzeileWahrheit—Ob die erste Zeile die Spaltennamen enthält. Standard true.
encodingText—Zeichenkodierung: 'auto' (Standard, erkennt BOM/UTF-8/Windows-1252) oder ein expliziter Name wie 'utf-8' bzw. 'windows-1252'.

Aktionen

lesenlesend

Liest die gesamte CSV und liefert Kopfzeile und Datenzeilen als Liste von Listen.

Ausgaben (über ergebnis:)

zeilenListe der Datenzeilen (ohne Kopfzeile); jede Zeile ist eine Liste von Zell-Texten.
kopfzeileListe der Spaltennamen aus der ersten Zeile, oder Nichts wenn hat-kopfzeile=false.

lesen-zeilenweiselesend

Liest die CSV und liefert jede Datenzeile als Objekt (Spaltenname → Wert) zum bequemen Durchlaufen.

Ausgaben (über ergebnis:)

zeilenListe von Objekten je Datenzeile; Schlüssel sind die Spaltennamen (ohne Kopfzeile: spalte1, spalte2, …).

zähle-zeilenlesend

Zählt die Datenzeilen (ohne Kopfzeile).

Ausgaben (über ergebnis:)

ergebnisAnzahl der Datenzeilen als Zahl.

anhängenverändernd

Hängt eine oder mehrere Zeilen ans Ende der bestehenden Datei an (verschmilzt nicht mit einer Bestandszeile ohne Schlusszeilenumbruch).

Eingaben

FeldTypPflichtBeschreibung
datenListejaListe von Zeilen; jede Zeile ist eine Liste von Zellwerten.

schreibenverändernd

Schreibt eine neue CSV-Datei (überschreibt eine vorhandene) mit optionaler Kopfzeile und Datenzeilen.

Eingaben

FeldTypPflichtBeschreibung
kopfzeileListe—Liste der Spaltennamen für die erste Zeile; weglassen für keine Kopfzeile.
zeilenListe—Liste von Datenzeilen; jede Zeile ist eine Liste von Zellwerten.

Beispiele

Kundenliste zeilenweise durchgehen

Liest einen CSV-Export Zeile für Zeile, um anschließend je Kunde etwas zu tun.

csv
csv · lesen-zeilenweise
dateidesktop/kunden.csv
ergebniszeilen
- csv:
    datei: "desktop/kunden.csv"
    aktionen:
      - lesen-zeilenweise:
          ergebnis: zeilen

Neue Auswertung schreiben

Erzeugt eine frische CSV mit Kopfzeile und zwei Datenzeilen.

csv
csv · schreiben
dateiC:\\Berichte\\auswertung.csv
kopfzeile[Name, Umsatz]
zeilen[[Anna, 1200], [Bert, 980]]
- csv:
    datei: "C:\\Berichte\\auswertung.csv"
    aktionen:
      - schreiben:
          kopfzeile: [Name, Umsatz]
          zeilen:
            - [Anna, 1200]
            - [Bert, 980]