Workflow-Aktion: Speichern im Dateisystem

Geändert am Mi, 29 Apr um 2:23 NACHMITTAGS

Diese Aktion ermöglicht es, Dateien im Dateisystem des Servers längerfristig zu speichern. Dateien, die von Aktionen erzeugt werden, sind sonst nur temporär verfügbar und werden gelöscht, sobald der Workflow beendet ist.

Inhalt

Die Oberfläche zur Einstellung der Optionen von Aktionen des Typs Speichern im Dateisystem.

Parameter

Details zum Speichern im Dateisystem

Dateien

Auswahl der Dateien, welche gespeichert werden sollen. Es können Dateien von vorherigen Aktionen, Dateien von Upload-Elementen, Vorgangsanhänge oder Formulardateien ausgewählt werden. Siehe Aktionen für eine Liste der unterstützten URL-Protokolle.

Zielverzeichnis

Angabe eines Pfades zum Speichern der Datei. Wird ein Verzeichnis angegeben, das nicht existiert, versucht die Aktion dieses Verzeichnis anzulegen. Bitte stellen Sie sicher, dass für das Zielverzeichnis die entsprechenden Schreib-Berechtigungen auf dem formcycle Server vorhanden sind. Informieren Sie sich dazu gegebenenfalls bei Ihrem Systemadministrator.
Beispiele für das Speichern von Dateien im Benutzerverzeichnis des Systems:

Windows: C:\Users\fc\form\demo

Linux: /home/fc/form/demo

Ordnerstruktur in Platzhaltern erlauben

Wenn diese Option aktiviert ist, können in Platzhaltern Pfadsegmente in Form von '<Ordnername>/<Ordnername>' enthalten sein.
Andernfalls wird der Pfad-Seperator ('/') aus dem Platzhalter entfernt. Navigationsangaben auf übergeordnete Dateiordner sind nicht erlaubt und werden entfernt.

Besonderheiten bei Speicherung auf einem Netzlaufwerk

Bei der Speicherung von Dateien auf einem Netzlaufwerk sind einige Punkte zu beachten:

Es ist erforderlich, dass eine Freigabe des Netzlaufwerks auf dem formcycle Server erfolgt ist.
Als Zielverzeichnis ist in der Aktion statt des Netzwerkbuchstabens der Netzwerkpfad zu verwenden, also im Grunde die Angabe, die Sie bei der Einbindung des Netzlaufwerks verwendet haben. Ein Beispiel:
\\mein-formcycle-server\data\zielordner
Außerdem ist darauf zu achten, dass die erforderlichen Berechtigungen zum Schreiben von Dateien vorliegen. Dazu muss dem Tomcat die entsprechenden Berechtigungen erteilt werden. Da einem lokalen Dienst keine Rechte zugewiesen werden können, muss der Tomcat mit einem lokalen System- oder Domainbenutzer gestartet werden.

Nach der Umstellung des Benutzers muss noch die Schreibberechtigung des Tomcat-Benutzers für das Netzlaufwerk hinterlegt werden.
Die nötigen Schritte werden im Detail in folgendem Artikel beschrieben.

Aktionsplatzhalter

Aktionen vom Typ Speichern im Dateisystem stellen Aktionsplatzhalter bereit, welche in darauf folgenden Aktionen verwendet werden können.

Standardplatzhalter

[%$<Aktionsname>.SUCCESS%]: Rückgabe ob Aktion erfolgreich ausgeführt wurde. Liefert Boolean (true/false) zurück.
[%$<Aktionsname>.RESULT%]: Rückgabe aller von der Aktion bereitgestellten Ergebnisse in strukturierter Form.

[%$<Aktionsname>.ERROR_CODE%]: Der geworfene Fehler-Code im Fehlerfall der Aktion. Leer wenn kein Fehler aufgetreten ist.
[%$<Aktionsname>.ERROR_MESSAGE%]: Die geworfene Fehler-Nachricht im Fehlerfall der Aktion. Leer wenn kein Fehler aufgetreten ist.

Aktionsspezifische Platzhalter

[%$<Aktionsname>.RESULT.absolutePath%]: Absouluter Pfad zum Verzeichnis, in dem die Dateien gespeichert wurden.
[%$<Aktionsname>.ERROR.message%]: Fehlercode, der zurückgeliefert wird, wenn das Exportverzeichnis nicht erzeugt werden konnte oder die Dateien nicht in das Dateisystem geschrieben werden konnte.