Skip to main content
Skip table of contents

POP/SMTP

Der Adapter Sendet und empfängt E-Mail-Nachrichten über SMTP (Simple Mails Transfer Protocol) bzw. POP3 (Post Office Protocol v3).

Der Adapter unterstützt Dateianhänge und MIME-Typ-Angaben für den E-Mail-Body u.a. zum Versenden von HTML-E-Mails. Zudem wird das Senden und Empfangen von S/MIME-verschlüsselten und/oder -signierten E-Mail-Nachrichten unterstützt.

Eigenschaften (Properties)

I/O Mode (input_type)

Art der Quelle der zu verarbeitenden Daten

Mögliche Werte:

  • Actions: Daten aus dem vorangegangenen Prozess-Schritt verarbeiten

  • Directory: Alle Dateien eines angegebenen Ordners als Anhang verarbeiten (oder Dateien gemäß Filterregel in Parameter filter)

File name (documentname)

Name des zu sendenden Dateianhangs (wenn I/O Mode auf Actions gesetzt ist).

Wenn diese Eigenschaft dynamisch parametriert werden soll, muss im zugehörigen XSL-Mapping der technische Name verwendet werden. Dieser Name kann abweichen und ist in Klammern angegeben.

Beispiel

XML 
<xsl:processing-instruction name="DynamicParameter">
	documentname="
	<xsl:value-of select="."/>
	"
</xsl:processing-instruction>

