FTP-Aktivität 'Dateien auflisten (ls)'

Während der Laufzeit stellt die FTP-Aktivität Dateien auflisten (ls) eine Verbindung zu einem FTP-Server her und generiert eine Liste der Dateien, die unter der angegebenen Verzeichnisposition gespeichert sind. Dazu wird der angegebene reguläre Ausdruck verwendet. Die FTP-Aktivität Dateien auflisten (ls) gibt die Liste der Dateien an die Orchestrierung zurück. Dazu wird entweder der Ausgabeparameter directoryListing oder fileListing verwendet.

Wenn das Kontrollkästchen Nur Dateien auflisten (NLST) abgewählt wird, wird eine vollständige Verzeichnisliste einschließlich der Verzeichnisberechtigungen, Zeitmarken und der Angaben zum Eigentumsrecht im Ausgabeparameter directoryListing in einer einzigen Zeichenfolge zurückgegeben. Wenn eine vollständige Verzeichnisliste als Zeichenfolge zurückgegeben wird, müssen Sie die Verzeichnisliste mithilfe eines Schemas für unstrukturierte Dateien mit der Aktivität Unstrukturierte Datei lesen parsen. Wenn das Kontrollkästchen 'Nur Dateien auflisten (NLST)' ausgewählt ist und die FTP-Aktivität 'Dateien auflisten (ls)' das Format der Verzeichnisliste für Ihren FTP-Server unterstützt, wird eine sich wiederholende Struktur, die nur Dateinamen umfasst (falls vom FTP-Server unterstützt), im Ausgabeparameter fileListing zurückgegeben. Wenn eine sich wiederholende Struktur mit Dateinamen zurückgegeben wird, müssen Sie die Verzeichnisliste nicht parsen und können die Liste einfach mithilfe einer Aktivität Für jedes oder While-Schleife durchlaufen. Der FTP-Server, zu dem Sie eine Verbindung herstellen, muss den Befehl NLST unterstützen. Die Antwort des FTP-Servers wird zurückgegeben.

In einigen Fällen müssen Sie die FTP-Aktivität Dateien auflisten (ls) zusammen mit den FTP-Aktivitäten Datei abrufen (get), Datei senden (put), Datei löschen (delete) und Datei umbenennen (rename) verwenden. Dies ist erforderlich, wenn Sie eine Gruppe von Dateien verarbeiten wollen, die in einem FTP-Verzeichnis gefunden wurde. In anderen Fällen reicht hingegen die Verwendung der FTP-Aktivität Verzeichnis abfragen (dir) aus.

Verwenden Sie die FTP-Aktivität Dateien auflisten (ls) zusammen mit den FTP-Aktivitäten Datei abrufen (get), Datei senden (put), Datei löschen (delete) und Datei umbenennen (rename), um eine Gruppe von Dateien zu verarbeiten, die in einem FTP-Verzeichnis gefunden wurde, wenn eine der folgenden Bedingungen wahr ist:
  • Die FTP-Aktivität 'Verzeichnis abfragen (dir)' unterstützt das Format der Verzeichnisliste Ihres FTP-Servers nicht - Das Format von Verzeichnislisten unterscheidet sich bei den FTP-Servern, die unter verschiedenen Betriebssystemen unterstützt werden. Die Aktivität FTP - Verzeichnis abfragen (dir) unterstützt zahlreiche Typen von FTP-Servern. Wenn jedoch das Verzeichnislistenformat Ihres FTP-Servers von der Aktivität FTP - Verzeichnis abfragen (dir) nicht geparst werden kann, dann verwenden Sie die Aktivität FTP - Dateien auflisten (ls) und die Aktivitäten FTP - Datei abrufen (get), FTP - Datei senden (put), FTP - Datei löschen (delete) und FTP - Datei umbenennen (rename), um die gleiche Funktionalität bereitzustellen wie die Aktivität FTP - Verzeichnis abfragen (dir). Dieser Sachverhalt wird im Beispiel zum Parsen der Verzeichnisliste dargestellt: Verzeichnisliste parsen - Beispiel.
  • Jede Datei in der Liste muss mit einer anderen Aktion nachbearbeitet werden. - Beispiel: Wenn Sie Dateien auf Basis des Dateinamens in andere Verzeichnisse versetzen müssen, dann verwenden Sie die Aktivität FTP - Dateien auflisten (ls) zusammen mit den Aktivitäten FTP - Datei abrufen (get), FTP - Datei senden (put), FTP - Datei löschen (delete) und FTP - Datei umbenennen (rename). Dieser Sachverhalt wird im Beispiel zum Parsen der Verzeichnisliste dargestellt: Verzeichnisliste parsen - Beispiel. Allerdings ist zu beachten, dass bei Dateien, die alle mit der gleichen Aktion nachbearbeitet werden können, die Aktion FTP - Verzeichnis abfragen (dir) verwendet werden kann, um die Gruppe der Dateien zu verarbeiten.

