Dateizugriff

Zweck

Das File Access-Element ist ein vielseitiges Werkzeug für die Interaktion mit dem Dateisystem der Plattform. Es ermöglicht Ihnen, alle grundlegenden Dateioperationen durchzuführen: Lesen, Schreiben, Anhängen, Löschen, Suchen und Verschieben/Umbenennen von Dateien.

Dieses Element ist unerlässlich für jeden Workflow, der Dateien verarbeiten muss, wie z.B. die Verarbeitung von Uploads, die Erstellung von Berichten oder die Verwaltung temporärer Daten.

Anwendungsfälle:

• Lesen des Inhalts einer Konfigurationsdatei.

• Schreiben eines generierten Berichts (z.B. eine CSV- oder JSON-Datei) in das Dateisystem.

• Anhängen neuer Protokolleinträge an eine bestehende Protokolldatei.

• Suchen nach allen .xml-Dateien in einem „Eingangs“-Verzeichnis zur Verarbeitung.

• Verschieben einer erfolgreich verarbeiteten Datei in ein „Archiv“-Verzeichnis.

---

Praktische Anwendungshinweise

• Pfade sind relativ: Alle Dateipfade sind relativ zum Stammverzeichnis des zugewiesenen Dateispeichers Ihres Projekts.

• Sicheres Löschen: Die Löschen-Operation ist so konzipiert, dass sie nur Dateien löscht. Sie wird kein Verzeichnis löschen, was den versehentlichen Verlust ganzer Ordner verhindert.

• Anhängen vs. Schreiben:

  • Schreiben erstellt eine neue Datei oder überschreibt eine bestehende vollständig.

  • Anhängen fügt den neuen Inhalt am Ende einer bestehenden Datei hinzu.

• Suchen mit Platzhaltern: Die Suchen-Funktion ist in Kombination mit Platzhaltern sehr leistungsfähig. Beispielsweise würde ein Suchmuster von /rechnungen/rg_*.pdf alle PDF-Rechnungen im Rechnungs-Verzeichnis finden.

---

Konfigurationsoptionen

Die Funktion des Elements wird durch den ausgewählten Typ bestimmt. Die verfügbaren Eingaben ändern sich entsprechend:

Typ	Erforderliche Eingaben	Beschreibung
Lesen	Dateiname	Der vollständige Pfad und Name der zu lesenden Datei (z. B. /berichte/bericht.txt).
Schreiben/Anhängen	Verzeichnis, Dateiname, Inhalt	Inhalt wird in die Datei geschrieben/angehängt. JSON-Daten werden automatisch in einen String umgewandelt.
Löschen	Dateiname	Der vollständige Pfad und Name der zu löschenden Datei.
Suchen	Verzeichnis, Suchmuster	Suchmuster zur Identifizierung von Dateien (z. B. *.csv zur Suche nach allen CSV-Dateien).
Verschieben/Umbenennen	Alter Datei Pfad, Neuer Datei Pfad	Gibt den aktuellen und den Zielpfad/neuen Namen für die Datei an.

---

Eingabe-/Ausgabe-Erwartungen

Eingabe

Die Eingabe variiert je nach ausgewähltem Typ, wie in der Tabelle oben beschrieben.

Ausgabe

Das Element erzeugt eine einzige result-Variable. Der Inhalt und das Format des Ergebnisses hängen von der Operation ab:

Aktionstyp	Inhalt der Ausgabe result	Format
Lesen	Der gesamte Inhalt der Datei.	String.
Schreiben/Anhängen	Der vollständige Pfad der Datei, in die geschrieben wurde.	String.
Suchen	Ein JSON-Array von Objekten mit Details zu jeder gefundenen Datei (fileName, filePath, fileSize).	JSON-Array von Objekten.
Löschen/Verschieben/Umbenennen	Keine Ausgabevariable.	–

---