store
Lädt eine Datei aus einem lokalen Verzeichnis auf einen FTP-Server hoch.
Parameter
Name | Typ | Beschreibung |
|---|---|---|
FTP Server | String | Obligatorischer Parameter. Adresse eines entfernten FTP-Servers als URL oder als IP-Adresse. |
Port | Zahl | Optionaler Parameter. Die Port-Nummer, über die die Verbindung zum FTP-Server hergestellt wird. Der Standardwert ist 21. |
Verzeichnis auf dem Host | String | Optionaler Parameter. Der Name eines Verzeichnisses auf dem remote FTP-Server, in das eine Datei hochgeladen werden soll. |
Login-Anmeldeinformationen | Anmeldeinformationen | Optionaler Parameter. Der Benutzername und das Passwort des FTP-Kontos. Nähere Informationen dazu finden Sie unter Anmeldeinformationen. Lassen Sie diesen Parameter weg, wenn für den FTP-Server keine Anmeldeinformationen benötigt werden. |
Passiven Modus verwenden | Boolean | Optionaler Parameter. Verwenden Sie den passiven Modus, wenn Probleme mit der Verbindung auftreten (z.B. wenn Router oder eine Firewall eine aktive Verbindung verhindern). Der Standardwert ist true. |
SSL/TLS-Verschlüsselung verwenden | String | Optionaler Parameter. Der Standardwert ist Nein. FTP verwendet zur Datenübertragung einen Befehls- und einen Datenkanal. Wenn Sie FTP-Daten ohne Verschlüsselung übertragen möchten, belassen Sie den Standardwert. Setzen Sie den Wert andernfalls auf eine der folgenden Optionen:
•Explizit mit verschlüsseltem Befehlskanal •Explizit mit verschlüsseltem Befehls- und Datenkanal
Wenn Sie eine der beiden obigen Optionen definieren, hängt die Validierung des Server-Zertifikats vom Wert des Parameters Server-Zertifikat überprüfen ab. Die implizite Verschlüsselung gilt als veraltet und wird in FlowForce nicht unterstützt. |
Server-Zertifikat überprüfen | String | Optionaler Parameter. Legt fest, wie FlowForce das Zertifikat des FTP-Servers überprüfen soll. Es stehen die folgenden Optionen zur Verfügung:
•Keine Überprüfung: Es wird jedes FTP-Server-Zertifikat akzeptiert. •Anhand von System-Zertifikatspeicher überprüfen (Standardwert): Unter Windows überprüft FlowForce Server die Zertifikat-Signatur anhand des Zertifikatspeichers des Benutzerkontos, mit dem der Auftrag ausgeführt wird, und anhand des Systemspeichers. Unter Linux verwendet FlowForce Server den normalerweise unter /usr/lib/ssl/cert.pem und /usr/lib/ssl/certs vorhandenen System-Zertifikatspeicher oder den Pfad, auf den die Umgebungsvariablen SSL_CERT_FILE und SSL_CERT_DIR verweisen. •Anhand von ausgewähltem Server-Zertifikat überprüfen: FlowForce vergleicht das Zertifikat des FTP-Servers mit dem im Parameter Server-Zertifikat definierten.
Für diesen Parameter werden ein Server-Zertifikat und eine sichere Verbindung benötigt. Wenn keine sichere Verbindung hergestellt werden kann, schlägt die FTP-Funktion fehl. |
Server-Zertifikat | Zertifikat | Optionaler Parameter. Definiert den Pfad zu einem FlowForce-Zertifikat. Wenn Sie im Parameter Server-Zertifikat überprüfen die Option Anhand von ausgewähltem Server-Zertifikat überprüfen auswählen, wird das FlowForce-Zertifikat anhand des FTP-Server-Zertifikats überprüft. Wenn Sie im Parameter Server-Zertifikat überprüfen Keine Überprüfung oder Anhand von System-Zertifikatspeicher überprüfen auswählen, wird der Server-Zertifikat-Parameterwert ignoriert. |
Quelldatei | String | Obligatorischer Parameter. Der Name einer lokalen Datei, die auf den FTP-Server hochgeladen werden soll.
Bei Verwendung eines relativen Pfads wird dieser anhand des im Parameter Arbeitsverzeichnis definierten Pfads aufgelöst. Bei Verwendung des absoluten Pfads wird der Pfad in Arbeitsverzeichnis ignoriert. |
Zieldatei | String | Obligatorischer Parameter. Der Name der hochgeladenen Datei, die auf dem FTP-Server gespeichert werden soll.
Bei Verwendung eines relativen Pfads wird dieser anhand des im Parameter Verzeichnis auf dem Host definierten Pfads aufgelöst. Bei Verwendung des absoluten Pfads wird der Pfad in Verzeichnis auf dem Host ignoriert. |
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. |
Arbeitsverzeichnis | String | Optionaler Parameter. Definiert das lokale Arbeitsverzeichnis, aus dem eine Datei auf den FTP-Server hochgeladen wird. |
Konto | String | Optionaler Parameter. Der Name des FTP-Kontos des Benutzers, der Zugriff auf die Dateien auf dem Remote Server hat. |
Beispiel
In diesem Beispiel wird beschrieben, wie Sie eine Datei aus einem lokalen Verzeichnis auf einen entfernten FTP-Server hochladen, ohne zum Zeitpunkt der Auftragskonfiguration den Dateinamen und die Dateierweiterung zu kennen.
Einrichten eines Triggers
Um eine Datei hochladen zu können, ohne ihren Namen und ihre Erweiterung zu kennen, muss ein Dateisystem-Trigger definiert werden. Mit dem unten gezeigten Trigger wird das Verzeichnis C:\FlowForce\Upload auf Änderungen überwacht. Jedes Mal, wenn es in diesem Verzeichnis eine Änderung gibt, wird der Auftrag gestartet und der absolute Pfad der Datei, die den Auftrag ausgelöst hat, steht daraufhin im Input-Parameter triggerfile zur Verfügung (Unterabschnitt weiter unten).
Hinzufügen eines Ausführungsschritts
Im Ausführungsschritt unten wird die Funktion store aufgerufen, um eine Datei aus dem lokalen Verzeichnis (C:\FlowForce\Upload) in das Verzeichnis uploads auf dem FTP-Server hochzuladen. Jedes Mal, wenn im lokalen Arbeitsverzeichnis eine Änderung gefunden wird, wird der Auftrag ausgelöst und die Funktion store lädt die Datei, in der die Änderung vorgenommen wurde, auf den FTP-Server hoch. Da wir das lokale Arbeitsverzeichnis bereits angegeben haben, genügt im Parameter Quelldatei der relative Pfad der Trigger-Datei. Für die Zieldatei muss der relative Pfad der Trigger-Datei verwendet werden, damit dieser korrekt anhand des Verzeichnisses auf dem FTP-Server aufgelöst wird.
In den Parametern Quelldatei und Zieldatei verwenden wir die Funktion file-with-extension. Diese extrahiert anhand des absoluten Pfads der Trigger-Datei den Dateinamen und seine Erweiterung. Wäre der Name der Trigger-Datei z.B. C:\FlowForce\Upload\Example.txt, würde der Ausdruck Example.txt zurückgeben.
