FTP-Aktivität 'Datei umbenennen (rename)'
Verwenden Sie die FTP-Aktivität Datei umbenennen (rename), um eine Datei während der Laufzeit umzubenennen und/oder in ein anderes Verzeichnis zu versetzen.
- Versetzen Sie die Datei in ein neues Verzeichnis und benennen Sie sie um. Beispiel: Eine Datei mit dem Namen BidAcmeInc.xml wird vom Verzeichnis 'input' in das Verzeichnis 'process' versetzt und in NewBidAcmeInc.xml umbenannt.
- Versetzen Sie die Datei in ein neues Verzeichnis, aber behalten Sie den vorhandenen Dateinamen bei. Beispiel: Die Datei mit dem Namen BidAcmeInc.xml wird vom Verzeichnis 'input' in das Verzeichnis 'process' versetzt.
- Benennen Sie die Datei um und belassen Sie sie im ursprünglichen Verzeichnis. Beispiel: Eine Datei mit dem Namen BidAcmeInc.xml wird in NewBidAcmeInc.xml umbenannt, jedoch im Verzeichnis 'input' belassen.
Symbolischer Link
Die FTP-Aktivität 'Datei umbenennen (rename)' unterstützt symbolische Links zu Verzeichnissen, wenn die folgenden Bedingungen wahr sind:- Wenn symbolische Links zu Verzeichnissen von dem Betriebssystem, unter dem der FTP-Server betrieben wird, unterstützt werden.
- Wenn symbolische Links zu Verzeichnissen vom FTP-Server selbst unterstützt werden.
FTP-Aktivität 'Datei umbenennen (rename)' zur Orchestrierung hinzufügen
- Erstellen oder öffnen Sie eine Orchestrierung. Eine grafische Darstellung der Orchestrierung wird angezeigt.
- Wählen Sie die Registerkarte Aktivitäten aus und erweitern Sie den FTP-Ordner.
- Ziehen Sie die Aktivität Datei umbenennen (rename) auf die Orchestrierung.
- Wählen Sie die Aktivität aus. Die Prüfliste wird angezeigt.
FTP-Endpunkt erstellen, auswählen oder bearbeiten
- 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:
- 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 Prozedur "Aktivität konfigurieren" beschrieben werden.
- Wählen Sie einen vorhandenen Endpunkt aus und klicken Sie auf OK. Fahren Sie mit der Prozedur "Aktivität konfigurieren" fort.
- Wählen Sie Durchsuchen aus. Der Projektexplorer wird angezeigt.
- Wählen Sie einen vorhandenen Endpunkt aus und bearbeiten Sie den Endpunkt:
- Wählen Sie Durchsuchen aus. Der Projektexplorer wird angezeigt.
- 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.
- 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.
- Wählen Sie einen vorhandenen Endpunkt aus:
- Erstellen oder bearbeiten Sie einen FTP-Endpunkt: FTP-Endpunkt erstellen oder bearbeiten
Aktivität konfigurieren
- Wählen Sie die Task Konfigurieren in der Prüfliste aus. Das Teilfenster 'Konfigurieren' wird angezeigt.
- Konfigurieren Sie die Felder in diesem Teilfenster wie in der folgenden Tabelle beschrieben:
Tabelle 1. Feld Beschreibung Umbenennen Dateiname Dieses Feld wird für diese Aktivität nicht verwendet. Sie geben den Namen der umzubenennenden Datei mithilfe des Eingabeparameters fromFilename der Task Eingaben zuordnen an. Aus Verzeichnis Gibt das Verzeichnis auf dem FTP-Server an, in dem die Integrationseinheit (Integration Appliance) die angegebene Datei löscht. 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 finden Sie in der "Anmerkung".)
- 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.Neuer Pfad Dieses Feld wird für diese Aktivität nicht verwendet. Sie geben den vollständigen Pfad einschließlich des neuen Dateinamens und des neuen Verzeichnisses auf dem FTP-Server an, auf dem die Integrationseinheit (Integration Appliance) die Datei, die mithilfe des Eingabeparameters toPath der Task 'Eingaben zuordnen' versetzt wurde, ablegt. 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.Optionen - Wählen Sie eine der folgenden Optionen aus, um das Verhalten zu definieren, das eintritt, wenn eine vorhandene Datei mit dem gleichen Namen in dem angegebenen Ausgabeverzeichnis bereits 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. 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. - Geben Sie den Verzeichnispfad direkt ein, indem Sie im Feld klicken und dann einen der folgenden Verzeichnispfade eingeben:
Wiederholungsoptionen angeben
- Wählen Sie die Task Wiederholung in der Prüfliste aus. Das Fenster 'Wiederholung' wird angezeigt.
- Konfigurieren Sie die Wiederholungsoptionen für die Verbindung zu einem FTP-Server. Die folgende Tabelle beschreibt die Wiederholungsoptionen für die Verbindung zu einem FTP-Server:
Tabelle 2. 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 umbenennen (rename) 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
- 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.
- Sie müssen den folgenden Eingabeparametern eine Variable zuordnen:
- fromFilename - Während der Umbenennungsaktion gibt dieser Parameter den ursprünglichen Namen der umzubenennenden Datei an.
- toPath - Während der Umbenennungsaktion gibt dieser Parameter den Pfad einschließlich des neuen Verzeichnis- und des neuen Dateinamens an. Beispiel: Um anzugeben, dass die Datei in das Verzeichnis /output des Stammverzeichnisses des FTP-Servers versetzt und dabei der Dateiname 'fileNewName.txt' verwendet werden soll, müssen Sie den folgenden Wert für toPath angeben: /output/fileNewName.txt
Alle anderen Eingabeparameter sind optional. Allgemeine Anweisungen zur Zuordnung finden Sie in 'Zuordnung erstellen'.
Wenn die Eingabeparameter der folgenden Tabelle nicht im Teilfenster 'An Aktivität' des Teilfensters 'Eingaben zuordnen' angezeigt werden, wählen Sie
im Symbolleistenmenü aus oder klicken mit der rechten Maustaste im Teilfenster 'An Aktivität' und wählen Sie dann die Option '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.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, 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.
Tabelle 3. Name des Eingabeparameters/Knoten Beschreibung Überschreibt die Einstellung in der Task? fromDirectory Gibt das Verzeichnis auf dem FTP-Server an, aus dem die Integrationseinheit (Integration Appliance) die Dateiliste abruft. Der Eingabeparameter directory überschreibt den Wert im Feld Im Verzeichnis der Task Konfigurieren. overwrite 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 Dateien auflisten (ls) 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/timeout Gibt den Hostnamen oder die IP-Adresse für den FTP-Server an. 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 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 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
- Wählen Sie die Task Ausgaben zuordnen in der Prüfliste aus. Der Ausgabeparameter directoryListing oder fileListing wird im Teilfenster 'Von Aktivität' angezeigt.
- Ordnen Sie den Ausgabeparameter directoryListing oder fileListing einer Variablen
zu. Allgemeine Anweisungen zur Zuordnung finden Sie in
'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, 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.