Symbolische Links

Die Unterstützung der Aktivität FTP - Dateien auflisten (ls) für symbolische Links während der Laufzeit ist abhängig von den folgenden Faktoren:
  • Den Typen der symbolischen Links, die vom Betriebssystem unterstützt werden, unter dem der FTP-Server betrieben wird.
  • Den Typen der symbolischen Links, die vom FTP-Server selbst unterstützt werden.
  • Den Typen der symbolischen Links, die von der Aktivität FTP - Dateien auflisten (ls) unterstützt und in der folgenden Tabelle aufgelistet werden:
    Tabelle 1.
    Symbolische Links zu... Unveränderliche symbolische Links Veränderliche symbolische Links Hinweise
    Dateien Nicht unterstützt Nicht unterstützt Die Aktivität FTP - Dateien auflisten (ls) führt keine Interpretation symbolischer Links zu Dateien durch, da Dateien und demzufolge auch symbolische Links zu Dateien von der Aktivität FTP - Dateien auflisten (ls) während der Laufzeit nicht verarbeitet werden.
    Verzeichnisse Unterstützt Unterstützt  
Um festzustellen, ob symbolische Links von einem bestimmten FTP-Server unter einem bestimmten Betriebssystem unterstützt werden, sollten Sie die Informationen in der Dokumentation zum FTP-Server oder Betriebssystem lesen.

Unterverzeichnisse mit Microsoft-FTP-Endpunkt verarbeiten

Beim Microsoft-FTP-Endpunkt für IIS (Internet Information Services) richtet sich das Laufzeitverhalten der Aktivität FTP - Dateien auflisten (ls) bei der Verarbeitung von Unterverzeichnissen und Dateien in Unterverzeichnissen nach dem regulären Ausdruck, der im Feld Dateiname der Task Konfigurieren der Aktivität angegeben wurde. Dieser Sachverhalt wird in den folgenden Fällen beschrieben:
  • Wenn der reguläre Ausdruck der Zeichenfolge * entspricht, dann verarbeitet der Orchestrierungsjob die Unterverzeichnisse im angegebenen Verzeichnis.
  • Wenn der reguläre Ausdruck der Zeichenfolge *.* entspricht, dann verarbeitet der Orchestrierungsjob die Unterverzeichnisse im angegebenen Verzeichnis nicht.
  • Wenn der reguläre Ausdruck leer ist, dann verarbeitet der Orchestrierungsjob die Unterverzeichnisse im angegebenen Verzeichnis nicht.

Aktivität 'FTP - Dateien auflisten (ls)' zur Orchestrierung hinzufügen

  1. Erstellen oder öffnen Sie eine Orchestrierung. Eine grafische Darstellung der Orchestrierung wird angezeigt.
  2. Wählen Sie die Registerkarte Aktivitäten aus und erweitern Sie den FTP-Ordner.
  3. Ziehen Sie die Aktivität Dateien auflisten (ls) auf die Orchestrierung.
  4. Wählen Sie die Aktivität aus. Die Prüfliste wird angezeigt.

