Email-Import-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 zweidrei 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)Protocol
3. Abruf via Microsoft Graph API(Graph API mit OAuth2.0)

EWS BasicAuth

Die BasicAuth für die Exchange Web Services wird im Oktober 2022 abgeschaltet. AktuellWenn istder jedochzu einrichtende Dienst nur diesenoch OAuth2.0 mit Verbindung zur NutzungMicrosoft freigegeben.Graph API unterstütz dann siehe Abschnitt Besonderheit Microsoft Graph API. 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

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). 

Neues Konto definieren

Über Importe -> E-Mail gelangen Sie zur Übersicht der Email-Konten. Über das Feld Stapelklasse kann die Stapelklasse ausgewählt werden für die ein neues Email-Konto eingerichtet werden soll. Über "+ Neuer Eintrag kann nun ein neues Konto angelegt werden.

Shared Mailboxes abfragen

Besonderheit EWS

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. 

Besonderheit Microsoft Graph API

Der Zugriff auf ein Email-Postfach ist nur noch über einen Access-Token möglich, die Anmeldung durch einen Benutzernamen und Password wird dadurch obsolet. Im Oktober 2022 wird der BasicAuth-Flow von EWS endgültigt abgeschaltet. 

Um nun den Zugriff weiterhin zu gewährleisten kann man ab der Version 2.x.x ein neuen Email-Konto Typen wählen.

Ü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: