Aufgabe zum Auflisten von Dateien aus einem Verzeichnis erstellt
RGeschrieben vonRiku Virtanen Vor über einer Woche aktualisiertTable of contentsDateien auflisten
Die ListFiles-Aufgabe ist eine besonders nützliche Aufgabe, die dazu dient, Dateien aus einem bestimmten Verzeichnis über eine SFTP-Verbindung aufzulisten. Die Aufgabe kann beispielsweise in einem bedingten Triggerprozess verwendet werden, der Dateien auflistet, die in ein bestimmtes Verzeichnis übertragen wurden. Die Aufgabe gibt eine Liste von Dateiobjekten zurück, die Informationen zur Datei enthalten.
Eingabeeigenschaften
Die Eingabeeigenschaften der Aufgabe enthalten alle Parameter, die die Aufgabe benötigt, um Dateien auf dem SFTP-Server zu finden. Der erste Parameter ist „Verzeichnis“. „Verzeichnis“ ist ein notwendiger Parameter; die Aufgabe verwendet ihn, um den richtigen Ort zu finden, an dem die Dateien aufgelistet werden sollen. Der Verzeichnisparameter benötigt den absoluten Pfad zum Verzeichnis.
Der nächste Parameter ist die Dateimaske. Dieser Parameter ist optional und kann leer gelassen werden. Ein leerer Dateimaskenparameter bedeutet, dass alle im angegebenen Verzeichnis gefundenen Dateien in die Liste aufgenommen werden. Wie der Name schon sagt, kann die Dateimaske auch die Aufgabe übernehmen, Dateien mit einem bestimmten Namen aufzulisten. Mit der Dateimaske „*.txt“ listet die Aufgabe beispielsweise nur die Textdateien mit der Dateierweiterung .txt auf. Sie können auch einen Teil des Dateinamens in die Dateimaske aufnehmen.
Mit dem nächsten Parameter können Sie auswählen, was die Aufgabe auflisten soll. Mit dem Parameter Include type können Sie auswählen, ob die Aufgabe Dateien, Verzeichnisse oder beides aus dem angegebenen Verzeichnis auflisten soll. Dies kann hilfreich sein, wenn Sie wissen möchten, was ein bestimmtes Verzeichnis enthält. Mit dem Parameter Include subdirectories können Sie Dateien und Verzeichnisse auch rekursiv auflisten. Dadurch kann die Aufgabe in diese Unterverzeichnisse gehen und Dateien in diesen Unterverzeichnissen auflisten.
Schließlich können Sie die Kodierung auswählen, die für die Dateinamen auf dem SFTP-Server verwendet wird. Sie können entweder aus bereits enthaltenen Kodierungsformaten wählen oder die andere Option wählen, bei der Sie das Kodierungsformat selbst angeben können. Sie können die möglichen Kodierungen überprüfen unterHier.
Verbindungseigenschaften
Die Verbindungseigenschaften der Aufgabe sind denen anderer SFTP-Aufgaben, die wir im zweiten Modul behandelt haben, sehr ähnlich. Die Aufgabe benötigt die Adresse, Portnummer und Authentifizierungsdaten des Servers. Der einzige Unterschied zu den Verbindungseigenschaften anderer SFTP-Aufgaben ist das Fehlen des Parameters Puffergröße. Dieser ist in der ListFiles-Aufgabe nicht enthalten, da die Aufgabe keine Daten überträgt, sondern Informationen zu den Dateien sammelt, die sich im angegebenen Verzeichnis befinden.
Rückgabeeigenschaften
Die Aufgabe gibt ein Ergebnisobjekt zurück, das zwei Attribute enthält: Anzahl und Dateien. Das Attribut Anzahl gibt die Anzahl der im Verzeichnis gefundenen Dateien zurück. Das Attribut Dateien ist eine Liste von Dateielementen, die im angegebenen Verzeichnis gefunden wurden. Die Dateielemente in der Dateiliste enthalten einen vollständigen Pfad zur Datei, einen Booleschen Wert, der angibt, ob die Datei ein Verzeichnis ist und ob die Datei eine Datei ist, die Länge der Datei, den Namen, die letzte Schreibzeit in UTC und in Ortszeit und dasselbe gilt für die letzte Zugriffszeit. Diese Dateiliste kann mit der anderen SFTP-Aufgabe verwendet werden. Beachten Sie jedoch, dass die Liste im richtigen Format zugeordnet werden muss, wenn sie als Dateipfadattribut in der DownloadFiles-Aufgabe verwendet wird.
Der nächste Artikel istEinführung in WriteFile- und ReadFile-Aufgaben
Verwandte ArtikelEinführung in die Verbindung mit SFTP-AufgabenEinführung in die Aufgaben „DownloadFiles“ und „UploadFiles“Einführung in WriteFile- und ReadFile-AufgabenEinführung in die Aufgaben „DownloadFiles“ und „UploadFiles“Einführung in die Verwendung von SFTP- und FTP/FTPS-Aufgaben in Ihren Prozessen