---

Einführung: Eine Beschreibung dieser Phase finden Sie im Abschnitt Phase 1 (Einführung).

---

Lobster_data kontaktiert einen FTP-Server und durchsucht ein Verzeichnis nach Dateien, die dem Suchmuster (Dateimuster) entsprechen. Es wird nur das angegebene Verzeichnis, keine Unterverzeichnisse durchsucht. Die Dateien werden in der Reihenfolge abgearbeitet, in der sie vom FTP-Server geliefert werden. Eine Sortierung auf Clientseite wird nicht vorgenommen.

Hinweis: Siehe auch Abschnitt Dateinamen, Dateimuster, Pfade, System-Konstanten und Variablen.

(1) Es kann zwischen den Protokollen FTP, SFTP und FTPS gewählt werden. Siehe auch (3).

(2) Daten über den DMZ-Server empfangen. Wenn kein DMZ konfiguriert ist, ist diese Checkbox ohne Wirkung. Dabei wird der DMZ-Rechner kontaktiert, dieser führt die FTP-Kommandos aus, empfängt die Dateien und speichert sie lokal ab. Danach werden diese Dateien vom DMZ-Rechner über einen internen Systemkommunikationspartner per FTP geholt und verarbeitet. Diese Option steht nur zur Verfügung, wenn in (3) ein Kanal konfiguriert ist. Achtung: Der interne Kommunikationspartner DMZ Internal wird automatisch angelegt, darf aber nicht geändert werden.

(3) Hier kann ein Kanal des Typs FTP (für Protokolle FTP und FTPS) oder SSH (für Protokoll SFTP) ausgewählt werden. Hinweis: Wenn möglich, sollten immer Kanäle verwendet werden, damit Verbindungsparameter zentral verwaltet werden können. Neben der erhöhten Übersichtlichkeit erleichtert das auch die Pflege. Ändern sich die Verbindungsparameter, müssen Sie nur an einer Stelle nachpflegen und vergessen zudem auch kein Profil. Hinweis: Siehe auch Abschnitt FTP, FTPS, SSH, SCP, SFTP.

(4) DNS-Name oder IP-Adresse und der Port des zu erreichenden FTP-Servers. Wird für den Port der Wert 0 angegeben, dann wird entweder der Standardport (./etc/ftp.xml) verwendet (wenn kein Kanal ausgewählt ist) oder der Port, der im Kanal angegeben ist, verwendet (wenn ein Kanal ausgewählt ist). Wird ein Port > 0 angegeben, dann wird dieser verwendet.

(5) Benutzer und Kennwort für das Zielsystem. Es ist darauf zu achten, dass der eingetragene Benutzer für das angegebene Verzeichnis auch Zugriffsrechte besitzt. Wenn die Verbindung zu einem Value Added Network (VAN) erfolgt, ist eventuell zusätzlich zum Benutzer die Angabe des GXS-Kontos notwendig.

(6) Im passiven Modus baut der Client die Kontroll- und die Datenverbindung auf. Normalerweise (im aktiven Fall) baut der Server die Datenverbindung auf, aber es kann sein, dass der dafür nötige Port von der dortigen Firewall blockiert wird.

(7) Verzeichnis, in dem die Dateien gesucht werden. Hier ist auch die Verwendung von Variablen und Platzhaltern für Zeitangaben zulässig.

(8) Als Kommando zur Erstellung der Dateiliste wird das FTP-Kommando NLST statt des FTP-Kommandos LIST verwendet. Die Erstellung der Dateiliste ist damit schneller, aber es werden nur die Namen der Dateien und keine anderen Informationen (z. B. ob es sich um ein Verzeichnis handelt) geliefert. Da die Antwort des Kommandos LIST nicht genormt ist, kann es beim Einlesen der empfangenen Daten Probleme geben. Die Verwendung des schnellen Listenmodus schafft Abhilfe bei Fehlern dieser Art.

(9) Muster für den Dateinamen. Die Dateien können für die Verarbeitung sortiert werden nach Dateiname in absteigender oder aufsteigender Reihenfolge oder wie sie vom Betriebssystem geliefert werden.

(10) Die gelesene Datei kann auf die folgenden Arten behandelt werden.

• nicht löschen. Veranlasst Lobster_data, die gelesene Datei nicht zu löschen. Eine gegebenenfalls vorhandene Kontrolldatei wird ebenfalls nicht gelöscht.

• löschen. Veranlasst Lobster_data, die gelesene Datei und eine gegebenenfalls vorhandene Kontrolldatei zu löschen.

