FTP-Aktivität 'Datei abrufen (get)'

Während der Laufzeit stellt die FTP-Aktivität Datei abrufen (get) eine Verbindung zu einem FTP-Server her und versucht, eine einzelne Datei abzurufen, die sich an der angegebenen Position befindet. Sie können die FTP-Aktivität Datei abrufen (get) so konfigurieren, dass der Inhalt der Datei an eine Variable der Orchestrierung zurückgegeben wird. Darüber hinaus können Sie die FTP-Aktivität Datei abrufen (get) so konfigurieren, dass die Zeitmarke der Datei, die vom FTP-Server zurückgegeben wird, an eine Variable der Orchestrierung zurückgegeben wird.

Die FTP-Aktivität Datei abrufen (get) unterscheidet sich von der FTP-Aktivität Verzeichnis abfragen (dir) in der folgenden Art und Weise:

Symbolischer Link

Die Unterstützung der FTP-Aktivität Datei abrufen (get) für symbolische Links während der Laufzeit ist abhängig von den folgenden Faktoren: 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.

FTP-Aktivität 'Datei abrufen (get)' 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 Datei abrufen (get) 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, der mit der Verzeichnisstruktur des ursprünglich angegebenen FTP-Servers übereinstimmt oder das konfigurierte Verzeichnis des Felds Im Verzeichnis durch Klicken auf Durchsuchen ändern, wie dies in der Prozedur 'Aktivität konfigurieren' beschrieben wird.
      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 aus 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 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

Zustellregeln angeben

  1. Wählen Sie die Task Zustellregeln in der Prüfliste aus. Das Teilfenster 'Zustellregeln' wird angezeigt. Wenn auf dem FTP-Endpunkt die Sicherheitsfunktion nicht aktiviert wurde, dann sind die Optionen Als Text übertragen (ASCII) und Binär übertragen (BINARY) aktiviert. Wenn die Sicherheitsfunktion für den FTP-Endpunkt aktiviert wurde, dann ist der Dateiübertragungstyp immer binär.
  2. Wählen Sie den Typ für die Dateiübertragung zwischen der Integrationseinheit (Integration Appliance) und dem FTP-Server aus und entscheiden Sie sich dabei für eine der folgenden Optionen:
    • Als Text übertragen (ASCII) - Von der Integrationseinheit (Integration Appliance) werden nur sieben Bit jedes Zeichens in der Datei an den FTP-Server übertragen. Diese Option wird zur Übertragung von ASCII-Dateien (z. B. HTML- und Textdateien) verwendet.
      Vorsicht:
      Wenn Sie diese Option zur Übertragung von Binärdateien verwenden, kann es zu Datenverlusten kommen.
    • Binär übertragen (BINARY) - Von der Integrationseinheit (Integration Appliance) werden alle acht Bit eines Zeichens in der Datei an den FTP-Server übertragen. Diese Option wird zur Übertragung von Binärdateien verwendet.
    Anmerkung: Das Definieren des Übertragungsmodus in der Task 'Zustellregeln' entspricht dem Definieren des Übertragungsmodus in einer Befehlszeilensitzung bei einem FTP-Server mithilfe der folgenden Befehle:
    • ascii
    • binary

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
    Dateiname Dieses Feld wird für diese Aktivität nicht verwendet. Sie geben den Namen der Ausgabedatei mithilfe des Eingabeparameters filename der Task Eingaben zuordnen an.
    Aus Verzeichnis Gibt das Verzeichnis auf dem FTP-Server an, in dem die Integrationseinheit (Integration Appliance) die in dieser Aktivität generierte Datei ablegt. 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: /output. (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 finden Sie in der "Anmerkung".)
      • Vollständiger Verzeichnispfad. Beispiel auf einer UNIX-Maschine: /home/user/output.
    • 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.
    Mit Typ Gibt an, wie der Inhalt der Datei gelesen werden soll. Der Inhalt kann entweder als Binärdaten oder als codierter Text gelesen werden. Wenn die Option Text ausgewählt wurde, dann müssen Sie den Codierungstyp anhand einer der folgenden Optionen definieren:
    • Wählen Sie in der Dropdown-Liste Codiert mit einen der folgenden Codierungstypen aus.  
    • Geben Sie Ihren Codierungstyp direkt ein, indem Sie in das Feld Codiert mit klicken und Ihren Codierungstyp eingeben.
     
    Achtung: Sie müssen die Option Als Text übertragen (ASCII) für FTP-Aktivitäten angeben, wenn Sie Textdateien abrufen und diese auf einen FTP-Server für Endpunkte stellen, die zum Bearbeiten von Textdaten während der Übertragung von Daten zum und vom FTP-Endpunkt im ASCII-Modus dienen. Beispiel: Mainframe- und DOS-FTP-Endpunkte bearbeiten ASCII-Daten, wenn Daten im ASCII-Modus übertragen werden.
    Wenn Ihre Orchestrierung ASCII-Dateien mit der FTP-Aktivität Verzeichnis abfragen (dir) abruft und ASCII-Dateien mit der FTP-Aktivität 'Datei senden (put)' auf einen FTP-Mainframe-Server stellt, dann müssen Sie in Studio die Optionen in den folgenden Tasks angeben:
    • Wählen Sie in der Task Konfigurieren einer FTP-Aktivität Verzeichnis abfragen (dir) für das Feld Mit Typ die Option Text aus.
    • Wählen Sie in der Task Zustellregeln einer FTP-Aktivität Verzeichnis abfragen (dir) für das Feld Typ der Dateiübertragung die Option Als Text übertragen (ASCII) aus.
    • Wählen Sie in der Task Konfigurieren einer FTP-Aktivität Datei senden (put) für das Feld Mit Typ die Option Text aus.
    • Wählen Sie in der Task Zustellregeln einer FTP-Aktivität Datei senden (put) für das Feld Typ der Dateiübertragung die Option Als Text übertragen (ASCII) aus.

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 und die Verarbeitung des aktuellen Orchestrierungsjobs gestoppt wird.

    Wenn Sie eine Orchestrierung implementieren, die eine FTP-Aktivität Datei abrufen (get) enthält, und die Integrationseinheit (Integration Appliance) keine Verbindung zum angegebenen FTP-Server herstellen kann, protokolliert die Integrationseinheit (Integration Appliance) die Verbindungsfehler als Warnungen in den System- und Orchestrierungsprotokollen, bis der Wert für den Wiederholungszähler erreicht ist. Wenn der Wiederholungszähler erreicht ist, protokolliert die Integrationseinheit (Integration Appliance) einen Fehler im Systemprotokoll und im Orchestrierungsprotokoll und stoppt die Verarbeitung des aktuellen Orchestrierungsjobs.

    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 protokolliert den vierten Verbindungsfehler als Fehler und stoppt die Verarbeitung des aktuellen Orchestrierungsjobs.