FTP-Endpunkt erstellen, auswählen oder bearbeiten

  1. Klicken Sie auf die Task Endpunkt auswählen in der Prüfliste und wählen Sie eine der folgenden Aktionen aus:
    • Wählen Sie einen vorhandenen Endpunkt aus:
      1. Wählen Sie Durchsuchen aus. Der Projektexplorer wird angezeigt.
        Achtung: Wenn Sie einen neuen FTP-Endpunkt mit einer Verzeichnisstruktur angeben, die von der Verzeichnisstruktur des ursprünglichen FTP-Endpunkts abweicht, dann kann dadurch der Orchestrierungsjob während der Laufzeit fehlschlagen. Sie müssen entweder einen neuen FTP-Server angeben, dessen Verzeichnisstruktur mit der Verzeichnisstruktur des ursprünglich angegebenen FTP-Servers übereinstimmt, oder das konfigurierte Verzeichnis ändern, das im Feld Im Verzeichnis angegeben ist, indem Sie auf Durchsuchen klicken. Befolgen Sie dazu die Anweisungen, die in der folgenden Prozedur "Aktivität konfigurieren" beschrieben werden.
      2. Wählen Sie einen vorhandenen Endpunkt aus und klicken Sie auf OK. Fahren Sie mit der Prozedur "Aktivität konfigurieren" fort.
    • Wählen Sie einen vorhandenen Endpunkt und bearbeiten Sie den Endpunkt:
      1. Wählen Sie Durchsuchen aus. Der Projektexplorer wird angezeigt.
      2. Wählen Sie einen vorhandenen Endpunkt aus und klicken Sie auf OK.
        Achtung: Wenn Sie einen neuen FTP-Endpunkt mit einer Verzeichnisstruktur angeben, die von der Verzeichnisstruktur des ursprünglichen FTP-Endpunkts abweicht, dann kann dadurch der Orchestrierungsjob während der Laufzeit fehlschlagen. Sie müssen entweder einen neuen FTP-Server angeben, dessen Verzeichnisstruktur mit der Verzeichnisstruktur des ursprünglich angegebenen FTP-Servers übereinstimmt, oder das konfigurierte Verzeichnis ändern, das im Feld Im Verzeichnis angegeben ist, indem Sie auf Durchsuchen klicken. Befolgen Sie dazu die Anweisungen, die in der folgenden Prozedur "Aktivität konfigurieren" beschrieben werden.
      3. Klicken Sie auf Bearbeiten. Das Teilfenster 'Endpunkt bearbeiten' wird angezeigt.
    • Erstellen Sie einen neuen Endpunkt: Wählen Sie Neu aus. Das Teilfenster 'Endpunkt erstellen' wird angezeigt.
  2. Erstellen oder bearbeiten Sie einen FTP-Endpunkt: FTP-Endpunkt erstellen oder bearbeiten.

