Workflow „SFTP File Transfer“
Das Aktivitätspaket „SFTP File Transfer“ enthält einen bereichsbezogenen Workflow mit mehreren Aktivitäten zum Verwalten von Dateien auf SFTP-Servern.
Auf den Workflow zugreifen
- Navigieren zu und wählen Sie die Registerkarte Workflows.
- Klicken Sie auf den Workflow „SFTP File Transfer“, um ihn zu öffnen.
- Klicken Sie auf das Informationssymbol im Workflow-Header, um das Dialogfeld mit den Eigenschaften anzuzeigen.
Eingabevariablen
| Variable | Beschreibung | Standardwert |
|---|---|---|
| Quellhost | Name oder IP-Adresse des Servers, auf dem sich die Dateien befinden, die Sie verschieben möchten | |
| Quellport | Portnummer, die zur Kommunikation mit dem Quellserver verwendet werden soll | 22 |
| Quellverzeichnis | Vollständiger Pfad zu dem Verzeichnis, in dem sich die Quelldateien befinden | |
| Quelldateien | Namen der zu verschiebenden Quelldateien. Trennen Sie die Dateinamen in dieser Liste durch Semikolons. Dieses Feld unterstützt die Verwendung von Platzhaltern. Informationen dazu, wie die Werte in diesem Feld von Optionen in anderen Feldern beeinflusst werden, finden Sie im Abschnitt unterhalb der Tabelle. | |
| Ausgeschlossene Dateien | Namen bestimmter Quelldateien, die von der Verschiebung ausgeschlossen werden sollen. Das System verschiebt alle anderen Dateien, die sich im Quellverzeichnis oder in den Unterordnern befinden. Trennen Sie die Dateinamen in dieser Liste durch Semikolons. Dieses Feld unterstützt die Verwendung von Platzhaltern. Informationen dazu, wie die Werte in diesem Feld von Optionen in anderen Feldern beeinflusst werden, finden Sie im Abschnitt unterhalb der Tabelle. | |
| Zielhost | Name oder IP-Adresse des Servers, auf den die Dateien verschoben werden | |
| Zielport | Portnummer, die zur Kommunikation mit dem Zielhost verwendet werden soll | 22 |
| Datums-/Zeitformat | Zeitstempelformat, das angewendet werden soll, wenn die Variable $[DateTime] im Feld Zielverzeichnis oder Zieldateien verwendet wird. Das System verwendet die aktuelle Uhrzeit der Instanz, um Zeitstempelwerte zu erstellen. |
JJJJ-MM-TT |
| Zielverzeichnis | Pfad zu dem Verzeichnis auf dem Zielhost, in das die Dateien verschoben werden. Sie können ein Zielverzeichnis angeben, dessen Name den Zeitstempel enthält, indem Sie die Variable $[DateTime] zum Verzeichnisnamen hinzufügen. Beispielsweise können Sie diesen Pfad zu einem Zielverzeichnis eingeben: /user/jacinto.gawron/documents/projects_$[DateTime]. Damit wird das Verzeichnis projects_20150505 erstellt. Wenn die Zeitstempelvariable angegeben wird, verwendet das System das Format, das im Feld Datums-/Zeitformat angegeben ist. |
|
| Zieldatei | Format, das für Zieldateinamen verwendet werden soll, wenn ein Zeitstempel hinzugefügt wird. Sie können das System so konfigurieren, dass der Zeitstempel dem Dateinamen als Präfix hinzugefügt oder in den Namen eingefügt wird, indem Sie die folgenden Variablen verwenden:
Ein Zieldateiname mit dem Zeitstempel als Präfix wird wie folgt ausgedrückt: Ein Zieldateiname, in dem der Zeitstempel eingefügt ist, wird folgendermaßen ausgedrückt: |
|
| Verschiebungsbedingungen anwenden | Checkbox, um Bedingungen auf die Dateiübertragung anzuwenden. Wenn dieses Kontrollkästchen aktiviert ist, werden zusätzliche Felder zum Festlegen von Bedingungen angezeigt. | falsch |
| Mindestdateigröße, in Byte | Bedingung, die die Mindestgröße einer Zieldatei definiert. Mit dieser Einstellung können Sie feststellen, ob die Datei gültig ist. Dieses Feld erscheint, wenn die Checkbox Verschiebungsbedingungen anwenden aktiviert ist. | 0 |
| Maximale Dateigröße, in Byte | Bedingung, die die maximale Größenanforderung einer Zieldatei definiert. Dieses Feld erscheint, wenn die Checkbox Verschiebungsbedingungen anwenden aktiviert ist. | –1 |
| Datei ist nicht älter als | Bedingung, die das früheste zulässige Datum für den Altersbereich dieser Datei festlegt. Der Bereich beginnt am angegebenen Datum um 00:00 Uhr (Mitternacht). Dieses Feld erscheint, wenn die Checkbox Verschiebungsbedingungen anwenden aktiviert ist. | |
| Datei ist nicht neuer als | Bedingung, die das späteste zulässige Datum für den Altersbereich dieser Datei festlegt. Der Bereich endet am angegebenen Datum um 23:59 Uhr. Dieses Feld erscheint, wenn die Checkbox Verschiebungsbedingungen anwenden aktiviert ist. | |
| Unterordner einbeziehen | Aktivieren Sie die Checkbox, um die Dateien aus Unterordnern im Quellverzeichnis zu verschieben. Informationen dazu, wie sich Ihre Auswahl auf andere Felder im Formular auswirkt, finden Sie im Abschnitt unterhalb der Tabelle. | |
| Verschiebungsbefehl | Reihenfolge, in der die Dateien von der Quelle zum Ziel verschoben werden. Die möglichen Optionen lauten:
|
|
| Sortierreihenfolge | Reihenfolge, in der die Dateien im Zielverzeichnis anhand der im Feld Verschiebungsbefehl ausgewählten Option sortiert werden. Sortieroptionen sind Aufsteigend und Absteigend. | desc |
| Maximale Anzahl Neuversuche | Anzahl der Versuche, die die Aktivität unternehmen kann, um eine Verbindung zum Zielhost herzustellen oder eine Datei zu verschieben, bevor eine Zeitüberschreitung auftritt. Wenn das Wiederholungslimit zum Verschieben einer Datei oder zum Herstellen einer Verbindung zum Host überschritten wird, protokolliert das System einen Fehler. Wenn die maximale Anzahl von Fehlern nicht überschritten wird, versucht das System, erneut eine Verbindung herzustellen oder die nächste angegebene Datei zu verschieben. | 2 |
| Zeit zwischen Neuversuchen, in Sekunden | Zeit in Sekunden zwischen Wiederholungsversuchen, um eine Verbindung zum Ziel herzustellen oder eine Datei zu verschieben. | 10 |
| Maximale Anzahl Fehler | Akzeptable Anzahl von Wiederholungen, in denen das System keine Verbindung zum Zielrechner herstellen oder eine Datei verschieben kann, bevor abgebrochen wird. Ein Fehler tritt auf, wenn die Anzahl der konfigurierten Wiederholungen überschritten wird. Bei Verwendung der Standardeinstellungen tritt ein Fehler auf, wenn das System nach zwei erneuten Versuchen keine Verbindung zum Ziel herstellen oder eine Datei verschieben kann. | 0 |
| Doppelte Datei, Aktion | Aktion, wenn eine zu verschiebende Datei bereits im Zielverzeichnis vorhanden ist. Die Auswahlmöglichkeiten sind:
|
overwrite |
| Dateiattribute beibehalten | Aktivieren Sie die Checkbox, um den Zeitstempel und die Modusinformationen aus den Quelldateien für die kopierten Dateien zu verwenden. Wenn dieses Kontrollkästchen deaktiviert ist, haben die kopierten Dateien einen aktuellen Zeitstempel und Modus. Hinweis: Dieser Zeitstempel ist ein Dateiattribut und wird nicht an den Dateinamen angehängt. |
falsch |
| Bei Erfolg Dateien aus der Quelle verschieben | Aktivieren Sie die Checkbox, um Originaldateien aus dem Quellverzeichnis zu löschen, wenn sie an den neuen Speicherort kopiert werden. Deaktivieren Sie dieses Kontrollkästchen, um die Quelldateien an ihrem aktuellen Speicherort auf dem Quellhost zu behalten. | falsch |
| Bei Fehler, verschobene Dateien am Ziel belassen | Aktivieren Sie die Checkbox, um alle erfolgreich verschobenen Dateien im Ziel beizubehalten, auch wenn die gesamte Dateiübertragung fehlgeschlagen ist. Wenn dieses Kontrollkästchen deaktiviert ist, entfernt das System bei einem allgemeinen Fehler alle erfolgreich übertragenen Dateien aus dem Ziel. | wahr |
| Anmeldeinformations-Tag für Quelle | Spezifische Aliasse für Anmeldeinformationen für Orchestration-Aktivitäten, die diese Aktivität zum Ausführen von SSH-Befehlen auf dem Quellhost verwenden muss. | |
| Anmeldeinformations-Tag für Ziel | Spezifisches Anmelde-Tag, das diese Aktivität verwenden muss, um SSH-Befehle auf dem Zielhost auszuführen. |
Logik der Dateiauswahl
Bei der Auswahl der zu verschiebenden Dateien vom Quellhost verwendet das System diese Logik:
- Wenn die Felder Quelldateien und Ausgeschlossene Dateien leer sind, verschiebt das System alle Dateien im Quellverzeichnis.
- Wenn die Checkbox Unterordner einbeziehen aktiviert ist, bestehen folgende Abhängigkeiten:
- Wenn keine Dateien in den Felder Quelldateien und Ausgeschlossene Dateien angegeben sind, verschiebt das System alle Dateien im Quellverzeichnis und alle Dateien in allen Unterordnern des Quellverzeichnisses.
- Wenn das Feld Quelldateien Dateinamen enthält, verschiebt das System diese Dateien aus dem Quellverzeichnis und allen seinen Unterordner.
- Wenn das Feld Ausgeschlossene Dateien Dateinamen enthält, verschiebt das System alle Dateien aus dem Quellverzeichnis und seinen Unterordnern mit Ausnahme der ausgeschlossenen Dateien.
- Wenn die Checkbox Unterordner einbeziehen deaktiviert ist, sucht das System nur im Quellverzeichnis nach Dateien, die verschoben oder ausgeschlossen werden sollen.