Workflow-Aktion: Speichern im Dateisystem

Geändert am Do, 25 Jan um 5:32 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

Um die Speicherung von Dateien auf ein Netzlaufwerk durchzuführen, 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 der Netzwerkpfad anstatt des Netzwerkbuchstaben zu verwenden, also im Grunde die Angabe welche Sie bei der Einbindung des Neztlaufwerks angegeben haben, zum Beispiel:
\\mein-formcycle-server\data\zielordner
Oft besteht dann noch das Problem, dass die Berechtigung fehlen, um in das Netzlaufwerk zu schreiben. Dazu muss dem Tomcat die Berechtigung erteilt werden. Damit dies möglich ist, muss der Tomcat mit einem entsprechnden Benutzer gestartet werden, weil einem Lokalen Dienst keine Rechte zugewiesen werden können.
Die nötigen Schritte werden in folgendem Artikel beschrieben.
Ist die Umstellung des Benuters erfolgt, ist noch die Schreib-Berechtigung am Netzlaufwerk zu hinterlegen.

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.