Aktivität konfigurieren

  1. Wählen Sie die Task Konfigurieren in der Prüfliste aus. Das Teilfenster 'Konfigurieren' wird angezeigt.
  2. Konfigurieren Sie alle Felder in diesem Teilfenster wie in der folgenden Tabelle beschrieben:
    Tabelle 2.
    Feld Beschreibung
    Im Verzeichnis Gibt das Verzeichnis auf dem FTP-Server an, in dem die Integrationseinheit (Integration Appliance) eine Liste der Dateien in dem Verzeichnis generiert. Sie können ein Verzeichnis angeben, indem Sie eine der folgenden Optionen verwenden:
    • Geben Sie den Verzeichnispfad direkt ein, indem Sie im Feld klicken und dann einen der folgenden Verzeichnispfade eingeben:
      • Relativer Verzeichnispfad. Beispiel: /process.(Dabei wird davon ausgegangen, dass für den Benutzeraccount, über den die Verbindung zum FTP-Server hergestellt wird, ein FTP-Ausgangsverzeichnis konfiguriert wurde. Weitere Informationen hierzu finden Sie in dem folgenden Hinweis.)
      • Vollständiger Verzeichnispfad. Beispiel auf einer UNIX-Maschine: /home/user/process.
    • Klicken Sie auf Durchsuchen..., um die Dropdown-Liste der verfügbaren Verzeichnisse mit Daten zu füllen. Wählen Sie in der Dropdown-Liste das gewünschte Verzeichnis aus.
    Anmerkung: UNIX: Wenn Sie beim Herstellen der Verbindung zu einem FTP-Server auf einer UNIX-Maschine einen relativen Verzeichnispfad angeben, müssen Sie überprüfen, ob das FTP-Ausgangsverzeichnis in der Datei /etc/password für den Benutzeraccount, über den die Verbindung zum FTP-Server hergestellt werden soll, korrekt angegeben wurde.
    Dateiname Gibt ein Muster ('glob pattern') an, das die Dateinamen definiert, die vom FTP-Server abgerufen werden sollen. Die Verarbeitung des Glob-Musters wird vom FTP-Server durchgeführt. Weitere Informationen hierzu finden Sie in der Dokumentation zum FTP-Server in den Abschnitten über das Glob-Muster.
    Nur Dateien auflisten (NLST) Das Kontrollkästchen Nur Dateien auflisten (NLST) gibt den Typ der Verzeichnisliste an, die mithilfe der Schaltfläche 'Testen' und während der Laufzeit zurückgegeben wird. Darüber hinaus definiert dieses Kontrollkästchen, ob der Ausgabeparameter fileListing oder directoryListing in der Task Ausgaben zuordnen angezeigt und von der Aktivität während der Laufzeit zurückgegeben wird.
      Falls das Kontrollkästchen Nur Dateien auflisten (NLST) ausgewählt ist, werden nur die Dateinamen zurückgegeben (falls vom FTP-Server unterstützt), wenn auf die Schaltfläche Testen wie in Abbildung 1 geklickt wird. Darüber hinaus sollten Sie beachten, dass bei Auswahl des Kontrollkästchens Nur Dateien auflisten (NLST) der Ausgabeparameter fileListing in der Task 'Ausgaben zuordnen' aufgelistet wird. Während der Laufzeit wird die Gruppe der Dateinamen (files) im sich wiederholenden Knoten 'fileName' des Ausgabeparameters fileListing zurückgegeben. Der FTP-Server, zu dem Sie eine Verbindung herstellen, muss den Befehl NLST unterstützen. Die Antwort des FTP-Servers wird zurückgegeben.
      Falls das Kontrollkästchen Nur Dateien auflisten (NLST) ausgewählt ist, wird nur eine vollständige Verzeichnisliste mit Verzeichnisberechtigungen, Zeitmarken und Besitzrecht zurückgegeben, wenn wie in Abbildung 2 auf die Schaltfläche Test geklickt wird. Darüber hinaus sollten Sie beachten, dass bei Auswahl des Kontrollkästchens Nur Dateien auflisten (NLST) der Ausgabeparameter directoryListing in der Task Ausgaben zuordnen aufgelistet wird. Während der Laufzeit wird die vollständige Verzeichnisliste in einer einzigen Zeichenfolge bereitgestellt und mithilfe des Ausgabeparameters directoryListing zurückgegeben.
    Abbildung 1. Beispielliste bei der Auswahl von Nur Dateien auflisten (NLST)
    bidAcmeInc.txt
    bidBudgetManufacture.txt
    bidCrankCo.txt
    bidSamAndSons.txt
    bidWidgetRUs.txt
    Abbildung 2. Beispielliste bei der Abwahl von Nur Dateien auswählen (NLST)
    -rw-r--r--  1 551    551      65 May  3 11:39 bidAcmeInc.txt
    -rw-r--r--  1 551    551     43 May  3 11:39 bidBudgetManufacture.txt
    -rw-r--r--  1 551    551       0 May  3 11:39 bidCrankCo.txt
    -rw-r--r--  1 551    551      73 May  3 11:39 bidSamAndSons.txt
    -rw-r--r--  1 551    551      33 May  3 11:39 bidWidgetRUs.txt

