create-file
Mit der Funktion create-file können Sie Streaming-Inhalt für die zukünftige Verwendung in einer Datei speichern. Mit Hilfe der Funktion create-file erstellte Dateien sind nicht temporär. Solche Dateien gehören zum Benutzer und nicht zu FlowForce.
Die Funktion create-file ähnelt insofern der Funktion as-file, als damit die definierte Zieldatei mit dem definierten Streaming-Inhalt erstellt wird, jedoch erstellt create-file keine temporären Dateien. Verwenden Sie /system/create-file, um Streaming-Inhalt, den Sie behalten möchten, zu speichern. Verwenden Sie as-file, um den Streaming-Inhalt als Datei an ein Programm zu übergeben. Dabei kann es sich um eine temporäre, von FlowForce verwaltete Datei handeln.
Als Quellausdruck (siehe Abbildung unten) kann ein beliebiger Ausdruck, dessen Ergebnis ein Stream ist, verwendet werden. Alles, was an die Funktion as-file übergeben werden kann, kann verwendet werden. So könnten Sie z.B. die folgenden Optionen verwenden:
•stdout(result), stderr(result), result(result, name, index) ruft Streams aus Schrittergebnissen ab.
•as2-mdn-serialize(mdn) erzeugt eine serialisierte Version einer MDN.
•mime-flatten(stream) erzeugt einen message/rfc822-Stream aus einem anderen, indem diesem seine MIME Header vorangestellt werden.
•mime-multipart(string, stream*) erzeugt eine MIME Multipart-Struktur als Stream.
•stream-open(filename, contenttype) öffnet eine Datei auf der Festplatte.
•empty-stream() erzeugt einen Stream mit der Länge Null.
•stream-from-string(text, encoding, content-type) kodiert einen String-Wert als Stream.
Parameter
Name | Typ | Beschreibung |
|---|---|---|
Zieldatei | String | Obligatorischer Parameter. Der Name der Datei, in der Stream-Inhalt gespeichert wird. |
Quell-Stream | Stream | Obligatorischer Parameter. Stream-Inhalt, der in einer Datei gespeichert werden soll. |
Ziel überschreiben | Boolean | Optionaler Parameter. Setzen Sie diesen Parameter auf true, wenn Zieldateien desselben Namens überschrieben werden sollen. Der Standardwert ist false. |
Arbeitsverzeichnis | String | Optionaler Parameter. Definiert den Pfad zu dem Verzeichnis, in dem die Zieldatei gespeichert wird. |
Bei Fehler abbrechen | Boolean | Dieser Boolesche Parameter legt fest, was der Rückgabewert der Funktion sein soll, wenn der Auftrag fehlschlägt. Wenn Bei Fehler abbrechen FALSE ist, gibt die Funktion den Booleschen Wert FALSE zurück. Wenn Bei Fehler abbrechen TRUE ist, wird die Ausführung des Auftrags abgebrochen. Der Standardwert ist TRUE. |
Beispiel
In der Abbildung unten sehen Sie ein Beispiel für die create-file-Funktion. Wir möchten eine Datei namens CreateTest.txt erstellen und auf dem Desktop speichern. Dazu verwenden wir die Funktion stream-from-string, welche einen String-Wert als Stream kodiert. Folglich sehen wir, dass unsere neue CreateTest.txt, den String MyFileContent enthält.
| Anmerkung: | Um den Auftrag auszuführen, definieren Sie einen Trigger und/oder starten Sie den Auftrag als Dienst. |