• umbenennen. Veranlasst Lobster_data, die gelesene Datei umzubenennen. Der neue Dateiname kann im zugehörigen Eingabefeld angegeben werden. Eine gegebenenfalls vorhandene Kontrolldatei wird weder gelöscht noch umbenannt. Mit den folgenden Platzhaltern kann auf den Namen der verarbeiteten Datei Bezug genommen werden.

  • <file> ist der vollständige Name der verarbeiteten Datei.

  • <file-prefix> ist der Name der verarbeiteten Datei ohne Dateierweiterung.

(11) Veranlasst Lobster_data, eine Datei erst zu lesen, wenn eine zugehörige Kontrolldatei vorhanden ist. Kontrolldateien werden bei Wert nicht löschen in (10) ebenfalls nicht gelöscht. Siehe auch Beispiel in (12). Siehe auch System-Variable VAR_SYS_CTRL_FILE.

(12) Dateiendung bzw. -beginn der Kontrolldatei. Beispiel: Wird der Suffix .ctrl in das Feld eingetragen, dann wird bei der Datei name1.txt nach der Kontrolldatei name1.txt.ctrl gesucht. Bitte beachten Sie, dass der Punkt im Suffix .ctrl explizit angegeben werden muss.

(13) Mit dieser Option wird nicht pro Datei eine eigene Kontrolldatei erwartet, sondern eine Kontrolldatei für ein Verzeichnis. Der Job wird dann gestartet, wenn diese Datei im Quellverzeichnis existiert.

(14) Ist diese Checkbox gesetzt, wird erreicht, dass mehrere Instanzen dieses Profils parallel arbeiten können. Die Checkbox Profil darf nur in einer Instanz laufen darf für dieses Profil nicht gesetzt werden.

(15) Leere Dateien werden auf dem entfernten System immer gelöscht, unabhängig von der Einstellung in (10).

(16) Auch bei leeren Dateien entstehen Jobs für das Profil, wenn diese Option aktiviert ist. Hinweis: In einer DMZ-Umgebung kann der DMZ-Rechner mit folgender Startoption in der Konfigurationsdatei ./etc/startup.xml gestartet werden, um das Verhalten zu steuern.

• skip: (Default) Leere Datei bleibt auf dem DMZ-Server liegen. Logeintrag in DmzEvents.

• delete: Leere Datei wird auf dem DMZ-Server gelöscht.

• transfer: Leere Datei wird an das Profil übertragen und Option (8) wirkt.

(17) Gibt an, ob die Hauptdatei nach der Abholung der Dateien gelöscht werden soll. Achtung: Falls Dateien innerhalb der Hauptdatei stehen, die nicht dem Dateimuster (9) entsprechen, wird die Hauptdatei trotzdem gelöscht.

(18) Hier können zusätzliche FTP-SITE-Befehle und Standard-FTP-Befehle angegeben werden (entsprechend RFC 959). Welche SITE-Befehle hier angegeben werden können, hängt davon ab, welche Befehle der jeweilige FTP-Server unterstützt (mit SITE HELP liefert der FTP-Server manchmal eine Liste seiner spezifischen SITE-Befehle). Geben Sie den zusätzlichen FTP-Befehl somecommand an, dann wird intern der FTP-Befehl SITE somecommand versendet. Möchten Sie Standard-FTP-Befehle verschicken, dann verwenden Sie bitte das Präfix rfc:. Geben Sie also den zusätzlichen FTP-Befehl rfc:CDUP an, dann wird intern der FTP-Befehl CDUP versendet. Wenn vor dem Befehl ein Präfix before: steht, wird er vor der Dateiübertragung gesendet, sonst danach. Um also das Kommando CDUP vor der Dateiübertragung zu senden, muss before:rfc:CDUP verwendet werden. Hinweis: Beim Senden von Kommandos wird der Return-Code vom Server geprüft und dabei werden alle Werte 2xx außer 202 akzeptiert. Bei anderen Werten erzeugt das Profil einen Fehler. Hinweis: Auch Variablen aus dem Profil können in der Form @VARNAME@ verwendet werden, um die zusätzlichen Befehle anzugeben. Hinweis: Zusätzliche FTP-Befehle können nicht mit SFTP (1) genutzt werden. Hinweis: Die erfolgreiche Ausführung der SITE-Befehle an sich wird nicht überprüft, d. h. Lobster _data erzeugt keinen Fehler, wenn ein SITE-Befehl fehlschlägt (außer bei einer IO-Exception).