Flower

← Alle Module · Dateien & System

datei

Das Modul liest, schreibt und verwaltet Dateien und Ordner auf der lokalen Platte oder Netzlaufwerken. Es deckt typische Datei-Operationen ab: Inhalte lesen oder speichern, kopieren, verschieben, umbenennen, löschen, Verzeichnisse auflisten und Pfade zusammensetzen.

Block-Einstellungen

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

FeldTypPflichtBeschreibung
pfadTextPfad zur Datei oder zum Ordner, auf dem die Aktionen arbeiten. Wird von fast allen Aktionen benötigt; nur 'kombiniere' und 'temp-pfad' kommen ohne aus.

Aktionen

lesenlesend

Liest den Textinhalt einer Datei und gibt ihn als Text zurück.

Eingaben

FeldTypPflichtBeschreibung
encodingTextZeichenkodierung der Datei (z.B. utf-8, windows-1252, iso-8859-1). Standard 'auto' erkennt UTF-8 anhand der BOM.

Ausgaben (über ergebnis:)

ergebnisDer gelesene Dateiinhalt als Text.

lesen-binärlesend

Liest eine Datei roh als Liste von Byte-Werten (0–255).

Ausgaben (über ergebnis:)

ergebnisListe der Bytes (Zahlen 0–255) der Datei.

lesen-zeilenlesend

Liest eine Textdatei und gibt sie als Liste einzelner Zeilen zurück.

Eingaben

FeldTypPflichtBeschreibung
encodingTextZeichenkodierung der Datei. Standard 'auto'.

Ausgaben (über ergebnis:)

ergebnisListe der Zeilen ohne Zeilenumbrüche.

schreibenverändernd

Schreibt Text in eine Datei und überschreibt vorhandenen Inhalt.

Eingaben

FeldTypPflichtBeschreibung
inhaltTextDer zu schreibende Text. Fehlt er, wird eine leere Datei angelegt.
encodingTextZeichenkodierung beim Schreiben. Standard utf-8.
bomWahrheitBei utf-8: ob eine Byte-Order-Mark vorangestellt wird. Standard false.

anhängenverändernd

Hängt Text an das Ende einer bestehenden Datei an (legt sie bei Bedarf neu an).

Eingaben

FeldTypPflichtBeschreibung
inhaltTextDer anzuhängende Text.
encodingTextZeichenkodierung. Standard utf-8.

schreiben-binärverändernd

Schreibt rohe Bytes in eine Datei.

Eingaben

FeldTypPflichtBeschreibung
inhaltListejaListe von Byte-Werten (0–255) oder ein Text, der als Bytes geschrieben wird.

kopierenverändernd

Kopiert die Datei oder den Ordner (Block-Pfad) an ein Ziel; Ordner werden rekursiv kopiert.

Eingaben

FeldTypPflichtBeschreibung
zielTextjaZielpfad der Kopie.
überschreibenWahrheitOb ein bereits vorhandenes Ziel überschrieben wird. Standard false.

verschiebenverändernd

Verschiebt die Datei oder den Ordner an ein Ziel; Ordner werden rekursiv verschoben.

Eingaben

FeldTypPflichtBeschreibung
zielTextjaZielpfad.
überschreibenWahrheitOb ein vorhandenes Ziel überschrieben wird; sonst Fehler. Standard false.

umbenennenverändernd

Benennt die Datei oder den Ordner innerhalb desselben Verzeichnisses um.

Eingaben

FeldTypPflichtBeschreibung
neuer-nameTextjaNeuer Dateiname ohne Pfad-Trenner (kein / oder \).

löschenverändernd

Löscht die Datei oder den Ordner; nicht-leere Ordner nur mit rekursiv.

Eingaben

FeldTypPflichtBeschreibung
rekursivWahrheitOb ein nicht-leerer Ordner samt Inhalt gelöscht wird. Standard false.

existiertlesend

Prüft, ob die Datei oder der Ordner am Pfad vorhanden ist.

Ausgaben (über ergebnis:)

ergebnisWahr, wenn der Pfad existiert, sonst falsch.

infoslesend

Liefert Metadaten zu Datei oder Ordner (Name, Größe, Endung, voller Pfad, Ordner-Flag).

Ausgaben (über ergebnis:)

ergebnisObjekt mit name, größe, ist-ordner, endung, voller-pfad.

listelesend

Listet die Einträge eines Ordners auf, optional rekursiv und nach Muster gefiltert.

Eingaben

FeldTypPflichtBeschreibung
rekursivWahrheitOb auch Unterordner durchsucht werden. Standard false.
artTextWas gelistet wird: 'dateien', 'ordner' oder 'beides'. Standard 'beides'.
filterListeEin oder mehrere Glob-Muster (z.B. *.txt). Standard *.

Ausgaben (über ergebnis:)

ergebnisAlphabetisch sortierte Liste der gefundenen Pfade.

kombinierelesend

Setzt mehrere Pfad-Teile betriebssystemgerecht zu einem Pfad zusammen.

Eingaben

FeldTypPflichtBeschreibung
teileListejaListe der zu verbindenden Pfad-Bestandteile.

Ausgaben (über ergebnis:)

ergebnisDer zusammengesetzte Pfad als Text.

ordner-anlegenverändernd

Erstellt einen Ordner (samt fehlender Eltern-Ordner); idempotent.

temp-pfadlesend

Erzeugt einen eindeutigen Pfad im Temp-Verzeichnis (Datei wird nicht angelegt).

Eingaben

FeldTypPflichtBeschreibung
endungTextDateiendung des temporären Pfads. Standard .tmp.

Ausgaben (über ergebnis:)

ergebnisDer eindeutige temporäre Pfad als Text.

Beispiele

Textdatei schreiben und wieder einlesen

Schreibt einen Bericht in eine Datei und liest den Inhalt anschließend in eine Variable zurück.

datei
schreiben
pfad (Block)C:\Berichte\tag.txt
inhaltTagesbericht: alles erledigt
datei
lesen
pfad (Block)C:\Berichte\tag.txt
ergebnistext
- datei:
    pfad: "C:\\Berichte\\tag.txt"
    aktionen:
      - schreiben:
          inhalt: "Tagesbericht: alles erledigt"
      - lesen:
          ergebnis: text

PDFs eines Ordners auflisten und ins Archiv kopieren

Sucht alle PDF-Dateien im Eingangsordner und kopiert eine davon in den Archivordner.

datei
liste
pfad (Block)N:\Eingang
artdateien
filter*.pdf
ergebnispdfs
datei
kopieren
pfad (Block)N:\Eingang\rechnung.pdf
zielN:\Archiv\rechnung.pdf
überschreibentrue
- datei:
    pfad: "N:\\Eingang"
    aktionen:
      - liste:
          art: dateien
          filter: "*.pdf"
          ergebnis: pdfs
- datei:
    pfad: "N:\\Eingang\\rechnung.pdf"
    aktionen:
      - kopieren:
          ziel: "N:\\Archiv\\rechnung.pdf"
          überschreiben: true