Wiederholungsoptionen angeben

  1. Wählen Sie die Task Wiederholung in der Prüfliste aus. Das Fenster 'Wiederholung' wird angezeigt.
  2. Konfigurieren Sie die Wiederholungsoptionen für die Verbindung zu einem FTP-Server. Die folgende Tabelle definiert die Wiederholungsoptionen für eine Verbindung zu einem FTP-Server:
    Tabelle 3.
    Feld Beschreibung
    Wiederholung  
    1) ___ Sekunden zwischen den einzelnen Wiederholungen warten. Die Zeitdauer in Sekunden, die die Integrationseinheit (Integration Appliance) wartet, bevor sie versucht, eine Verbindung zum FTP-Server herzustellen.
    2) Verbindungsherstellung ___ mal versuchen, bevor ein Fehler zurückgegeben wird. Gibt die Anzahl der Wiederholungen an - Die maximale Anzahl der Versuche der Integrationseinheit (Integration Appliance), eine Verbindung zum FTP-Server herzustellen, bevor ein Fehler ausgegeben wird.

    Falls eine Orchestrierung, die mit der FTP-Aktivität Dateien auflisten (ls) beginnt, implementiert wird, und die Integrationseinheit (Integration Appliance) keine Verbindung zum angegebenen FTP-Server herstellen kann, protokolliert die Integrationseinheit (Integration Appliance) die Verbindungsfehler als Warnungen im Systemprotokoll, bis der Wert des Wiederholungszählers erreicht ist. Wenn der Wiederholungszähler erreicht ist, protokolliert die Integrationseinheit (Integration Appliance) einen Fehler im Systemprotokoll, setzt den Zähler für Verbindungsfehler auf null zurück und versucht weiterhin, eine Verbindung zum FTP-Server herzustellen.

    Wenn Sie für den Wiederholungszähler zum Beispiel 3 definieren, werden der erste, zweite und dritte Verbindungsfehler im Systemprotokoll als Warnung vermerkt. Die Integrationseinheit (Integration Appliance) protokolliert den vierten Verbindungsfehler als Fehler und setzt den Zähler für Verbindungsfehler auf null zurück. Darum generiert der fünfte Verbindungsfehler eine Warnung im Systemprotokoll. Die Integrationseinheit (Integration Appliance) versucht weiter, eine Verbindung zum FTP-Server herzustellen.

Eingabe der Aktivität zuordnen

  1. Wählen Sie die Task Eingaben zuordnen in der Prüfliste aus. Das Fenster Wiederholung wird angezeigt. Die Eingabeparameter der Aktivität werden im Teilfenster 'An Aktivität' angezeigt.
  2. Sie können die Eingabeparameter der FTP-Aktivität Dateien auflisten (ls) optional zuordnen. Die FTP-Aktivität Dateien auflisten (ls) verfügt über die folgenden optionalen Eingabeparameter:
    • directory
    • connection

    Wenn die Eingabeparameter der folgenden Tabelle nicht im Teilfenster 'An Aktivität' des Teilfensters 'Eingaben zuordnen' angezeigt werden, wählen Sie Zuordnen > Optionale Parameter anzeigen im Symbolleistenmenü aus oder klicken Sie mit der rechten Maustaste im Teilfenster 'An Aktivität' und wählen Sie dann die Option Optionale Parameter anzeigen aus. Wenn die Option Zuordnen > Optionale Parameter anzeigen im Symbolleistenmenü nicht auswählbar ist, klicken Sie auf einen Knoten im Teilfenster 'Eingaben zuordnen', um diese Option zu aktivieren.

    Sie können die Einstellungen, die Sie in den Tasks Konfigurieren und Endpunkt auswählen der Prüfliste während der Laufzeit dynamisch angegeben haben, optional überschreiben, indem Sie die in der folgenden Tabelle definierten Eingabeparameter verwenden.

    Beispiel: Als Verzeichnis auf dem FTP-Server, aus dem die Integrationseinheit (Integration Appliance) die Dateiliste abruft, kann in der Task Konfigurieren das Verzeichnis input definiert werden. Während der Laufzeit kann dann der Verzeichnisname inputXML über den Eingabeparameter directory an die Aktivität übergeben werden. Der Verzeichnisname, der während der Laufzeit dynamisch angegeben wird, überschreibt die ursprüngliche Einstellung, die im Teilfenster 'Konfigurieren' angegeben wurde. In diesem Beispiel wird die Liste der Dateien aus dem Verzeichnis inputXML generiert.