Eingabe der Aktivität zuordnen

  1. Wählen Sie die Task Eingaben zuordnen in der Prüfliste aus. Die Eingabeparameter der Aktivität werden im Teilfenster 'An Aktivität' angezeigt.
  2. Der Parameter filename ist der einzige Parameter, für den in der Aktivität ein Wert angegeben werden muss. Alle anderen Parameter sind optional. Der Parameter filename gibt den Namen der Datei an, die vom FTP-Server abgerufen werden soll. Um einen Wert für den Parameter filename anzugeben, müssen Sie entweder einen Link vom Eingabeparameter filename zu einer Variablen erstellen oder einen Standardwert für den Eingabeparameter 'filename' definieren.

    Wenn die optionalen 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 Datei 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 versucht die Integrationseinheit (Integration Appliance), die Datei aus dem Verzeichnis 'inputXML' abzurufen.

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) die in dieser Aktivität generierte Datei ablegt. Der Eingabeparameter directory überschreibt den Wert im Feld Aus Verzeichnis der Task Konfigurieren.
encoding Gibt an, wie die abgehenden Daten in der Datei geschrieben werden:
  • Wenn keine Codierung erforderlich ist, dann geben Sie die Zeichenfolge binary an.
  • Wenn die Codierung erforderlich ist, dann geben Sie den Codierungstyp an, der zur Codierung der abgehenden Daten verwendet werden soll. Beispiel: UTF-8, US-ASCII, ISO_8859-1, EBCDIC-US oder SHIFT-JIS.
Der Eingabeparameter encoding überschreibt die Codierung, die im Feld Mit Typ der Task Konfigurieren angegeben ist. Wenn jedoch im Feld Mit Typ der Task Konfigurieren die Option Binär ausgewählt wurde, dann wird die Codierung, die im Eingabeparameter encoding angegeben ist, ignoriert.
connection/timeout Gibt das Verbindungszeitlimit an - Die Zeitdauer in Sekunden, 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 abrufen (get) 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. Die Ausgabeparameter der Aktivität werden im Teilfenster 'Von Aktivität' angezeigt und in der folgenden Tabelle aufgeführt:
    Tabelle 5.
    Name des Ausgabeparameters Beschreibung
    data Enthält den Inhalt der Datei.
    timestamp Enthält die Zeitmarke für die Datei, die vom FTP-Server zurückgegeben wird, und gibt normalerweise das Erstellungsdatum oder das Datum der letzten Änderung der Datei an.  
  2. Ordnen Sie die gewünschten Ausgabeparameter bestimmten Variablen zu.



Feedback | Notices


Timestamp icon Letzte Aktualisierung: Friday, November 8, 2013


http://pic.dhe.ibm.com/infocenter/wci/v7r0m0/topic/com.ibm.wci.doc/ftp_get_file_activity.html