File System Bulk
Dieser Adapter vereinfacht die Nutzung von Datei-Operationen in Technical Processes. Mit ihm lassen sich einfach Aktionen wie das Auflisten, Verschieben und Kopieren von mehreren Dateien oder Verzeichnissen durchführen. Durch die Kompatibilität mit dem ZIP in Memory Compression Adapter lassen sich auch einfach multiple Dateien und Verzeichnisse (ent-)packen.
Eigenschaften (Properties)
Operation | Bestimmt, welche Operation der Adapter durchführt Mögliche Werte:
|
Die Input- und Output-Strukturen sind kompatibel mit denen des ZIP in Memory Compression Adapters.
Parameter
Adapter | Hauptklasse des Adapters (nicht verändern!) Mögliche Werte: de.softproject.integration.adapter.filesystem.Bulk: Hauptklasse (Standard) |
baseDirectory | Basis-Verzeichnis für alle Operationen
Mögliche Werte: Absoluter Pfad zum Basis-Verzeichnis |
subDirectory | Verzeichnis relativ zum Mögliche Werte:
|
limit | Begrenz die Anzahl der zurückgegebenen Treffer einer List-Operation. Mögliche Werte:
Bei der Suche nach Dateien wird empfohlen, den Parameter |
maxLevel | Beschränkt die Rekursionstiefe für List-Operationen Mögliche Werte:
|
filter | Regulärer Ausdruck, der auf den relativen Pfad eines Eintrags bei List-Operationen angewendet wird. Wenn der reguläre Ausdruck zutrifft, wird der Pfad in die Ergebnismenge der Liste übernommen. |
skipDirectories | Definiert, ob eine List-Operation Verzeichnis-Elemente im Ergebnis ausgibt Mögliche Werte:
|
overwrite | Definiert, ob bei den Operationen Mögliche Werte:
|
strict | Definiert, ob für Mögliche Werte:
|
Statuswerte
1 | Alle Einträge für die Operation konnten erfolgreich durchgeführt werden. |
0 | Nicht alle Einträge für die Operation konnten erfolgreich durchgeführt werden, d.h. das Ergebnis enthält Error -Elemente. |
-1 | Bei der Ausführung kam es zu anderen technischen Problemen, z.B. ungültiger Input. |
Input
Input-Struktur für Read, Write, GetMetadata und Delete
<any>
<!-- any mixture of file and directory elements -->
<File name="relativePath">...Base64 content for Write...</File>
<Directory name="relativePath" />
</any>
Input-Struktur für Copy und Move
<any>
<!-- any mixture of file and directory elements -->
<File name="relativePath" target="relativePath" />
<Directory name="relativePath" target="relativePath" />
</any>
Output
<Data>
<!-- any mixture of file, directory and error elements -->
<File name="relativePath" [size="size of file in bytes"]
[creationTime=""] [creationTimeAsMillis=""]
[lastModifiedTime=""] [lastModifiedTimeAsMillis=""]
[lastAccessTime=""] [lastAccessTimeAsMillis=""]>
<!-- base64 conten, if operation Read or ListAndRead -->
<!-- xml structures containing metadata, if operation GetMetadata or ListWithMetadata -->
</File>
<Directory name="relativePath" [size="0"]
[creationTime=""] [creationTimeAsMillis=""]
[lastModifiedTime=""] [lastModifiedTimeAsMillis=""]
[lastAccessTime=""] [lastAccessTimeAsMillis=""]>
<!-- xml structures containing metadata, if operation GetMetadata or ListWithMetadata -->
</Directory>
<Error name="relativePath" [target="relativePath"] exception="fully qualified classname of exception"
[size="size of file in bytes"]
[creationTime=""] [creationTimeAsMillis=""]
[lastModifiedTime=""] [lastModifiedTimeAsMillis=""]
[lastAccessTime=""] [lastAccessTimeAsMillis=""]>
<!-- base64 content if operation Write -->
</Error>
</Data>
Write, Delete, Copy und Move haben nur dann Error-Elemente als Ergebnis, wenn es tatsächlich Fehler gab.
Beispiele für List
Voraussetzung
Folgende Verzeichnisstruktur ist gegeben:
/
+ a/
| + index.html
| + logo.gif
| + content/
| + toc.html
| + page1.html
| + page2.html
| + images/
| + pic1.png
| + pic2.png
+ b/
+ some.html
+ other.html
+ files.html
Szenarien
Alles listen
Adapter-Konfiguration | Output |
---|---|
|
XML
|
Die ersten 5 Einträge
Adapter-Konfiguration | Output |
---|---|
|
XML
|
Die ersten fünf Dateien
Adapter-Konfiguration | Output |
---|---|
|
XML
|
Nur das aktuelle Verzeichnis
Adapter-Konfiguration | Output |
---|---|
|
XML
|
Alle Dateien und Verzeichnisse, die einen Filter erfüllen
Adapter-Konfiguration | Output |
---|---|
|
XML
|
Alle Dateien, die einen Filter erfüllen (ohne Verzeichnisse)
Adapter-Konfiguration | Output |
---|---|
|
XML
|
Alles unterhalb eines Unterverzeichnisses
Adapter-Konfiguration | Output |
---|---|
|
XML
|
Alles unterhalb des aktuellen Verzeichnisses und den direkten Kindverzeichnissen
Adapter-Konfiguration | Output |
---|---|
|
XML
|
Das Startverzeichnis kann tief im Verzeichnisbaum liegen
Adapter-Konfiguration | Output |
---|---|
|
XML
|