Skip to main content

Stapelklassen Email-Konfiguration

Je Stapelklasse ist es möglich 1-n Emailkonten zu konfigurieren, um Emails automatisiert aus den konfigurierten Postfächern abzurufen und die angehängten Dokumente (derzeit nur PDFs) zu verarbeiten.

Es werden zwei Verfahren unterstützt, um Emails aus den Postfächern abzuholen.

  1. Abruf via EWS (Exchange Web Services)
  2. Abruf via IMAP (Internet Message Access Protocol)

EWS ist bei aktivierter Microsoft Exchange Server extended protection nicht mehr verwendbar. In diesem Fall muss auf IMAP umgestellt werden. 

EWS BasicAuth

Die BasicAuth für die Exchange Web Services wird im Oktober 2022 abgeschaltet. Aktuell ist jedoch nur diese zur Nutzung freigegeben. Um zu prüfen, ob die BasicAuth für ein System noch verfügbar ist, kann die folgende URL (ggf. Server durch den eigenen Exchange Server ersetzen) genutzt werden:

https://outlook.office365.com/EWS/Exchange.asmx

Nach dem Aufruf dieser URL erscheint ein Dialog zur Eingabe des Benutzernamens und des Passworts.
Sofern diese Anmeldung erfolgreich ist und eine entsprechende Webseite angezeigt wird, ist BasicAuth verfügbar.

EWS Verbindungstest

Im Falle einer EWS Verbindung kann es hilfreich sein vorab einen Verbindungstest durchzuführen. Das gilt besonders dann, wenn es sich um einen eignen Exchange Server handelt. Der Verbindungstest kann mit der folgenden Seite durchgeführt werden:

https://testconnectivity.microsoft.com/tests/EwsTask/input

Auf der Seite müssen die Verbindungsdaten angegeben werden, die getestet werden sollen:

image-1617708831461.png

Sofern ein AutoDiscover für den Exchange Server eingerichtet wurde kann die Option (1) genutzt werden.
Sollte es sich um einen eignen Exchange Server handeln für den kein AutoDiscover eingerichtet ist, dann muss die EWS Adresse manuell angegeben werden (2)

Auflistung der Konten

Eine Liste der konfigurierten Konten kann über Reiter Emailkonten der Stapelklasse geöffnet werden.

image-1584355051783.png

In dieser Bildschirmkopie ist zu sehen, dass zwei Konten definiert sind, die abgerufen werden sollen.
In der Spalte Protokoll kann das Verfahren für den Import festgelegt werden (EWS, IMAP oder Deaktiviert). 

Über das image-1584355769142.png Symbol in der unteren Leiste können weitere Konten definiert werden.
Über das image-1584355927440.png

Neues Konto definieren

image-1584355644545.png

 

Shared Mailboxes abfragen

Um mit einem Benutzer Zugriff auf ein Postfach zu erhalten, um damit Emails einer anderen shared mailbox abzurufen im Feld "Benutzer" zuerst den Zugriffsbenutzer eintragen und danach den shared mailbox Benutzer getrennt durch "/":

Beispiel: benutzername@domain.de/shared-benutzername@domain.de

Beispiel mit NTLM Anmeldung: local.domain.net\benutzername/mailbox@domain.de

 

Hinweis: Bei Verwendung von EWS müssen der "Valid" & "Error" Ordner auf oberster Ebene sein. Unterordner von z.B. "Posteingang" können nicht verwendet werden. 

 

Task einrichten

Damit die Emails automatisiert abgeholt werden, muss ein Task eingerichtet werden.
Hier der Link zur Einrichtung des Jobs: Email-Verarbeitung

 

Übertragen von Standard Email Feldern

Sofern beim Email Import Standard Email Felder wie Absender, Empfänger, Email Betreff ausgelesen werden sollen müssen die entsprechenden folgenden Felder technisch an jeder Dokumenten Klasse vorhanden sein:

  • EmailReceivedDate
  • EmailFromAddress
  • EmailFromName
  • EmailToAddress
  • EmailCcAddress
  • EmailSubject
  • EmailMessageId
  • EmailImportFolder
  • EmailProcessedFolder
  • EmailInvalidFolder
  • EmailMailBoxUser
  • EmailPriority