Während der Laufzeit verwendet die FTP-Aktivität Datei senden (put) Daten aus Variablen der Orchestrierung, speichert diese in einer Datei und stellt eine Verbindung zu einem FTP-Server her. Anschließend wird die verwendete Datei unter der angegebenen Verzeichnisposition abgelegt.
Ein Beispiel für die Verwendung der FTP-Aktivität Datei senden (put) finden Sie im Einführungshandbuch.
Feld | Beschreibung |
---|---|
Speichern | |
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. |
Im 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:
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:
Anmerkung: Bestimmte Doppelbytezeichen werden nicht mit der SHIFT-JIS-Codierung umgewandelt. Weitere Informationen finden Sie unter Shift-JIS-Codierung verwenden.
|
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:
|
|
Optionen - Wählen Sie eine der folgenden Optionen aus, um das Verhalten für den Fall zu definieren, dass im angegebenen Ausgabeverzeichnis bereits eine Datei mit dem gleichen Namen vorhanden ist: | |
Vorhandene Datei überschreiben, wenn doppelter Dateiname gefunden wird | Gibt an, ob die Datei bereits vorhanden ist, löscht den Inhalt der ursprünglichen Datei und ersetzt diesen durch die neuen Daten, die von der Aktivität zurückgegeben werden. |
An vorhandene Datei anhängen | Gibt an, ob die Datei bereits vorhanden ist, behält die ursprünglichen Daten in der Datei bei und hängt die neuen (von der Aktivität zurückgegebenen) Daten am Ende der Datei an. |
Fehler ausgeben, wenn eine Datei mit einem doppelten Namen gefunden wird | Gibt an, ob die Datei bereits vorhanden ist, behält die ursprünglichen Daten in der Datei bei, gibt einen Fehler aus und führt für die neuen (von der Aktivität zurückgegebenen) Daten keine Aktion aus. Anmerkung: Wenn
Sie diese Option auswählen, prüft die FTP-Aktivität 'Datei senden (put)' vor dem Hochladen, ob die
Datei auf dem Server bereits vorhanden ist. Auf manchen FTP-Servern verfügen Sie möglicherweise nicht
über die Berechtigung, um vor dem Hochladen zu prüfen, ob die Datei bereits vorhanden ist.
Dieser Vorgang wird auch als 'blinde FTP-Übertragung' bezeichnet. In solchen Fällen wird die Datei auch überschrieben,
wenn Sie die Option Fehler ausgeben, wenn eine Datei mit einem doppelten Namen gefunden wird
ausgewählt haben.
|
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 senden (put) 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 (Integration Appliance) protokolliert den vierten Verbindungsfehler als Fehler und stoppt die Verarbeitung des aktuellen Orchestrierungsjobs. |
Wenn die Eingabeparameter der folgenden Tabelle nicht im Teilfenster 'An Aktivität' des Teilfensters 'Eingaben zuordnen' angezeigt werden, wählen Sie Optionale Parameter anzeigen aus. Wenn die Option im Symbolleistenmenü nicht auswählbar ist, klicken Sie auf einen Knoten im Teilfenster 'Eingaben zuordnen', um diese Option zu aktivieren.
im Symbolleistenmenü aus oder klicken Sie mit der rechten Maustaste im Teilfenster 'An Aktivität' und wählen Sie dann die OptionSie 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, in dem die Integrationseinheit (Integration Appliance) die in dieser Aktivität generierte Datei ablegt, kann in der Task Konfigurieren das Verzeichnis 'output' definiert werden. Während der Laufzeit kann dann der Verzeichnisname outputXML ü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 würde die Datei im Verzeichnis outputXML abgelegt werden.
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 Im Verzeichnis der Task Konfigurieren. |
encoding | Gibt an, wie die abgehenden Daten in der Datei geschrieben werden:
|
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. |
overwrite | Gibt das Verhalten an, das eintritt, wenn eine vorhandene Datei mit dem gleichen Namen im angegebenen Ausgabeverzeichnis bereits vorhanden ist.
Geben Sie einen der folgenden Werte an:
|
Der Eingabeparameter overwrite überschreibt den Wert im Feld Optionen der Task Konfigurieren. |
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 senden (put) 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. |