Liest und schreibt ZIP-Archive: zeigt den Inhalt an, packt Dateien und Ordner ein, entpackt sie wieder und bearbeitet einzelne Einträge im Archiv. Damit lassen sich z. B. Anhänge bündeln, Backups packen oder gelieferte ZIP-Pakete im Workflow auspacken.
Block-Einstellungen
Gelten für den ganzen Modul-Block (im Editor oben im Inspektor, in YAML direkt unter dem Modulnamen).
Feld
Typ
Pflicht
Beschreibung
datei
Text
ja
Pfad zum ZIP-Archiv, auf das alle Aktionen des Blocks wirken. Beim Erstellen oder Schreiben wird die Datei angelegt, falls sie noch nicht existiert.
Aktionen
listelesend
Listet alle Einträge des Archivs mit Name, Größe, komprimierter Größe und Ordner-Kennzeichen auf.
Ausgaben (über ergebnis:)
ergebnis
Liste von Objekten je Eintrag mit den Feldern name (Text), größe (Zahl, Bytes), komprimiert (Zahl, Bytes) und ist-ordner (Wahrheit).
enthältlesend
Prüft, ob ein bestimmter Eintrag im Archiv vorhanden ist (Groß-/Kleinschreibung und Slash-Richtung werden ignoriert).
Eingaben
Feld
Typ
Pflicht
Beschreibung
eintrag
Text
ja
Name bzw. Pfad des gesuchten Eintrags innerhalb des Archivs (z. B. "ordner/datei.txt").
Ausgaben (über ergebnis:)
ergebnis
Wahrheitswert: true, wenn der Eintrag existiert, sonst false.
anzahllesend
Gibt die Anzahl aller Einträge im Archiv zurück.
Ausgaben (über ergebnis:)
ergebnis
Zahl mit der Anzahl der Archiv-Einträge.
eintrag-lesenlesend
Liest den Inhalt eines einzelnen Eintrags als Text (UTF-8) aus dem Archiv.
Eingaben
Feld
Typ
Pflicht
Beschreibung
eintrag
Text
ja
Name bzw. Pfad des zu lesenden Eintrags im Archiv.
Ausgaben (über ergebnis:)
ergebnis
Text mit dem Inhalt des Eintrags.
erstellenverändernd
Erstellt ein neues ZIP-Archiv aus einer oder mehreren Quell-Dateien und/oder Ordnern (Ordner werden rekursiv eingepackt).
Eingaben
Feld
Typ
Pflicht
Beschreibung
quellen
Liste
ja
Liste von Datei- und/oder Ordnerpfaden, die ins Archiv gepackt werden (ein einzelner Pfad als Text ist ebenfalls erlaubt).
basis-ordner
Text
—
Basis-Ordner, ab dem die Eintragsnamen relativ berechnet werden; ohne Angabe wird der jeweilige Quell-Ordner bzw. der Eltern-Ordner der Datei verwendet.
Ausgaben (über ergebnis:)
(keine)
Liefert kein ergebnis; das Archiv wird unter dem Block-Pfad datei geschrieben.
entpackenverändernd
Entpackt alle Dateien des Archivs in einen Ziel-Ordner (mit Schutz gegen Path-Traversal/Zip-Slip).
Eingaben
Feld
Typ
Pflicht
Beschreibung
ziel-ordner
Text
ja
Ordner, in den der gesamte Archiv-Inhalt extrahiert wird; Unterordner werden angelegt.
überschreiben
Wahrheit
—
Wenn true, werden vorhandene Dateien überschrieben; bei false (Standard) bricht die Aktion bei einer Kollision ab.
Ausgaben (über ergebnis:)
(keine)
Liefert kein ergebnis; die Dateien landen im Ziel-Ordner.
eintrag-entpackenverändernd
Entpackt einen einzelnen Eintrag des Archivs an einen konkreten Ziel-Pfad.
Eingaben
Feld
Typ
Pflicht
Beschreibung
eintrag
Text
ja
Name bzw. Pfad des zu entpackenden Eintrags im Archiv.
ziel-pfad
Text
ja
Vollständiger Ziel-Dateipfad, unter dem der Eintrag gespeichert wird; fehlende Ordner werden angelegt.
Ausgaben (über ergebnis:)
(keine)
Liefert kein ergebnis; die Datei wird am Ziel-Pfad geschrieben.
eintrag-hinzufügenverändernd
Fügt eine Datei vom Datenträger als neuen Eintrag ins Archiv ein (legt das Archiv an, falls es noch nicht existiert).
Eingaben
Feld
Typ
Pflicht
Beschreibung
quell-pfad
Text
ja
Pfad der einzupackenden Datei auf dem Datenträger.
eintrag
Text
—
Name des Eintrags im Archiv; ohne Angabe wird der Dateiname der Quelle verwendet.
Ausgaben (über ergebnis:)
(keine)
Liefert kein ergebnis; der Eintrag wird ins Archiv aufgenommen.
eintrag-entfernenverändernd
Entfernt einen Eintrag aus dem Archiv (Groß-/Kleinschreibung und Slash-Richtung werden ignoriert).
Eingaben
Feld
Typ
Pflicht
Beschreibung
eintrag
Text
ja
Name bzw. Pfad des zu löschenden Eintrags; existiert er nicht, bricht die Aktion mit Fehler ab.
Ausgaben (über ergebnis:)
(keine)
Liefert kein ergebnis; der Eintrag wird aus dem Archiv gelöscht.
eintrag-schreibenverändernd
Schreibt Text direkt als Eintrag ins Archiv; ein vorhandener gleichnamiger Eintrag wird überschrieben und ein fehlendes Archiv neu angelegt.
Eingaben
Feld
Typ
Pflicht
Beschreibung
eintrag
Text
ja
Name bzw. Pfad des Eintrags, der geschrieben werden soll.
text
Text
—
Textinhalt des Eintrags; ohne Angabe wird ein leerer Eintrag angelegt.
Ausgaben (über ergebnis:)
(keine)
Liefert kein ergebnis; der Eintrag wird ins Archiv geschrieben.
Beispiele
Berichtsordner in ein ZIP packen
Packt einen kompletten Ordner rekursiv in ein neues Archiv, wobei die Pfade relativ zum Basis-Ordner gespeichert werden.