Mail (SMTP) (Eingangsagent)
URL: smtp(s)://<URL oder IP des Integration Servers> (siehe auch SmtpService)
Dieser Eingangsagent kann E-Mails über den im Integration Server integrierten E-Mail-Server empfangen. Siehe auch Abschnitt Besonderheit für Eingangsagenten, die Daten zwingend abholen müssen. Für jede eingehende E-Mail wird geprüft, ob sie einem Profil zugeordnet werden kann. Kann ein Profil ermittelt werden, wird ein Job gestartet. Eine E-Mail kann einem Profil zugeordnet werden, wenn E-Mail-Adresse und Dateimuster mit den Angaben im Profil übereinstimmen. Wenn mehrere Profile bereit sind, eine konkrete Nachricht anzunehmen, entscheidet das Profil-Scoring. Siehe auch Abschnitt Nicht zuordenbare Mail-Eingänge und Archivierung von E-Mails und X.400-Mails.
Einstellungen
(1) Kanal-Auswahl: Hier kann ein in der Partnerverwaltung definierter Kanal vom Typ "Mail" dem Profil zugewiesen werden. Ist ein Kanal zugewiesen, werden die für diesen definierten Daten verwendet. Ist kein Kanal zugewiesen, werden die Einstellungen des SMTP-Dienstes des Integration Servers verwendet. Hinweis: Als Hintergrundwissen sei hier erwähnt, dass jeder eingehenden E-Mail intern eine Kanal-ID zugeordnet wird. Dabei wird die ID desjenigen Kanals verwendet, dessen "Eigene Kennung" (die eigene E-Mail-Adresse bei einem Kanal des Typs Mail) mit der Empfänger-Adresse der eingehenden E-Mail übereinstimmt und dessen "Partner-Kennung" (die E-Mail-Adresse des Partners bei einem Kanal des Typs Mail) mit der Absender-Adresse der eingehenden E-Mail übereinstimmt. Der somit intern ermittelte Kanal wird dann mit dem hier ausgewählten Kanal verglichen. Siehe (2) und (3).
(2) Gilt auch für Kommunikations-Kanäle mit gleicher eigener Kennung: Normalerweise werden bei ausgewähltem Partnerkanal nur die E-Mails angenommen, die genau diesem Kanal entsprechen. Es ist aber denkbar, dass ein Partner E-Mails von verschiedenen Adressen versendet, die alle akzeptiert werden sollen. Dann wird es mehrere Partnerkanäle geben, die verschiedene Partneradressen, aber die gleiche eigene Adresse (eigene Kennung) haben. Wenn diese Checkbox hier gesetzt ist, werden nicht nur die Nachrichten akzeptiert, die über den ausgewählten Kanal eintreffen, sondern alle Nachrichten, die über Kanäle eintreffen, die die gleiche eigene Kennung haben wie der ausgewählte Kanal. Die Weitergabe anderer Attachments, die nicht mit dem Dateimuster (10) übereinstimmen, an andere Profile für den gleichen Kanal, wird dann erweitert auf alle Profile, die einen Kanal ausgewählt haben, der die gleiche eigene Kennung hat. Achtung: Wenn die Nachricht über einen Kanal eintrifft, wird sie nicht an Profile übergeben, die keinen Kanal verwenden, selbst wenn sie die richtigen Adressparameter direkt eingetragen haben.
(3) Kommunikations-Kanal in der empfangenen ignorieren: Der Kanal, der der empfangenen E-Mail zugeordnet wird, wird ignoriert, siehe (1) und (2).
(4) Empfänger-Adresse: E-Mail-Adresse des Empfängers der E-Mail. Dieses Feld muss einen Wert haben. Hinweis: Siehe auch (1).
(5) Auch RcptTo Adresse beachten: Ist diese Checkbox gesetzt, wird nicht nur die To-, sondern auch die RcptTo-Adresse beachtet.
(6) Absender Adresse: Das Feld dient zur Eingrenzung von Profilen auf bestimmte Absender. Ist das Feld leer, wird der Absender der Mail nicht berücksichtigt. Existiert ein Eintrag in diesem Feld, wird untersucht, ob der Absender der E-Mail die in diesem Feld eingetragene Zeichenkette enthält. Dabei wird die Groß-/Kleinschreibung ignoriert. Das heißt, es reicht z. B. aus, die Domäne der Adresse des Absenders in diesem Feld einzutragen. Die Eingabe von regulären Ausdrücken oder von mehreren Zeichenketten ist nicht möglich.
(7) Betreff enthält: Das Feld dient zur Eingrenzung von Profilen auf E-Mails mit einen bestimmten Betreff. Ist das Feld leer, wird der Betreff der E-Mail nicht berücksichtigt. Es wird untersucht ob der Betreff der E-Mail die in diesem Feld eingetragene Zeichenkette enthält. Dabei wird die Groß-/Kleinschreibung ignoriert. Ist die Zeichenkette enthalten, wird der Betreff akzeptiert. Aufzählung mittels Semikolon ist nicht möglich. Die Verwendung eines regulären Ausdrucks ist mit dem Präfix regex: möglich.
(8) Nachrichtentext (Mail body) verarbeiten: Ist diese Checkbox gesetzt, wird ausschließlich der Mitteilungstext der E-Mail (Body) berücksichtigt. Die Attachments der E-Mail werden vom Eingangsagenten ignoriert, auch wenn ein Dateimuster (10) angegeben wurde. Ist die Checkbox nicht gesetzt, werden ausschließlich die Attachments der E-Mail berücksichtigt. Der Inhalt des Mitteilungstextes wird ignoriert. Hinweis: Die System-Variable VAR_SYS_MAIL_BODY wird mit dem E-Mail-Body befüllt.
(9) MIME-Typ Nachrichtentext: MIME-Type des empfangenen Nachrichtentextes. Default ist text/plain für einfache Text-E-Mails. Wenn der Absender HTML-E-Mails sendet, kann man auf text/html umstellen. Ein HTML-E-Mail enthält üblicherweise zwei Bodies, einen HTML-Text mit MIME-Type text/html und einen einfachen Text mit MIME-Type text/plain. Siehe auch (8).
(10) Dateimuster Mail-Anhang: Muster für den Dateinamen. Es können mehrere, durch das Pipezeichen (|) getrennte, Dateimuster eingetragen werden (z. B. *.txt|*.csv). Die E-Mails können beliebig viele Attachments enthalten, jedoch werden alle Anhänge ignoriert, die nicht dem Dateimuster entsprechen.
Hinweis: Es kann vorkommen, dass beim Herunterfahren von noch SMTP-Benutzer angemeldet sind. Normalerweise werden diese Verbindungen beendet und der SMTP-Service heruntergefahren. Sollen die SMTP-Sitzungen jedoch nicht automatisch beendet werden, kann dieses Verhalten mit der Option stopServices eingestellt werden. Das folgende Listing zeigt die Option in der Konfigurationsdatei ./etc/startup.xml im Abschnitt com.ebd.hub.datawizard.app.DataWizard. Per Default ist dieser Eintrag auskommentiert. Hinweis: Die Option gilt auch für den FTP-Service.
<
Set
name
=
"stopServices"
>false</
Set
>
System-Variablen
Es stehen mehrere System-Variablen für empfangene E-Mails zur Verfügung. Speziell erwähnt werden soll hier VAR_SYS_MAIL_HEADER_<Name des Mail-Headers in Großbuchstaben>. Beispiel: Die Variable VAR_SYS_MAIL_HEADER_DATE erhält den originalen String-Wert des Mail-Headers Date. Aus der Mail-Header-Zeile Date: Wed, 6 Sep 2017 13:50:01 +0300 wird der Variableninhalt Wed, 6 Sep 2017 13:50:01 +0300.
Siehe auch VAR_SYS_ATTACHMENT_NAME.