Mögliche Werte:

  • Beliebiger Dateiname (z.B. Data.xml)

  • Mehrere Dateinamen, durch Semikolon getrennt (wenn Sie dem Transfer-Adapter über Fork/Join mehrere Input-Dokumente übergeben, dann können auch mehrere Dateien gemäß der Priorität der Verzweigungen nacheinander verarbeitet werden (z.B. File1.xml;File2.xml)

Delete (delete)

E-Mail nach erfolgreichem Empfang vom POP3-Server löschen (wenn Eigenschaft Operation auf Receive gesetzt ist)

Operation (action)

Bestimmt, welche Operation mit den verarbeiteten Dateien durchgeführt wird. Je nach Wert in I/O Mode unterscheidet sich die Funktionsweise des Adapters.

Mögliche Werte:

  • Send: E-Mail über den SMTP-Server senden

  • Receive: E-Mail vom POP3-Server empfangen

Parameter

from

E-Mail-Adresse des Absenders; Bei Bedarf mit Angabe einer Anzeigenamens

Mögliche Werte: Beliebige gültige E-Mail-Adresse (z.B. name@domain.tld (SampleName))

sender

Technischer Absender (falls abweichend von from), der die Nachricht verschickt; Bei Bedarf mit Angabe einer Anzeigenamens

Mögliche Werte: Beliebige gültige E-Mail-Adresse (z.B. name@domain.tld (SampleName))

to

E-Mail-Adresse(n), an die die E-Mail gesendet werden soll; Bei Bedarf mit Angabe einer Anzeigenamens

Mögliche Werte: Beliebige gültige E-Mail-Adresse, bei mehreren Adressen durch Semikolon getrennt (z.B. name@domain.tld;email@host.tld (SampleName))

cc

E-Mail-Adresse(n), an die die E-Mail als Kopie gesendet werden soll; Bei Bedarf mit Angabe einer Anzeigenamens

Mögliche Werte: Beliebige gültige E-Mail-Adresse, bei mehreren Adressen durch Semikolon getrennt (z.B. name@domain.tld (SampleName);email@host.tld)

bcc

E-Mail-Adresse(n), an die die E-Mail als Blindkopie gesendet werden soll; Bei Bedarf mit Angabe einer Anzeigenamens

Mögliche Werte: Beliebige gültige E-Mail-Adresse, bei mehreren Adressen durch Semikolon getrennt (z.B. name@domain.tld;email@host.tld (SampleName))

replyTo

E-Mail-Adresse, an die eine Antwort verschickt werden soll

Mögliche Werte: Beliebige gültige E-Mail-Adresse (z.B. name@domain.tld)

subject

Betreff der E-Mail

body

Inhalt der E-Mail (wenn die Input-Daten des Adapters ein HTML-Dokument ist, so wird dieses als HTML-Nachrichten-Body verwendet)

Mögliche Werte: Beliebige Zeichenkette

mimeTypeBody

MIME-Typ des E-Mail-Inhalts (ermöglicht die Darstellung von HTML-E-Mails oder mehreren Anhängen)

Mögliche Werte: Gültige MIME-Typen (z.B. multipart/mixed)

charset

Zu verwendender Zeichensatz des E-Mail-Inhalts

Mögliche Werte: Gültige Zeichensatz-Angabe (z.B. ISO-8859-15)

smtp

IP-Adresse oder Host-Name des SMTP-Servers zum Senden von E-Mails

Mögliche Werte: Beliebige gültige Zeichenkette (z.B. smtp.domain.tld)

smtpPort

Port des SMTP-Servers zum Senden von E-Mails

Mögliche Werte: Beliebige positive ganze Zahl, z.B. 250

smtpSecurityProtocol

Zu verwendendes SMTP-Sicherheitsprotokoll

Mögliche Werte: 

  • NONE: Kein Protokoll verwenden
  • TLS: TLS als Sicherheitsprotokoll verwenden
  • SSL: SSL als Sicherheitsprotokoll verwenden
smtpAllowAllHosts

Alle Hosts für SMTP erlauben

Bitte beachten Sie, dass auch Hosts erlaubt werden, die kein gültiges Zertifikat haben.

(info) Dieser Parameter ist nur gültig, wenn SSL als Sicherheitsprotokoll verwendet wird.

pop3

IP-Adresse oder Host-Name des POP3-Servers zum Empfangen von E-Mails

Mögliche Werte: Beliebige gültige Zeichenkette (z.B. pop3.domain.tld)

pop3Port

Port des POP3-Servers zum Empfangen von E-Mails

Mögliche Werte: Beliebige positive ganze Zahl

pop3SecurityProtocol

Zu verwendendes POP3-Sicherheitsprotokoll

Mögliche Werte: 

  • NONE: Kein Protokoll verwenden
  • TLS: TLS als Sicherheitsprotokoll verwenden
  • SSL: SSL als Sicherheitsprotokoll verwenden
pop3AllowAllHosts

Alle Hosts für POP3 erlauben

Bitte beachten Sie, dass auch Hosts erlaubt werden, die kein gültiges Zertifikat haben.

(info) Dieser Parameter ist nur gültig, wenn SSL als Sicherheitsprotokoll verwendet wird.

login

Benutzername für den POP3-Server (beim Empfangen einer E-Mail) oder für den SMTP-Server (beim Senden einer E-Mail)

Mögliche Werte: Beliebige Zeichenkette (z.B. name@domain.tld)

password

Passwort für den POP3-Server (beim Empfangen einer E-Mail) oder für den SMTP-Server (beim Senden einer E-Mail)

oAuth2

Legt fest, ob das OAuth 2.0-Protokoll zum Log-In verwendet werden soll.

Mögliche Werte:

  • ja: oAuth2 wird zum Log-in verwendet
  • nein: oAuth2 wird nicht zum Log-in verwendet

Wenn OAuth 2.0 verwendet werden soll,

  • muss die SSL-Verschlüsselung für die Verbindung zum POP-Server durch setzen des Parameters ssl aktiviert sein.
  • muss beim Parameter password der Access Token eingetragen werden. 
oAuth2_twoLineAuth

Aktiviert das POP3-Protokoll für Microsoft 365.

Muss zusätzlich zu oAuth2 aktiviert werden, um das POP3-Protokoll mit Microsoft 365 zu nutzen.

Mögliche Werte:

  • ja: oAuth2_twoLineAuth wird zusätzlich zu oAuth2 aktiviert
  • nein: oAuth2_twoLineAuth wird nicht zusätzlich zu oAuth2 aktiviert
file_limit

Anzahl der zu sendenden Dateianhänge begrenzen (wenn I/O Mode auf Directory gesetzt ist und somit mehrere Dateien eines Ordners angehängt werden sollen)

Mögliche Werte:

  • Beliebige positive ganze Zahl

  • 0: Keine Dateien anhängen (Standard)

dir

Lokaler Ordner auf dem X4 Server, z.B. im X4 Repository, in dem Dateien liegen, die als Dateianhänge per E-Mail gesendet werden sollen (wenn I/O Mode auf Directory gesetzt ist)

Mögliche Werte: Beliebige Zeichenkette (z.B. %USER_COLLECTION%\Folder)

filter

Zu versendenden Datei-Anhänge nach Dateinamen filtern über die Platzhalter * und ?

Mögliche Werte:

  • Beliebige Zeichenkette, so gilt beispielsweise *.dat nur für Dateien mit der Dateiendung *.dat

  • *: Alle Dateien verwenden (Standard)

EML

Nachricht im EML-Format verschicken (dies erfordert eine EML-Nachricht als Adapter-Input) oder Nachricht im EML-Format empfangen

Mögliche Werte:

  • ja: Im EML-Format verschicken

  • nein: Standard-E-Mail-Format verwenden (Standard)

base64

Anhänge von Nachrichten (Multipart-Teile) immer Base64-kodieren (wenn die Eigenschaft Operation auf Receive gesetzt ist)

Mögliche Werte:

  • ja: Alle Multipart-Teile Base64-kodieren

  • nein: Nicht Base64-kodieren (Standard)

encrypt

Nachricht mit S/MIME verschlüsseln (Multipart/Encrypted)

Mögliche Werte:

  • ja: S/MIME-Verschlüsselung aktivieren (erfordert die Angabe zur Schlüssel-/Zertifkatsdatei in Parameter Pkcs12 und der Passphrase in Parameter passphrase)

  • nein: Keine Verschlüsselung (Standard)

sign

Nachricht mit S/MIME signieren (Multipart/Signed)

Mögliche Werte:

  • ja: S/MIME-Signatur hinzufügen (erfordert die Angabe zur Schlüssel-/Zertifikatsdatei in Parameter Pkcs12 und der Passphrase in Parameter passphrase)

  • nein: Keine Signatur (Standard)

Pkcs12

Pfad zur einer gültigen Schlüssel-/Zertifikatsdatei im PKCS#12-Format

Mögliche Werte: Beliebige gültige Pfadangabe im lokalen Dateisystem des X4 Servers (z.B. %USER_COLLECTION\Project\Folder\Key.p12)

passphrase

Passwort/Passphrase zur Schlüssel-/Zertifikatsdatei im PKCS#12-Format, die Sie in Parameter Pkcs12 angegeben haben

Mögliche Werte: Beliebige gültige Zeichenkette

propertiesType

Datenformat für eine Properties-Datei, in der weitere JavaMail-Properties hinterlegt werden können

Mögliche Werte:

propertiesUrl

Veralteter Parameter

Ab Version 6.2.0 der X4 BPMS kann das zu verwendende Sicherheitsprotokoll über die Parameter smtpSecurityProtocol und pop3SecurityProtocol gesetzt werden.

Beim Verwenden des nun veralteten Parameters propertiesURL wird eine Warnung im Server-Log ausgegeben.

URL zu einer Properties-Datei, in der weitere JavaMail-Properties hinterlegt werden können, siehe https://javamail.java.net/nonav/docs/api/com/sun/mail/smtp/package-summary.html. Die verknüpfte Datei muss im Format vorliegen, das im Parameter propertiesType angegeben wurde.

(info) Wird die propertiesURL gesetzt, werden die Parameter aus der Properties-Datei verwendet. Andernfalls werden die Adapter-Parameter verwendet.

Mögliche Werte: Beliebige gültige URL, z.B. xstore://Project/Folder/File.properties

Welche E-Mail-Adressen formal gültig sind, kann den Richtlinien RFC 5321 und RFC 5322 entnommen werden.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.

Contact Support Close