Documentation Index

Fetch the complete documentation index at: https://docs.lobstersoftware.com/llms.txt

Use this file to discover all available pages before exploring further.

FTP/FTPS (Eingangsagent)

Prev Next

Der Integration Server kann als FTP-Server arbeiten. Der Eingangsagent FTP/FTPS nimmt dann Dateien von FTP-Benutzern an und startet damit ein Profil. Ein Eingangsagent ist die Komponente, die ein Profil auf ein eingehendes Ereignis reagieren lässt. Dieser Artikel beschreibt die Einstellungen des Eingangsagenten und seine Arbeitsweise.

Die Adresse des FTP-Servers folgt diesem Muster.

ftp(s)://<URL oder IP des Integration Servers>

Zuordnung einer Datei zu einem Profil

Lobster prüft jede per FTP hochgeladene Datei. Die Prüfung entscheidet, ob die Datei zu einem Profil passt. Ein Profil passt unter drei Bedingungen:

  • Der Benutzer stimmt mit der Angabe im Profil überein.

  • Das Verzeichnis stimmt mit der Angabe im Profil überein.

  • Das Dateimuster trifft zu.

Bei einem Treffer startet Lobster einen Job. Wenn mehrere Profile eine Nachricht annehmen können, entscheidet das Profil-Scoring.

Dieser Eingangsagent prüft auf Wunsch die Maximalgröße der Eingangsdateien. Siehe Abschnitt Maximalgröße für Messages und Dateien.

Den Benutzernamen des FTP-Benutzers finden Sie in der System-Variable VAR_SENDER.

Einstellungen

Einstellungen des FTP/FTPS-Eingangsagenten mit den Nummern 1 bis 6

Feld oder Option

Beschreibung

Dateimuster

Legt das Muster für den Dateinamen fest. Mehrere Muster trennen Sie mit dem Pipezeichen |. Beispiel: *.txt|*.csv.

Nur bei Unterverzeichnis

Schränkt die Reaktion auf ein bestimmtes Verzeichnis ein. Das Profil berücksichtigt dann nur Dateien aus diesem Verzeichnis, die dem Dateimuster entsprechen.

Das Verzeichnis kann den Platzhalter $USER$ enthalten. Lobster ersetzt diesen Platzhalter durch die Login-Kennung. So bilden Sie zum Beispiel /daten/$USER$/ablage ab.

Erst bei Logout empfangene Daten verarbeiten

Startet die Verarbeitung der Daten erst beim Logout des jeweiligen Benutzers. Siehe auch die System-Variable VAR_SYS_LASTINBULK.

Leere Dateien akzeptieren

Nimmt auch leere Dateien mit 0 Bytes an.

 WICHTIG:  Damit leere Dateien den Eingangsagenten überhaupt erreichen, muss die System-Property hub.datawizard.acceptEmptyFtpFiles den Wert true haben.

Liste links

Zeigt alle im System definierten und aktiven FTP-Kanäle. Über die Pfeil-Buttons in der Mitte verschieben Sie einen Kanal in die Liste rechts.

Ausgewählte Partnerkanäle

Enthält alle ausgewählten und aktiven FTP-Kanäle. Wählen Sie mindestens einen Kanal aus.

Arbeitsweise des Eingangsagenten

Schema der Arbeitsweise des FTP-Eingangsagenten mit FTP-Verbindungen, Verzeichnissen und Job-Queue

Der FTP-Server stellt eine maximale Anzahl von FTP-Verbindungen bereit. Über diese Verbindungen stellen FTP-Benutzer Dateien in die zugewiesenen Verzeichnisse ein.

Nach dem erfolgreichen Einstellen oder Umbenennen prüft Lobster sofort, ob ein Profil die Datei verarbeiten soll. Bei einem zutreffenden Profil stellt Lobster einen Job in die Job-Queue. Im Normalfall ist die Job-Queue leer, und die Verarbeitung startet unmittelbar. Lobster sichert die Datei dann sofort als Job-Backup und löscht die ursprüngliche Datei.

Zeitverhalten

Die folgende Abbildung zeigt das Zeitverhalten bei einer Übertragung.

Zeitachse einer FTP-Übertragung mit den drei Zeitpunkten Übertragungsstart, Backup und Löschen der Datei

Nr.

Vorgang

1

Die Übertragung der ersten Datei startet.

2

Die Übertragung ist erfolgreich. Lobster legt sofort ein Backup an und beginnt mit der Analyse der Quelldaten.

3

Nach dem Backup löscht Lobster die eingestellte Datei. Die Datei ist deshalb nur kurz im Verzeichnis sichtbar.

Lobster arbeitet die verschiedenen FTP-Verbindungen parallel ab. Daraus ergibt sich eine Einschränkung für Clients, die nach dem Einstellen die Existenz der Dateien prüfen: Bis zum Eintreffen des get-Befehls hat Lobster die Dateien meist schon aus dem FTP-Verzeichnis gelöscht.

Betrieb und Herunterfahren

 HINWEIS: In Zusammenarbeit mit einem DMZ-Server können Sie die Benutzerverwaltung des DMZ-Servers verwenden.

Beim Herunterfahren des Integration Servers können noch FTP-Benutzer angemeldet sein. Der Integration Server beendet diese Sessions normalerweise nach einer einstellbaren Wartezeit. Anschließend fährt er den FTP-Service herunter.

Mit der Option stopServices steuern Sie dieses Verhalten. Wenn die Option aktiviert ist, ignoriert der FTP-Service die maximale Wartezeit. Die Option gilt auch für den SMTP-Service.

Das folgende Listing zeigt die Option. Sie steht in der Konfigurationsdatei ./etc/startup.xml im Abschnitt com.ebd.hub.datawizard.app.DataWizard. Standardmäßig ist dieser Eintrag auskommentiert.

<Set name="stopServices">false</Set>