retrieve

www.altova.com Dieses Kapitel drucken Vorherige Seite Eine Ebene nach oben Nächste Seite

Startseite >  Vordefinierte Funktionen > /system/ftp >

retrieve

Vollständiger Pfad: /system/ftp/retrieve

 

Ruft eine Datei vom FTP-Server ab.

 

Diese Funktion gibt den Booleschen Wert TRUE zurück, wenn die Ausführung erfolgreich war. Wenn die Ausführung des Auftrags fehlschlägt, hängt das Ergebnis vom Wert des Parameters Bei Fehler abbrechen ab. Es gibt folgende Möglichkeiten:

 

Wenn der Parameter Bei Fehler abbrechen TRUE ist (Standardwert), so wird die Ausführung des Auftrags abgebrochen. In diesem Fall können Fehler dennoch mittels geschützter Blocks behandelt werden (siehe Behandlung von Fehlern in Schritten).
Wenn der Parameter Bei Fehler abbrechen FALSE ist, so gibt die Funktion FALSE zurück.

 

Parameter

Name

Typ

Beschreibung

FTP Server

string

Adresse des entfernten FTP-Servers, entweder als URL oder als IP-Adresse

 

Obligatorischer Parameter.

Port

number

Die Port-Nummer, über die die Verbindung zum FTP-Server hergestellt wird. Der Standardwert ist 21.

Verzeichnis auf dem Host

string

Der Name des Verzeichnisses auf dem Host-Rechner, aus dem Sie eine Datei abrufen möchten

 

Optionaler Parameter.

Login-Anmeldeinformationen

credential

Der Benutzername und das Passwort des FTP-Kontos in Form eines FlowForce-Anmeldedatensatzes, siehe Anmeldeinformationen.

 

Lassen Sie diesen Parameter weg, wenn für den FTP-Server keine Anmeldeinformationen benötigt werden.

Passiven Modus verwenden

boolean

Verwenden Sie den passiven Modus, wenn Probleme mit der Verbindung auftreten (z.B. wenn Router oder eine Firewall eine aktive Verbindung verhindern).

Quelldatei

string

Der Name des abzurufenden Verzeichnisses.

 

Obligatorischer Parameter.

Zieldatei

string

Der Name, den die abgerufene Datei erhalten soll.

 

Obligatorischer Parameter.

Ziel überschreiben

boolean

Bei true wird die Zieldatei überschrieben. Der Standardwert ist false.

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

Definiert das Arbeitsverzeichnis des Auftrags (z.B. c:\irgendeinVerzeichnis)). Bei Verwendung relativer Pfade werden diese anhand des Arbeitsverzeichnisses aufgelöst.

Konto

string

Der Name des FTP-Kontos des Benutzers, der Zugriff auf die Dateien auf dem Remote Server hat.

 

Optionaler Parameter.


© 2019 Altova GmbH