← 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).
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| pfad | Text | — | Pfad 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
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| encoding | Text | — | Zeichenkodierung der Datei (z.B. utf-8, windows-1252, iso-8859-1). Standard 'auto' erkennt UTF-8 anhand der BOM. |
Ausgaben (über ergebnis:)
| ergebnis | Der gelesene Dateiinhalt als Text. |
lesen-binärlesend
Liest eine Datei roh als Liste von Byte-Werten (0–255).
Ausgaben (über ergebnis:)
| ergebnis | Liste der Bytes (Zahlen 0–255) der Datei. |
lesen-zeilenlesend
Liest eine Textdatei und gibt sie als Liste einzelner Zeilen zurück.
Eingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| encoding | Text | — | Zeichenkodierung der Datei. Standard 'auto'. |
Ausgaben (über ergebnis:)
| ergebnis | Liste der Zeilen ohne Zeilenumbrüche. |
schreibenverändernd
Schreibt Text in eine Datei und überschreibt vorhandenen Inhalt.
Eingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| inhalt | Text | — | Der zu schreibende Text. Fehlt er, wird eine leere Datei angelegt. |
| encoding | Text | — | Zeichenkodierung beim Schreiben. Standard utf-8. |
| bom | Wahrheit | — | Bei 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
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| inhalt | Text | — | Der anzuhängende Text. |
| encoding | Text | — | Zeichenkodierung. Standard utf-8. |
schreiben-binärverändernd
Schreibt rohe Bytes in eine Datei.
Eingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| inhalt | Liste | ja | Liste 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
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| ziel | Text | ja | Zielpfad der Kopie. |
| überschreiben | Wahrheit | — | Ob ein bereits vorhandenes Ziel überschrieben wird. Standard false. |
verschiebenverändernd
Verschiebt die Datei oder den Ordner an ein Ziel; Ordner werden rekursiv verschoben.
Eingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| ziel | Text | ja | Zielpfad. |
| überschreiben | Wahrheit | — | Ob ein vorhandenes Ziel überschrieben wird; sonst Fehler. Standard false. |
umbenennenverändernd
Benennt die Datei oder den Ordner innerhalb desselben Verzeichnisses um.
Eingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| neuer-name | Text | ja | Neuer Dateiname ohne Pfad-Trenner (kein / oder \). |
löschenverändernd
Löscht die Datei oder den Ordner; nicht-leere Ordner nur mit rekursiv.
Eingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| rekursiv | Wahrheit | — | Ob 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:)
| ergebnis | Wahr, wenn der Pfad existiert, sonst falsch. |
infoslesend
Liefert Metadaten zu Datei oder Ordner (Name, Größe, Endung, voller Pfad, Ordner-Flag).
Ausgaben (über ergebnis:)
| ergebnis | Objekt mit name, größe, ist-ordner, endung, voller-pfad. |
listelesend
Listet die Einträge eines Ordners auf, optional rekursiv und nach Muster gefiltert.
Eingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| rekursiv | Wahrheit | — | Ob auch Unterordner durchsucht werden. Standard false. |
| art | Text | — | Was gelistet wird: 'dateien', 'ordner' oder 'beides'. Standard 'beides'. |
| filter | Liste | — | Ein oder mehrere Glob-Muster (z.B. *.txt). Standard *. |
Ausgaben (über ergebnis:)
| ergebnis | Alphabetisch sortierte Liste der gefundenen Pfade. |
kombinierelesend
Setzt mehrere Pfad-Teile betriebssystemgerecht zu einem Pfad zusammen.
Eingaben
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| teile | Liste | ja | Liste der zu verbindenden Pfad-Bestandteile. |
Ausgaben (über ergebnis:)
| ergebnis | Der 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
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| endung | Text | — | Dateiendung des temporären Pfads. Standard .tmp. |
Ausgaben (über ergebnis:)
| ergebnis | Der 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:
pfad: "C:\\Berichte\\tag.txt"
aktionen:
- schreiben:
inhalt: "Tagesbericht: alles erledigt"
- lesen:
ergebnis: textPDFs eines Ordners auflisten und ins Archiv kopieren
Sucht alle PDF-Dateien im Eingangsordner und kopiert eine davon in den Archivordner.
- 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