Tabelle 4.
Name des Eingabeparameters/Knoten Beschreibung Überschreibt die Einstellung in der Task?
directory Gibt das Verzeichnis auf dem FTP-Server an, in dem die Integrationseinheit (Integration Appliance) eine Liste der Dateien in dieser Aktivität erstellt. Der Eingabeparameter directory überschreibt den Wert im Feld Im Verzeichnis der Task Konfigurieren.
connection/timeout Gibt die Zeitdauer in Sekunden an, die zwischen dem Versuch der Integrationseinheit (Integration Appliance), eine Verbindung zu einem Endpunkt aufzubauen, und der Antwort des Endpunkts auf die Verbindungsanforderung verstreichen darf, bevor eine Zeitlimitüberschreitung auftritt. Bei der FTP-Aktivität Datei löschen (delete) die Zeitdauer, die die Integrationseinheit (Integration Appliance) versucht, eine Verbindung zum FTP-Server herzustellen, bevor ein Zeitlimit überschritten wird. Der Knoten timeout des Eingabeparameters connection überschreibt den Wert im Feld Verbindungszeitlimit - Zeitlimit nach ___ Sekunden beim Aufbau einer Verbindung zum Endpunkt des FTP-Endpunkts.
connection/host Gibt den Hostnamen oder die IP-Adresse für den FTP-Server an. Der Knoten host des Eingabeparameters connection überschreibt den Wert im Feld Hostname des FTP-Endpunkts.
connection/port Gibt die Portnummer für den angegebenen Hostnamen an. Der Standardport für den FTP-Datenverkehr lautet 21. Der Standardport für den SFTP-Datenverkehr lautet 22. Der Knoten port des Eingabeparameters connection überschreibt den Wert im Feld Port des FTP-Endpunkts.
connection/username Geben Sie einen Benutzernamen für den Account ein, der für die Herstellung der Verbindung zum FTP-Server verwendet wird. Der Knoten username des Eingabeparameters connection überschreibt den Wert im Feld Benutzername des FTP-Endpunkts.
connection/password Geben Sie ein Kennwort für den Account ein, der für die Herstellung der Verbindung zum FTP-Server verwendet wird. Der Knoten password des Eingabeparameters connection überschreibt den Wert im Feld Kennwort des FTP-Endpunkts.

Ausgabe der Aktivität zuordnen

  1. Wählen Sie die Task Ausgaben zuordnen in der Prüfliste aus. Der Ausgabeparameter directoryListing oder fileListing wird im Teilfenster 'Von Aktivität' angezeigt.
  2. Ordnen Sie den Ausgabeparameter directoryListing oder fileListing einer Variablen zu. Allgemeine Anweisungen zur Zuordnung finden Sie unter Zuordnung erstellen.

Während der Laufzeit gibt die FTP-Aktivität Dateien auflisten (ls) die Liste der Dateien an die Orchestrierung zurück. Dazu wird entweder der Ausgabeparameter directoryListing oder fileListing verwendet.

Wenn die Auswahl des Kontrollkästchens Nur Dateien auflisten (NLST) in der Task Konfigurieren zurückgenommen wurde, wird eine vollständige Verzeichnisliste einschließlich der Verzeichnisberechtigungen, Zeitmarken und der Angaben zum Eigentumsrecht im Ausgabeparameter directoryListing in einer einzigen Zeichenfolge zurückgegeben. Wenn eine vollständige Verzeichnisliste als Zeichenfolge zurückgegeben wird, müssen Sie die Verzeichnisliste mithilfe eines Schemas für unstrukturierte Dateien mit der Aktivität 'Unstrukturierte Datei lesen' parsen. Sie können ein Schema für unstrukturierte Dateien erstellen, indem Sie den Editor für Schemata für unstrukturierte Dateien verwenden. Ein Beispiel für eine Orchestrierung, die eine Verzeichnisliste mithilfe eines Schemas für unstrukturierte Dateien parst, finden Sie im Beispiel für das Parsen der Verzeichnisliste: Verzeichnisliste parsen - Beispiel.

Wenn das Kontrollkästchen Nur Dateien auflisten (NLST) ausgewählt ist und die FTP-Aktivität Dateien auflisten (ls) das Format der Verzeichnisliste für Ihren FTP-Server unterstützt, wird eine sich wiederholende Struktur, die nur Dateinamen umfasst (falls vom FTP-Server unterstützt), im Ausgabeparameter fileListing zurückgegeben. Wenn eine sich wiederholende Struktur mit Dateinamen zurückgegeben wird, müssen Sie die Verzeichnisliste nicht parsen und können die Liste einfach mithilfe einer Aktivität Für jedes oder While-Schleife durchlaufen.