Um mit einem einzelnen Secure File Transfer Protocol (SFTP)-Server als Teil einer Kette zu interagieren, fügen Sie einen Schritt hinzu, der einen SFTP-Verbindungsbefehl enthält.
Hinweis: Um diesen Connector zu verwenden, muss Ihre Organisation Zugang zu einem eigenen SFTP-Server haben. Workiva hostet nicht und stellt auch keine SFTP-Server zur Verfügung.
Um diese Befehle zu aktivieren, konfiguriert ein IT-Administrator zunächst eine SFTP-Verbindung.
Löschen
Um Dateien und Ordner auf dem SFTP-Server zu löschen, verwenden Sie den Befehl Delete.
Eigenschaften
| Eigenschaft |
Einzelheiten |
| Datei(en) |
Geben Sie die zu löschenden Dateien und Verzeichnisse ein. Um mehrere Dateien und Ordner zu finden, verwenden Sie das Platzhalterzeichen *. |
| Ordner überspringen |
Um Ordner zu ignorieren, die mit der/den angegebenen Datei(en) übereinstimmen, markieren Sie dieses Feld. |
| Rekursiv |
Aktivieren Sie dieses Kontrollkästchen, um die angegebenen Ordner und ihren gesamten Inhalt zu löschen. |
Ausgaben
| Ausgabe |
Art der Ausgabe |
| Gelöschte Dateien |
JSON |
| Gelöschte Ordner |
JSON |
| Alle Elemente gelöscht |
JSON |
Codes beenden
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolgreich |
Erfolgreich |
| 2 |
Fehler |
Aufgabe fehlgeschlagen |
| 6 |
Fehler |
Verzeichnisse, die zum Löschen markiert waren, wurden nicht übersprungen, und rekursiv war nicht eingestellt |
Datei herunterladen
Um eine Datei vom SFTP-Server herunterzuladen, verwenden Sie den Befehl Download File.
Eigenschaften
| Eigenschaft |
Einzelheiten |
| Datei |
Geben Sie den Namen der Datei ein, die vom SFTP-Server abgerufen werden soll. Hinweis: Wenn Sie diesen Befehl mit einer Gruppeniteration verwenden, verwenden Sie die Variable Remote Files Iteration des Befehlsiterators, um die Datei zu identifizieren. |
| Paralleler Download |
Aktivieren Sie dieses Kontrollkästchen, um parallele Downloads zu ermöglichen, z. B. für eine große Datei. |
| Anzahl der Threads |
Wenn Sie Paralleler Download wählen, legen Sie fest, wie viele Threads parallel laufen sollen. Wenn Sie unsicher sind, belassen Sie den Standardwert von 3. |
Ausgaben
| Ausgabe |
Art der Ausgabe |
| Heruntergeladene Datei |
Datei |
Codes beenden
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolgreich |
Erfolgreich |
| 2 |
Fehler |
Aufgabe fehlgeschlagen |
Get
Um Dateien vom SFTP-Server abzurufen, verwenden Sie den Befehl Get.
Eigenschaften
| Eigenschaft |
Einzelheiten |
| Datei(en) |
Geben Sie die abzurufenden Dateien ein. Um mehrere Dateien abzugleichen, verwenden Sie das Platzhalterzeichen *. |
| Ziel |
Geben Sie den Zielort für die Dateien an. Um mehrere Dateien abzurufen, geben Sie ein Verzeichnis an. |
Ausgaben
| Ausgabe |
Art der Ausgabe |
| Abgerufene Dateien |
JSON |
| Abgerufene Dateien (Text) |
Zeichenfolge |
Codes beenden
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolgreich |
Erfolgreich |
| 2 |
Fehler |
Aufgabe fehlgeschlagen |
| 6 |
Fehler |
Verzeichnisse wurden nicht übersprungen und zum Löschen markiert, und rekursiv war nicht eingestellt |
Verzeichnis auflisten
Um die Dateien in einem Verzeichnis auf dem SFTP-Server aufzulisten, verwenden Sie den Befehl List Directory.
Eigenschaften
| Eigenschaft |
Einzelheiten |
| Verzeichnis |
Geben Sie das Verzeichnis mit dem aufzulistenden Inhalt ein. Um mehrere Dateien und Ordner innerhalb des Verzeichnisses aufzulisten, verwenden Sie das Platzhalterzeichen *. Hinweis: Wenn Sie diesen Befehl verwenden, um Dateien für einen späteren iterativen Befehl Datei herunterladen aufzulisten, geben Sie den Namen der herunterzuladenden Datei an. Wenn sich der Name bei jeder Iteration ändert, z. B. basierend auf einem Datum oder Zeitstempel, fügen Sie das Platzhalterzeichen * ein. |
| Detailstufe |
Wählen Sie die Detailebene aus, die für die Dateien und Ordner angezeigt werden soll:
- Kurz, nur für die Namen der Dateien und Verzeichnisse
- Vollständige, für die Namen und zusätzliche Informationen, einschließlich der Eigentumsverhältnisse und Genehmigungen
|
Ausgaben
| Ausgabe |
Art der Ausgabe |
| Entfernte Dateien |
JSON |
| Details zu entfernten Dateien |
JSON (file)
Mit Wirkung vom 11. September 2025 enthält dies ein JSON-Array von Dateien mit den folgenden Feldern:
- modifiedTime = Zeitpunkt der letzten Änderung der SFTP-Datei
- mode = Dateimodus
- remoteFile = Pfad zu der entfernten Datei (dies entspricht der anderen Ausgabe)
- accessedTime = letzter Zugriff auf die SFTP-Datei
Beispiel:
[{"modifiedTime": "Wed Sep 10 03:15:15 UTC 2025", "size": "60", "mode":"-rwxrwxr-x", "remoteFile":"/tmp/somefile.txt", "accessTime": "Wed Sep 10 03:15:15 UTC 2025"},{"modifiedTime": "Wed Sep 10 02:37:36 UTC 2025", "size": "60", "mode": "drwxrwxr-x", "remoteFile":"/tmp/someDir", "accessTime": "Wed Sep 10 02:37:36 UTC 2025"}]
|
Codes beenden
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolgreich |
Erfolgreich |
| 2 |
Fehler |
Aufgabe fehlgeschlagen |
| 5 |
Fehler |
Das angegebene Verzeichnis wurde nicht gefunden |
Verzeichnis erstellen
Um ein neues Verzeichnis auf dem SFTP-Server zu erstellen, verwenden Sie den Befehl Make Directory.
Eigenschaften
| Eigenschaft |
Einzelheiten |
| Verzeichnis |
Geben Sie das zu erstellende Verzeichnis auf dem SFTP-Server an. |
| Rekursiv |
Aktivieren Sie dieses Kontrollkästchen, um den gesamten Pfad des Verzeichnisses zu erstellen, wenn er nicht existiert. |
Ausgabe
Keine
Codes beenden
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolgreich |
Erfolgreich |
| 2 |
Fehler |
Aufgabe fehlgeschlagen |
| 4 |
Fehler |
Fehler beim Erstellen des angegebenen Verzeichnisses |
| 6 |
Erfolgreich |
Verzeichnis existiert bereits |
Verschieben
Um Dateien auf dem SFTP-Server zu verschieben, verwenden Sie den Befehl Move.
Eigenschaften
| Eigenschaft |
Einzelheiten |
| Datei(en) |
Geben Sie die zu verschiebenden Dateien ein. Um mehrere Dateien und Ordner zu finden, verwenden Sie das Platzhalterzeichen *. |
| Ziel |
Geben Sie den Zielort für die Dateien an. Um mehrere Dateien zu verschieben, geben Sie ein Verzeichnis an. |
Ausgaben
| Ausgabe |
Art der Ausgabe |
| Verschobene Dateien |
JSON |
| Verschobene Dateien (Text) |
Zeichenfolge |
Codes beenden
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolgreich |
Erfolgreich |
| 2 |
Fehler |
Aufgabe fehlgeschlagen |
| 4 |
Fehler |
Wenn Sie mehrere Dateien verschieben, muss das Ziel ein bestehendes Verzeichnis sein |
| 5 |
Fehler |
Keine Dateien mit den angegebenen Quelldateien gefunden |
Put
Um Dateien auf den SFTP-Server hochzuladen, verwenden Sie den Befehl Put.
Eigenschaften
| Eigenschaft |
Einzelheiten |
| Datei(en) |
Geben Sie die hochzuladenden Dateien ein. Um mehrere Dateien und Ordner zu finden, verwenden Sie das Platzhalterzeichen *. |
| Ziel |
Geben Sie den Zielort für die Dateien an. Um mehrere Dateien hochzuladen, geben Sie ein Verzeichnis an. |
Ausgaben
| Ausgabe |
Art der Ausgabe |
| Entfernte Dateien |
JSON |
| Entfernte Dateien (Text) |
Zeichenfolge |
Codes beenden
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolgreich |
Erfolgreich |
| 2 |
Fehler |
Aufgabe fehlgeschlagen |
| 6 |
Fehler |
Verzeichnisse wurden nicht übersprungen und zum Löschen markiert, aber rekursiv war nicht eingestellt |