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 drei 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
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. Wenn der zu einrichtende Dienst nur noch OAuth2.0 mit Verbindung zur Microsoft 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 OAuth2.0 Authentication Flow möglich, die Anmeldung durch einen Benutzernamen und Password wird dadurch obsolet. Im Oktober 2022 wird der BasicAuth-Flow von EWS endgültigt abgeschaltet. Squeeze unterstützt explizit nur den Client_Credentials Flow.

Um nun den Zugriff weiterhin zu gewährleisten kann man ab der Version 2.x.x ein neues Email-Konto/Protokoll(Microsoft Graph API) wählen.

Wie man nun bemerkt, sind die auszufüllenden Felder Benutzername, Passwort, und die Ordner(Posteingang, Fehler, Verarbeitet). für den Benutzernamen muss folgendes Schema dringend eingehalten werden:

 Schema für den Benutzernamen: maxMustermann@mustermann.de/{client_id}/{tenant_id} 
 Das Passwort muss dem {client_secret}  entsprechen.

Weitere notwendige Schritte für ein reibungslosen Ablauf sind die Einrichtung einer Azure-Active-Directory Application
mit einem Client Secret. Die Globale Registrierung eines Mail-Dienstes der "Dexpro"  im Azure-Active-Directory  des Kunden, wird vorerst nicht angeboten.

Zudem muss darauf geachtet werden dass die Application folgende Scopes besitzt. 

Verbindung Testen

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