FTP

Zweck

Das FTP-Element bietet ein umfassendes Werkzeug zur Verwaltung von Dateien auf einem entfernten Server über die Protokolle FTP oder SFTP . Es ermöglicht Ihnen, Dateien und Verzeichnisse aufzulisten, hochzuladen, herunterzuladen, zu löschen und deren Existenz zu überprüfen.

• Dieses Element ist unerlässlich für jeden Workflow, der Dateien mit externen Systemen oder älteren Servern austauschen muss, die FTP/SFTP für die Datenübertragung verwenden.

Anwendungsfälle:

• Herunterladen täglicher Bestelldateien vom FTP-Server eines Lieferanten.

• Hochladen von generierten Berichten oder Datenexporten auf den SFTP-Server eines Partners.

• Auflisten aller Dateien in einem Verzeichnis, um sie in einer Schleife zu verarbeiten.

• Löschen von verarbeiteten Dateien von einem FTP-Server zur Bereinigung.

---

Praktische Anwendungshinweise

• SFTP wird empfohlen: Verwenden Sie nach Möglichkeit das SFTP-Protokoll, da es durch die Verschlüsselung sicherer ist als Standard-FTP.

• Kopieren vs. Verschieben (Löschen):

  • „Kopier“-Aktionen (Herunterladen, Hochladen) lassen die Quelldatei unberührt.

  • „Verschiebe“-Aktionen (Herunterladen und löschen, Hochladen und löschen) entfernen die Quelldatei nach erfolgreicher Übertragung.

• Verzeichnisoperationen: Wenn Sie herunterladen oder löschen und einen Pfad zu einem Verzeichnis angeben, wird die Aktion auf alle Dateien innerhalb dieses Verzeichnisses angewendet.

• Testen: Verwenden Sie die Schaltfläche „Verbindung testen“, um Ihre Anmeldeinformationen und Servereinstellungen zu überprüfen, bevor Sie den Flow ausführen.

---

Konfigurationsoptionen

Die Konfiguration unterteilt sich in die Verbindungsdetails des Servers und die spezifische auszuführende Aktion.

Verbindungseinstellungen

Einstellung	Beschreibung	Hinweise
Protokoll	Wählen Sie zwischen FTP und dem sicheren SFTP.	SFTP wird empfohlen.
Host / Port	Die Serveradresse und der Port (Standard für FTP ist 21).
Benutzername / Passwort	Die Anmeldeinformationen für den Server.
SSL	Für FTP: Gibt an, ob eine explizite SSL-Verbindung (FTPS) verwendet werden soll.
Passiv	Für FTP: Gibt an, ob der passive Modus verwendet werden soll (normalerweise empfohlen).
Root	Ein optionales Startverzeichnis auf dem entfernten Server. Alle anderen Pfade sind relativ dazu.
PrivateKey / Passphrase	Für SFTP: Kann anstelle eines Passworts zur Authentifizierung verwendet werden.

Aktionstyp

Das Dropdown-Menü Typ bestimmt die auszuführende Dateioperation.

Typ	Beschreibung
Dateien auflisten	Listet Dateien und Verzeichnisse auf dem entfernten Server auf, die einem Muster entsprechen.
Herunterladen	Kopiert Dateien vom entfernten Server in den lokalen Speicher.
Herunterladen und löschen	Lädt Dateien herunter und löscht sie anschließend vom entfernten Server.
Hochladen	Kopiert lokale Dateien auf den entfernten Server.
Hochladen und löschen	Lädt lokale Dateien hoch und löscht anschließend die lokalen Kopien.
Löschen	Löscht eine Datei oder ein Verzeichnis auf dem entfernten Server.
Existiert	Prüft, ob eine Datei oder ein Verzeichnis auf dem entfernten Server existiert.

Eingaben nach Aktionstyp

Aktionstyp	Erforderliche Eingaben	Beispiel
Dateien auflisten	Muster	/outgoing/*.csv
Hochladen...	Dateipfad (Lokal), FTP Zielpfad (Entfernt)	/lokal/bericht.csv zu /upload/berichte
Herunterladen...	Dateipfad (Entfernt), Speicherpfad (Lokal)	/server/bestellung.txt zu /imports/bestellungen
Löschen / Existiert	Dateipfad (Entfernt)	/server/alt/datei.log

---

Eingabe-/Ausgabe-Erwartungen

Eingabe

Variiert je nach ausgewähltem Typ, wie in der Tabelle oben beschrieben.

Ausgabe

Es erzeugt eine einzige files-Variable, deren Inhalt von der durchgeführten Aktion abhängt:

Aktionstyp	Inhalt der Ausgabe files	Format
Dateien auflisten	Ein JSON-Array von Dateipfaden, die dem Muster entsprechen.	JSON-Array.
Existiert	Ein Array, das ein Objekt mit dem Dateipfad als Schlüssel und dem Wert true oder false enthält.	JSON-Array von Objekten.
Alle anderen Aktionen	Ein JSON-Array, das die Dateipfade aller erfolgreich verarbeiteten Dateien auflistet.	JSON-Array.

---