X4 Produktdokumentation
X4 Produktdokumentation
Breadcrumbs

Operation: Unzip

Mit der Operation Unzip des ZIP Converters dekomprimieren Sie den bereitgestellten Input am angegebenen Speicherort. Es können auch passwortgeschützte Dateien dekomprimiert werden.

Parameter

sourcePath

Verzeichnispfad zur Datei, die komprimiert/dekomprimiert werden soll.

Hinweis:

Wenn Sie diesen Parameter nicht setzen, dann wird die Datei über den Adapter-Input bereitgestellt. In diesem Fall müssen Sie einen Wert für den Parameter inputName festlegen.

Mögliche Werte:

Verzeichnispfad

targetPath

Verzeichnispfad zum Speicherort, an dem der Output gespeichert werden soll ("Zielverzeichnis").

Hinweis:

Wenn dieser Parameter nicht gesetzt wird, dann wird die Datei über den Adapter-Output bereitgestellt.

Mögliche Werte:

Verzeichnispfad

overwrite

Legt fest, ob vorhandene Dateien mit dem gleichen Namen überschrieben werden sollen.

Mögliche Werte:

  • true: Dateien werden überschrieben.

Hinweise zu aktiviertem Kontrollkästchen (true):

  • Wenn mergeContent aktiviert ist, dann wird im Output eine Fehlermeldung ausgegeben, da die Datei nicht weiterverarbeitet werden kann.

  • Wenn mergeContent deaktiviert ist, dann wird die vorhandene Datei überschrieben.

  • false: Dateien werden nicht überschrieben.

Hinweise zu deaktiviertem Kontrollkästchen (false):

  • Wenn mergeContent aktiviert ist, dann wird werden die Dateien zusammengeführt.

  • Wenn mergeContent deaktiviert ist, dann wird im Output eine Fehlermeldung ausgegeben, da die Datei nicht weiterverarbeitet werden kann.

mergeContent

Legt fest, ob vorhandene Dateien mit dem gleichen Namen zusammengeführt werden sollen.

Mögliche Werte:

  • true: Dateien werden zusammengeführt.

Hinweise zu aktiviertem Kontrollkästchen (true):

  • Wenn overwrite aktiviert ist, dann wird im Output eine Fehlermeldung ausgegeben, da die Datei nicht weiterverarbeitet werden kann.

  • Wenn overwrite deaktiviert ist, dann werden die Dateien zusammengeführt.

  • false: Dateien werden nicht zusammengeführt.

Hinweise zu deaktiviertem Kontrollkästchen (false):

  • Wenn overwrite aktiviert ist, dann wird die vorhandene Datei überschrieben.

  • Wenn overwrite deaktiviert ist, dann wird im Output eine Fehlermeldung ausgegeben, da die Datei nicht weiterverarbeitet werden kann.

inputName

Name der Input-Datei. Wird verwendet, wenn der sourcePath nicht gesetzt ist.

Mögliche Werte:

Dateiname der Datei, die als Input empfangen bzw. als Output ausgegeben werden soll

encryptedFiles

Gibt an, ob in der Operation verschlüsselte Dateien verarbeitet werden sollen. Bei der Operation Unzip wird für das entzippen ein Passwort benötigt.

Mögliche Werte:

  • true

  • false

password

Passwort für verschlüsselte Dateien.

Mögliche Werte:

Beliebige Zeichenkette

encryptionMethod

Gibt an, welche Verschlüsselungsmethode beim Zippen verwendet wird, wenn encryptedFiles aktiviert ist.

Mögliche Werte:

  • No encryption: Keine Verschlüsselung beim Zippen verwenden

  • AES: AES-Verschlüsselungsalgorithmus verwenden (Schlüssellänge: 256 Bit)

  • Standard: Standard-Verschlüsselungsalgorithmus verwenden

compressionMethod

Gibt an, welcher Komprimierungsalgorithmus beim Zippen verwendet wird.

Mögliche Werte:

  • Deflate (Standard): Verlustfreie Komprimierung, die eine Kombination aus dem LZ77-Algorithmus und Huffman-Codierung verwendet.

Hinweise zum Wert Deflate:

  • Store: Daten werden nicht komprimiert, sondern in eine einzige Datei gepackt.

Hinweis zum Wert Store:

Dieser Wert ist nützlich, wenn mehrere Daten/Ordner gesendet/empfangen werden sollen und die Dateigröße vernachlässigt werden kann. Es wird keine Zeit für das Verpacken benötigt.

compressionLevel

Gibt den Komprimierungsalgorithmus beim Zippen an, wenn Der Wert Deflate als compressionMethod gewählt ist.

Mögliche Werte:

  • Fastest: Niedrigste Kompressionsstufe, aber sehr schnelle Kompression

  • Fast: Niedrige Kompressionsstufe, aber schnelle Kompression

  • Normal (Standard): Optimales Verhältnis zwischen Kompressionsstufe und Geschwindigkeit

  • Maximum: Hohe Kompressionsstufe, aber langsamere Kompression

  • Ultra: Höchste Kompressionsstufe, aber sehr langsame Kompression

Statuswerte

1

Die Operation wurde erfolgreich ausgeführt

-1

Die Operation ist aufgrund eines technischen Fehlers fehlgeschlagen.

Input

Abhängig von der Konfiguration des Parameters sourcePath erwartet der Adapter unterschiedlichen Input.

  • Wenn der Parameter sourcePath nicht gesetzt ist, erwartet der Adapter eine ZIP-Datei als zu entpackenden Input.

  • Wenn der Parameter sourcePath gesetzt ist, wird die ZIP-Datei im sourcePath entpackt und der Adapter erwartet keinen spezifischen Input.

Output

Abhängig von der Konfiguration des Parameters targetPath liefert der Adapter unterschiedlichen Output zurück.

  • Wenn der Parameter targetPath nicht gesetzt ist, wird eine XML-Datei mit dem Inhalt und der Struktur der ZIP-Datei in Base64 kodiert ausgegeben.
    Die XML hat folgende Struktur:

    <?xml version="1.0" encoding="UTF-8" ?>
<Zip>
    <File size="209" name="testToZip.xml">PD94bWwgdmVyc2lvgj0iMS4wIiBlbmNvZGluZz0iVVRGLTgiPz4KPFJvb3RFbGVtZW50P</File>
</Zip>

Hinweis:

Das Entpacken auf diesem Weg kann je nach Größe der entpackten ZIP-Datei sehr ressourcenintensiv sein.

  • Wenn der Parameter targetPath gesetzt ist, gibt der Adapter keinen Output aus und die Inhalte der ZIP-Datei werden am Speicherort abgelegt, der als Verzeichnispfad angegeben ist.