EWS Download Action

Die EWS Download Action lädt EML-Dateien aus On-Premise oder O365 Postfächern herunter. Dabei können die E-Mails mit sogenannten Tags versehen werden (Default ECMObjectID), die es der Routine ermöglichen bei erneutem Lauf durch das Postfach bereits migrierte EML-Dateien auszuschließen. Zudem ist hier bei Übertragung der ECMObjectIDs (GUIDs) eine 1:1 Verbindung zwischen ELO und dem E-Mail System möglich. Das Herunterladen erfolgt in das Verzeichnis des (Import-)Jobs. In der Folge können die Dateien durch den XML-Importer wieder in das Archiv migriert werden.

• EWS-URL: als Default wird hier die O365 URL verwendet. Bei On-Premise Installationen ist hier der EWS-Pfad des OnPremise Servers anzugeben
  • Beispiel: https://computer.domain.contoso.com/EWS/Exchange.asmx).
  • Ein Auto-Discover findet hier nicht statt. https://learn.microsoft.com/de-de/exchange/client-developer/exchange-web-services/how-to-set-the-ews-service-url-by-using-the-ews-managed-api
  • Sofern es bei der Verbindung zu SSL-Trust-Fehlern kommt, muss hier das Zertifikat des Exchange Servers in die Java VM mitaufgenommen werden
  • Bei Fehlern mit Benutzern / Passwörtern bei OnPremise-Exchange Servern ist es empfehlenswert den Benutzernamen in unterschiedlichen Formen zu probieren
    • DOMÄNE\Benutzername (CONTOSO\mark.mueller)
    • UPN (mark.mueller@contoso.com)
    • Benutzername (mark.mueller)
  • Bei OnPremise als auch bei O365 Installationen benötigt der Benutzer dem entsprechende Rechte in der Exchange-Organisation (Postfach verwalten/ggf. SendAs)
• Username/Password: Benutzername und Passwort. Bei O365 Authentifikationsflows ist es im Normalfall nicht mehr möglich mittels dieser Form der Authentifizierung zu arbeiten. Sie benötigen hier eine registrierte Applikation im Azure Portal. Der Benutzername wird in diesem Fall als „Anchor-Mailbox“ angegeben. Also jener Benutzer in dessen Kontext alle Operationen statt finden.
• Search-Folder: Einstiegs-Ordner für die Verarbeitung. Will man bspw. eine ganze Mailbox durcharbeiten empfiehlt sich hier die Einstellung MsgFolderRoot.
• Move-Folder: Verschiebe-Ordner im Outlook Postfach. Bspw. soll der Ordner Inbox/Invoice durchsucht werden und die E-Mails sollen unter „Inbox/Invoice/done“ abgelegt werden, dann ist hier einfach nur der Wert „done“ einzutragen.

Microsoft hat ja vor Jahren schon angekündigt (2017 oder 2018), den EWS Standard nicht mehr weiterentwickeln zu wollen. Dies wurde zum Großteil auch eingehalten, teilweise erhielten die EWS Assemblies auf .NET Ebene aber immer wieder Refreshes. Anfang September 2023 gab es aber jetzt das vorläufige Aus für die O365 Dienste.

Link zu Borns IT Blog

Die gute Nachricht ist, dass es mittlerweile einen internen Prototypen für Microsoft Graph 5 gibt, der die EWS Aktion ablösen kann.