ZIP

Zweck

Das Zip-Element ist ein Hilfsprogramm zum Komprimieren einer oder mehrerer Dateien in ein Archiv oder zum Dekomprimieren eines Archivs, um auf dessen Inhalt zuzugreifen. Es unterstützt sowohl Standard-.zip-Archive als auch einzeln komprimierte .gz (gzip)-Dateien.

• Dieses Element ist unerlässlich für Workflows, die komprimierte Dateien handhaben müssen, wie z.B. die Vorbereitung mehrerer Dateien für einen einzigen Download oder das Extrahieren von Daten aus einem hochgeladenen Archiv.

Anwendungsfälle:

• Komprimieren eines Verzeichnisses mit Berichten in eine einzige .zip-Datei vor dem Versenden.

• Dekomprimieren eines hochgeladenen .zip-Archivs, um jede darin enthaltene Datei zu verarbeiten.

• Komprimieren einer großen Protokolldatei mit gzip, um Speicherplatz zu sparen.

• Dekomprimieren einer von einem entfernten Server heruntergeladenen .gz-Datei.

---

Praktische Anwendungshinweise

Unterschied: .zip vs. .gz (gzip)

Es ist wichtig, den Unterschied zu verstehen, da die Option Als gzip Datei das Verhalten stark verändert:

Format	Zweck	Ergebnis bei Verzeichnis-Eingabe
.zip	Archivformat: Bündelt mehrere Dateien und Verzeichnisse in einer einzigen .zip-Datei.	Eine einzige Archivdatei, die die ursprüngliche Verzeichnisstruktur enthält.
.gz (gzip)	Kompressionsformat für eine einzelne Datei.	Komprimiert jede Datei im Verzeichnis einzeln und erstellt mehrere .gz-Dateien.

• Pfadverwaltung: Seien Sie sich über Ihre Quell- und Zielpfade im Klaren:

  • Beim Zippen muss der Zielpfad den gewünschten Dateinamen für das Archiv enthalten (z. B. /archive/berichte.zip).

  • Beim Entzippen ist der Zielpfad das Verzeichnis, in das die Dateien platziert werden.

---

Konfigurationsoptionen

Das Element hat zwei primäre Betriebsmodi, die durch den ausgewählten Typ bestimmt werden.

Option	Beschreibung	Eingabeformat
Typ	Die Hauptoperation: zipFile (Archiv erstellen) oder unzipFile (Archiv extrahieren).	Auswahl (Dropdown).
Als gzip Datei	Checkbox, die das Komprimierungsformat auf gzip ändert (statt des Standard-zip).	Checkbox (Boolean).

Optionen für zipFile (Archiv erstellen)

Option	Beschreibung	Beispielwert
Ordnerpfad / Dateipfad	Die Quelldatei oder das Quellverzeichnis, das komprimiert werden soll.	/berichte/
Zielpfad	Der vollständige Pfad und Dateiname für die neue Archivdatei.	/archive/berichte.zip

Optionen für unzipFile (Archiv extrahieren)

Option	Beschreibung	Beispielwert
Dateipfad	Der Pfad zur .zip- oder .gz-Archivdatei, die Sie dekomprimieren möchten.	/eingang/neue_daten.zip
Zielpfad	Das Zielverzeichnis, in das der Inhalt des Archivs extrahiert werden soll.	–
Datei archivieren	Wenn aktiviert, wird das ursprüngliche Quellarchiv nach erfolgreicher Extraktion in ein Archivverzeichnis verschoben.	true

---

Eingabe-/Ausgabe-Erwartungen

• Eingabe: Variiert je nach ausgewähltem Typ.

• Ausgabe: Es erzeugt eine einzige Response-Variable.

Aktionstyp	Inhalt der Ausgabe Response	Format
unzipFile	Ein JSON-Array mit den Dateipfaden aller erfolgreich extrahierten Dateien.	JSON-Array.
zipFile	Eine einfache Erfolgsmeldung.	JSON-Array (z. B. [{"success": true}]).

---