Mit der Aktivität FTP - Datei löschen (delete) können Sie bestimmte Dateien während der Laufzeit aus speziellen Verzeichnissen
löschen.
Normalerweise wird die Aktivität
FTP - Datei löschen (delete) zusammen mit der Aktivität
FTP - Dateien auflisten (ls) verwendet. Dieser Fall wird in der folgenden Beispielorchestrierung dargestellt:
- Mit der Aktivität Job planen wird in Intervallen von einer Stunde ein Orchestrierungsjob erstellt.
- Mit der Aktivität FTP - Dateien auflisten (ls) können Sie eine Liste der Dateien generieren, die sich im Verzeichnis
\temp im Stammverzeichnis des FTP-Servers befinden und die Ergebnisse in einer Zeichenfolge speichern.
- Mit der Aktivität Unstrukturierte Datei lesen wird eine Liste der Dateien geparst. Das Ergebnis wird in einer sich wiederholenden XML-Struktur gespeichert.
- Die Aktivität Für jedes durchläuft die sich wiederholende Struktur, die die Liste der Dateien enthält:
- Wenn der Dateiname mit der Erweiterung '.tmp' endet, dann wird die angegebene Datei von der Aktivität FTP - Datei löschen (delete) gelöscht.
Ein Beispielprojekt, in dem eine Aktivität
FTP - Datei löschen (delete) verwendet wird, finden Sie in
Verzeichnisliste parsen - Beispiel.
Symbolischer Link
Die Aktivität
FTP - Datei löschen (delete) 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.
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.
Aktivität 'FTP - Datei löschen (delete)' 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 löschen (delete) auf die Orchestrierung.
- Wählen Sie die Aktivität aus. Die Checkliste wird angezeigt.
FTP-Endpunkt erstellen, auswählen oder bearbeiten
- Klicken Sie auf die Task Endpunkt auswählen in der Checkliste 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 folgenden 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 einen vorhandenen Endpunkt 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 folgenden 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.
- Erstellen oder bearbeiten Sie einen FTP-Endpunkt: FTP-Endpunkt erstellen oder bearbeiten
Aktivität konfigurieren
- Wählen Sie die Task Konfigurieren aus der Checkliste aus. Das Teilfenster 'Konfigurieren' wird angezeigt.
- Konfigurieren Sie alle Felder in diesem Teilfenster wie in der folgenden Tabelle beschrieben:
Tabelle 1. Feld |
Beschreibung |
Suchen nach |
|
Dateiname |
Dieses Feld wird für diese Aktivität nicht verwendet. Sie geben den Namen der zu löschenden Datei 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 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 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.
Während der Laufzeit wird der im Feld Im Verzeichnis der Task Konfigurieren angegebene Wert überschrieben, wenn ein Wert für den optionalen Eingabeparameter directory angegeben und dazu eine der folgenden Optionen benutzt wurde: - Der Eingabeparameter directory wurde einer Variablen zugeordnet.
- Für den Eingabeparameter directory wurde ein Standardwert angegeben.
Weitere Informationen finden Sie unter der Prozedur "Eingabe der Aktivität zuordnen".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.
|
Wiederholungsoptionen angeben
- Wählen Sie die Task Wiederholung in der Checkliste aus. Das Teilfenster '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 maximale Anzahl der Versuche der Integrationseinheit (Integration Appliance) an, 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 Aktivität FTP - Datei löschen (delete) 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.
|
Eingabe der Aktivität zuordnen
- Wählen Sie die Task Eingaben zuordnen in der Checkliste aus. Das Teilfenster 'Wiederholung' wird angezeigt. Die Eingabeparameter der Aktivität werden im Teilfenster 'An Aktivität' angezeigt.
- Sie müssen dem Eingabeparameter filename eine Variable zuordnen. Alle anderen Eingabeparameter sind optional. Der Parameter
filename gibt den Namen der Datei an, die auf dem FTP-Server gelöscht werden soll.
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 Sie 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 Checkliste 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 Datei löscht, kann in der Task Konfigurieren das Verzeichnis 'process' definiert werden. Während der Laufzeit kann dann der Verzeichnisname processXML ü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 aus dem Verzeichnis processXML gelöscht werden.
Tabelle 3. Name des Eingabeparameters/Knotens |
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. |
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 Aktivität FTP - 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. |