X4 Produktdokumentation
X4 Produktdokumentation
Breadcrumbs

File System

Dieser Adapter speichert, liest, löscht, kopiert, verschiebt, listet Dateien und Ordner oder fügt Dateien einer Zieldatei an, die sich im Dateisystem des X4 Servers oder auf verbundenen Windows- oder Samba-Netzlaufwerken befinden.

Der Adapter File System darf nicht verwendet werden, um Dateien im X4 Repository zu verändern, da er nicht auf das X4 Repository, sondern direkt auf das Dateisystem zugreift. Wird der Adapter hierfür verwendet, kann es zu Fehlermeldungen und Störungen kommen.
Um Dateien im X4 Repository zu verändern, verwenden Sie den Adapter (7.5.0-de) Projects bzw. (7.5.0-de) Project Access.

Eigenschaften (Properties)

Operation

Vom Adapter ausgeführte Operation

Mögliche Werte:

  • Write File: Daten aus dem vorangegangenen Prozess-Schritt in die im Parameter path angegebene Zieldatei schreiben.

  • Append File: Datei aus dem vorangegangenen Prozess-Schritt in die im Parameter path angegebene Zieldatei anhängen.

    Wenn die im Parameter path festgelegte Zieldatei nicht existiert, wird eine Datei erstellt.

  • Read File: Im Parameter path festgelegte Datei lesen.

  • Delete: Im Parameter path festgelegte Dateien oder Ordner löschen.

  • Copy: Im Parameter path festgelegte Dateien oder Ordner in den im Parameter targetPath festgelegten Ordner kopieren.

  • Move: Im Parameter path festgelegte Dateien oder Ordner in den im Parameter targetPath festgelegten Ordner verschieben.

  • Exists: Prüfen, ob die im Parameter path festgelegten Dateien oder Ordner existieren. Gibt als Ergebnis eine XML mit Metadaten aus.

  • Create Folder: Im Parameter path festgelegten Ordner erstellen.

  • List Folder: Namen und Metadaten von Dateien und Ordnern aus dem im Parameter path festgelegten Ordner auflisten. Gibt als Ergebnis eine XML mit Metadaten aus.

    Der Inhalt der Dateien wird nicht gelistet.

Parameter

path

Pfad zu einer Datei oder einem Ordner im Dateisystem des X4 Servers oder zu einem verbundenen Windows- oder Samba-Netzlaufwerk. Hierzu benötigt der X4 Server entsprechende Berechtigungen auf den Ordner.

Mögliche Werte:

  • Beliebige Zeichenkette, ggf. inklusive Platzhaltern und Dateiendung z.B. %USER_COLLECTION%/Data/Input.xml

  • c:/: Auf die Windows-Systempartition C:\ zugreifen

  • Beliebige UNC-Netzlaufwerksangabe nach dem Schema \\\\Server\\Freigabe\\Ordner\\ mit beliebigen Leer- und Sonderzeichen z.B. \\\\SP-PM-01\\share\\Öffentlicher Ordner\\ 

targetPath

Zusätzlicher Pfad zu einer Datei oder einem Ordner im Dateisystem des X4 Servers oder zu einem verbundenen Windows- oder Samba-Netzlaufwerk. Hierzu benötigt der X4 Server entsprechende Berechtigungen auf den Ordner.

Dieser Parameter wird nur bei der Operation Move und Copy verwendet.

Mögliche Werte:

  • Beliebige Zeichenkette, ggf. inklusive Platzhaltern und Dateiendung z.B. %USER_COLLECTION%\Data\Input.xml

  • c:\  Auf die Windows-Systempartition C:\ zugreifen

  • Beliebige UNC-Netzlaufwerksangabe nach dem Schema \\\\Server\\Freigabe\\Ordner\\ mit beliebigen Leer- und Sonderzeichen z.B. \\\\SP-PM-01\\share\\Öffentlicher Ordner\\ 

nameFilter

Filtert den Output der Operation ListFolder nach Name

Mögliche Werte:

  • Beliebige Zeichenkette (z.B. myFolder )

  • Platzhalter (Wildcard) *

  • Semicolon ; als Trennzeichen bei mehreren Werten (z.B. *.txt; *.pdf)

addNewline

Fügt in der Zieldatei eine neue Zeile vor der anzuhängenden Datei ein. Kann nur mit der Operation Append File verwendet werden.

Mögliche Werte:

  • None: (Standard) Fügt keine neue Zeile ein.

  • Auto: Fügt eine neue Zeile ein, wenn zuvor keine neue Zeile eingefügt wurde. Erkennt das Format einer bereits eingefügten neuen Zeile.

  • Windows: Fügt eine neue Zeile im Windows-Format ein.

  • Unix: Fügt eine neue Zeile im Unix-Format ein.

Statuswerte

1

Die Operation wurde erfolgreich ausgeführt.

-1

Die Operation ist aufgrund eines technischen Fehlers fehlgeschlagen.