Beispiele für die Verwendung von Dateiübertragungsprotokollen in Frends-Prozessen
RGeschrieben vonRiku Virtanen Vor über einer Woche aktualisiertTable of contentsSo verwenden Sie SFTP- und FTP/S-Aufgaben in Ihren Prozessen
Um diese Aufgaben in Ihren Prozessen verwenden zu können, müssen Sie sie zunächst in Ihre Frends importieren. Die Aufgaben sind alle in ihren eigenen Paketen Frends.SFTP und Frends.FTP enthalten, müssen aber separat importiert werden. Dies ist ganz einfach über die Aufgabenansicht möglich, indem Sie nach Paketen suchen. Für FTP-Aufgaben müssen Sie Frends.FTP durchsuchen und die dort aufgelisteten Aufgaben importieren.
Nachdem wir die Aufgaben erfolgreich importiert haben, können wir einige Anwendungsfälle durchgehen, wie Sie sie in Ihren Prozessen verwenden können.
Bewährte Methoden
SFTP- und FTP-Übertragungen sind normalerweise wiederholbare Vorgänge. Aus diesem Grund wird empfohlen, Unterprozesse zu erstellen, um Dateien über eine SFTP- oder FTP-Verbindung zu übertragen.
Bei allen Dateiübertragungen können Verbindungsprobleme auftreten, die in der Aufgabe selbst nicht berücksichtigt werden. Sie können diese Probleme beheben, indem Sie in den erweiterten Einstellungen der Aufgabe die Option „Bei Fehler erneut versuchen“ aktivieren. Es wird empfohlen, diese Option zu verwenden, damit die Aufgabe die Ausführung wiederholen kann, wenn Fehler von der Aufgabe ausgegeben werden. Beachten Sie, dass die Option „Bei Fehler Fehler ausgeben“ auf der Registerkarte „Optionen“ der Aufgabe aktiviert sein muss, damit dies funktioniert.
Einfache Überweisung
Der einfachste Anwendungsfall für die Übertragung von Dateien über eine SFTP-Verbindung wird mit den Aufgaben „DownloadFiles“ und „UploadFiles“ durchgeführt. Es wird empfohlen, die Implementierung in einem Unterprozess durchzuführen, da die Übertragung dann in mehreren Situationen dupliziert werden kann.
Zuerst müssen wir die Trigger-Parameter festlegen, die vom Hauptprozess vorgegeben werden. Diese Parameter können dann in der SFTP-Aufgabe verwendet werden. Beachten Sie, dass Sie alle erforderlichen Attribute als Trigger-Parameter festlegen müssen, die dann mit der SFTP-Aufgabe verwendet werden. Normalerweise benötigen Sie mindestens die Serveradresse, die Portnummer (falls mehrere verschiedene Ports verwendet werden) und Anmeldeinformationen zur Authentifizierung. Außerdem müssen Sie Quell- und Zielinformationen der zu übertragenden Datei(en) angeben. Wenn diese Trigger-Parameter festgelegt sind, können wir sie in der SFTP-Aufgabe verwenden, indem wir sie mit der Referenz referenzieren.#trigger.data.ParameterNameSie können dann in der Aufgabe konfigurieren, wie die Übertragung durchgeführt werden soll.
Die Aufgabe kann durch Befolgen der vorherigen Module konfiguriert werden. Da die Aufgaben zur Dateiübertragung fehleranfällig sind, z. B. Verbindungsfehler, wird empfohlen, bei den Aufgaben eine Fehlerbehandlung zu verwenden.
Übertragen einer Datei von einem SFTP-Server auf einen anderen
Manchmal müssen Dateien von einem SFTP-Server auf einen anderen übertragen werden. Ähnlich wie beim ersten Anwendungsfall wird auch hier empfohlen, dies in einem Unterprozess durchzuführen. Sie müssen also die Parameter des Triggers so konfigurieren, dass alle erforderlichen Werte übernommen und an die Tasks übergeben werden. Es wird empfohlen, ein Scope-Element zu verwenden, um die SFTP-Tasks einzuschließen, damit alle in den Tasks auftretenden Fehler vom gleichen Catch-Element abgefangen und im Fehlerhandler behandelt werden können. Auf diese Weise können wir die Unterprozesse in unserem Hauptprozess verwenden und die Dateiübertragung abwickeln, ohne einen neuen erstellen zu müssen.
SFTP-Aufgaben im bedingten Trigger
Ein großartiger Anwendungsfall für die SFTP.ListFiles-Aufgabe ist die Verwendung in einem bedingten Trigger. Im Moment hat Frends bereits einen Datei-Trigger, der zum Abfragen bestimmter lokaler Verzeichnisse oder Netzwerklaufwerke verwendet werden kann, aber wenn Sie ein Verzeichnis auf einem SFTP-Server abfragen müssen, sieht die Sache etwas anders aus. Glücklicherweise kommt SFTP.ListFiles zur Rettung. Um die Aufgabe als bedingten Trigger zu verwenden, müssen wir zuerst einen Unterprozess erstellen, der die Abfragefunktion handhabt. Denken Sie daran, den Unterprozess so allgemein wie möglich zu gestalten, damit er mit mehreren Prozessen und verschiedenen Servern verwendet werden kann. Der eigentliche Unterprozess kann ziemlich einfach sein. Das Einzige, was Sie brauchen, ist die SFTP.ListFiles-Aufgabe und eine ganze Reihe von Parametern für Ihren manuellen Trigger. Hier ist ein Beispiel für diesen Anwendungsfall:
Die Parameter, die Sie für den Unterprozess benötigen, sind Quellverzeichnis, Dateimaske, Zielverzeichnis, Serveradresse, Benutzername und Passwort. In einigen Fällen können auch andere Parameter verwendet werden, wenn andere Optionen für die Aufgabe angegeben werden müssen. In diesem Fall können Sie einfach den bereits erstellten Unterprozess ändern und die Trigger-Referenzen hinzufügen (#trigger.data.ParameterName) zu den Parametern der Aufgabe.
Multifunktionaler Transfer-Teilprozess
Wenn Sie mit Ihren Prozessen mehrere verschiedene Übertragungen durchführen müssen, ist es manchmal sinnvoller, einen multifunktionalen Übertragungsunterprozess zu erstellen, der die Übertragungsfunktionen übernimmt, unabhängig davon, ob die Übertragung über SFTP- oder FTP-Server erfolgt.
Damit dies möglich ist, müssen Sie alle möglichen Einstellungen für den manuellen Trigger festlegen. In diesem Fall müssen Sie berücksichtigen, ob die Übertragung von einem SFTP- oder FTP-Server erfolgen soll, ob das Ziel ein SFTP- oder FTP-Server oder eine lokale Dateifreigabe ist und welche Vorgänge und Aktionen für diese Aufgaben erforderlich sind.
Der Prozess beginnt wie üblich mit einem manuellen Trigger mit allen erforderlichen Parametern. Der erste Schritt besteht darin, ein neues Objekt mit allen möglichen Werten für die Parameter der Aufgaben zu erstellen. Anschließend durchläuft die Übertragung alle Pfade und der Prozess bestimmt mithilfe von Entscheidungselementen, welche Art von Übertragung durchgeführt werden soll.
Beachten Sie, dass in diesem Beispiel das Zielverzeichnis beider DownloadFiles-Tasks ein Verzeichnis auf der lokalen Dateifreigabe des Agenten sein muss, in das die Dateien verschoben oder kopiert werden, wenn das Ziel eine Dateifreigabe ist.
Der nächste Artikel istEinführung in den Lenker
Verwandte ArtikelErstellen einer geplanten FTP-ÜbertragungSo verwenden Sie einen bedingten Trigger, um einen Prozess zu starten, wenn die Datei auf dem SFTP-Server gefunden wirdEinführung in SFTP-AufgabenEinführung in die ListFiles-AufgabeEinführung in die Aufgaben „DownloadFiles“ und „UploadFiles“