Zum Hauptinhalt springen

S-FTP In

Aktuelle Konfiguration des Tasks „S-FTP In“ im Workflow Designer

Der Task „S-FTP In“ ermöglicht den sicheren Download eines oder mehrerer Dateien von einem Remote-Server auf das lokale System mithilfe des Protokolls SFTP (Secure File Transfer Protocol). Er ist eine entscheidende Komponente zur Automatisierung der Daten- oder Dateierfassung von externen Systemen, wodurch diese für die Verarbeitung im Workflow verfügbar gemacht werden.

Konfiguration​

Die Konfiguration des Tasks erfolgt durch die Definition der Zugangsdaten und die Spezifizierung dessen, was heruntergeladen werden soll. Die Konfigurationsfelder des Tasks können manuell oder über Workflow-Parameter und -Variablen befüllt werden.

Authentifizierung​

Definiert die Methode, mit der sich der Workflow beim SFTP-Server authentifiziert.

  • Authentifizierungsmethode: Es können folgende Optionen gewählt werden:
  • Passwort: Die Authentifizierung erfolgt über das dem Benutzer zugeordnete Passwort.
  • SSH-Schlüssel: Die Authentifizierung erfolgt über ein SSH-Schlüsselpaar (öffentlich/privat).
  • Host: Die IP-Adresse oder der DNS-Name des SFTP-Servers, mit dem verbunden werden soll.
  • Port: Der Kommunikationsport für die SFTP-Verbindung. Der Standardwert ist 22.
  • Benutzer: Der Benutzername für die Verbindung.

Datei von Remote herunterladen​

Gibt die Download-Methode an.

  • Download-Modus: Es können zwei Optionen gewählt werden:
  • Einzelne Datei: Ermöglicht den Download einer spezifischen einzelnen Datei.
  • Gesamter Verzeichnis: Ermöglicht den Download aller Dateien, die sich in einem bestimmten Remote-Ordner befinden.
  • Dateiname: Dieses Feld ist nur sichtbar, wenn der Modus „Einzelne Datei“ gewählt wird. Hier muss der exakte Name der zu downloadenden Datei eingegeben werden.
  • Remote-Pfad: Der Pfad des Verzeichnisses auf dem SFTP-Server, aus dem die Dateien heruntergeladen werden sollen. Wird eine einzelne Datei heruntergeladen, ist dies der Pfad des Ordners, der sie enthält.

Ausgabe-Parameter​

Nachdem der Download-Vorgang versucht wurde, stellt der Task die folgenden Ausgabe-Parameter bereit, die detaillierte Informationen über das Ergebnis und die heruntergeladenen Dateien liefern.

  • result: Enthält eine Textnachricht, die das Ergebnis des Vorgangs beschreibt.
  • Beispiel Erfolg (Einzeldatei): „Übertragung der Datei [NomeFile] erfolgreich!“
  • Beispiel Erfolg (Verzeichnis): „Übertragung der Dateien aus dem Verzeichnis [PathRemoto] erfolgreich!“
  • Beispiel Fehler: „Authentifizierungsfehler mit Benutzer [NomeUtente]“ oder „Fehler bei der Übertragung der Datei [NomeFile]!“
  • ftpInFile: Enthält den Namen der heruntergeladenen Datei.
  • ftpInPath: Gibt den Pfad des Remote-Verzeichnisses zurück, aus dem der Download durchgeführt wurde.
  • resultJson: Stellt das Ergebnis der Task-Ausführung im JSON-Format dar und enthält allgemeine Informationen, Konfigurationen und Details zur Ausführung.

Wichtige Hinweise

  • Der Modus „Gesamter Verzeichnis“ lädt die Dateien auf der obersten Ebene des angegebenen Ordners herunter, lädt jedoch nicht rekursiv den Inhalt möglicher Unterordner.