IMAP
Der Adapter empfängt, kopiert/verschiebt oder löscht eine E-Mail-Nachricht in einem IMAP-Postfach (Internet Message Access Protocol), setzt ein Flag oder listet Nachrichten-Header in einem Ordner eines IMAP-Postfachs.
Der Adapter unterstützt mit S/MIME verschlüsselte/signierte Nachrichten sowie die SSL-Verschlüsselung der Verbindung zum IMAP-Server (IMAPS). Aus einer Properties-Datei können beliebige Java Mail Properties verarbeitet werden.
Hinweis:
Die Standard-Blockgröße (16 KB) bei der Nachrichtenübertragung kann über die JavaMail-System-Eigenschaft mail.imap.fetchsize
in der Laufzeitumgebung des X4 Servers (i.d.R. Java-VM mit Applikations-Server) gesetzt werden, um das Herunterladen der E-Mails via IMAP optimiert.
Beispiel für das Startskript von JBoss, die Blockgröße wird auf 5 MB gesetzt:
@set JAVA_OPTS=%JAVA_OPTS% -Dmail.imap.fetchsize=5242880
Eigenschaften (Properties)
| Bestimmt, welche Operation der Funktions-Adapter durchführt Mögliche Werte:
Hinweis: Eine Weiterleitung der empfangenen Nachricht ist mit direkter Anbindung des IMAP-Adapters an den POP/SMTP-Adapter möglich.
|
Parameter
| Hauptklasse des Adapters (nicht verändern!) Mögliche Werte: de.softproject.integration.adapter.imap.Adapter: Hauptklasse (Standard) |
| IP-Adresse oder Host-Name des IMAP-Servers Mögliche Werte: Beliebige gültige Zeichenkette (z. B. imap.1und1.de) |
| Benutzername für das verwendete E-Mail-Konto Mögliche Werte: Beliebige Zeichenkette |
| Passwort für das verwendete E-Mail-Konto Mögliche Werte: Beliebige Zeichenkette |
| Legt fest, ob das OAuth 2.0-Protokoll zum Log-In verwendet werden soll. Mögliche Werte:
Wenn OAuth 2.0 verwendet werden soll,
|
| Zielordner auf dem IMAP-Server (wenn die Eigenschaft Operation auf Copy Message oder Move Message gesetzt ist) oder Ordner, dessen Nachrichten aufgelistet werden soll (wenn die Eigenschaft Operation auf List Messages gesetzt ist) Mögliche Werte: Vorhandener Ordnername (Groß-/Kleinschreibung beachten) Häufig verwendet:
|
| Quellordner für die Aktionen Copy Message, Move Message, Receive Message, Set Flag und Delete Message. Mögliche Werte: Vorhandener Ordnername (Groß-/Kleinschreibung beachten) Häufig verwendet:
|
| IMAP-Flag(s) zur Kennzeichnung einer E-Mail-Nachricht; Mehrere Flags werden durch Semikolon (;) getrennt (wenn die Eigenschaft Operation auf Set Flag gesetzt ist) Mögliche Werte: Beliebiges Flag (z. B. \Answered) |
| Nachrichten-ID der E-Mail inklusive Ordnerangabe Mögliche Werte: Ordnername und Nachrichten-ID (mit spitzen Klammern) (z. B. INBOX/<831921101.31255094008434.Java Mail.javamailuser@localhost>) |
| Nachrichten-ID auf dem IMAP-Server Mögliche Werte: Beliebige ganze Zahl |
| Anzahl der aufzulistenden Nachrichten begrenzen, wenn die Eigenschaft Operation auf List Messages gesetzt ist. Die Auflistung beginnt mit den ältesten Nachrichten im Ordner. Mögliche Werte: Beliebige ganze Zahl |
| Anhänge von Nachrichten (Multipart-Teile) immer Base64-kodieren (wenn die Eigenschaft Operation auf Receive Message gesetzt ist) Mögliche Werte:
|
| Nachrichten sind mit S/MIME verschlüsselt (Multipart/Encrypted) Mögliche Werte:
|
| Nachrichten sind mit S/MIME signiert (Multipart/Signed) Mögliche Werte:
|
| 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) |
| Passwort/Passphrase zur Schlüssel-/Zertifikatsdatei im PKCS#12-Format, die Sie in Parameter Pkcs12 angegeben haben Mögliche Werte: Beliebige gültige Zeichenkette |
| Port des IMAP-Servers Mögliche Werte:
|
| SSL-Verschlüsselung für die Verbindung zum IMAP-Server aktivieren Mögliche Werte:
|
| URL zu einer Properties-Datei (XML oder Text), die beliebige Java Mail Properties enthalten kann Mögliche Werte:
|
| Format der Properties-Datei, die in Parameter Mögliche Werte:
|
Statuswerte
| Die Operation wurde erfolgreich ausgeführt. |
| Die Operation wurde durchgeführt, es wurde aber kein Ergebnis gefunden oder keine Daten geändert. |
| Die Operation konnte nicht ausgeführt werden. |