Release Version 2.5.0

Embedded Mailer for enaio®
1

Wir freuen uns, euch die Version 2.5.0 vom Embedded Mailer freigeben zu dürfen. Das neue Major Release bringt einige Änderungen so wie auch Features mit sich. Zusätzlich wurden neue Konfigurationspunkte eingeführt mit denen bestehende Funktionen auf der Benutzeroberfläche, so wie auch neue Funktionen, besser steuerbar sind

Neu: Ablage von Anhängen im Ansicht Tab in enaio

image
image1610×1092 72.3 KB

image
image1610×1092 97.4 KB

In der neuen Version archivieren Sie E-Mail-Anhänge mit nur einem Klick direkt aus dem Ansicht-Tab in enaio

Server-Implementierung

Serverseitig sind hierfür zwei neue EmptyJobs zu implementieren:

  • getAttachmentStorageOptions: Liefert dem Nutzer die verfügbaren Ablageoptionen basierend auf Standort und Dateityp

  • storeAttachment: Führt die eigentliche Archivierung des Anhangs durch

Neu: Mail Versand mit Graph-API

Ab sofort ist es möglich E-Mails über die Microsoft Graph-API zu versenden. Details zur Konfiguration finden sich am Ende des Beitrags (ebenfalls zur Migration von früheren Versionen auf die 2.5.0)

Neu: Optionaler Bestätigungsdialog beim Versenden von Mails

Serverseitig ermöglicht der neue EmptyJob confirmationRequired die Anzeige eines Bestätigungsdialogs vor dem E-Mail-Versand. Dadurch lässt sich beispielsweise verhindern, dass wichtige Dokumente versehentlich versendet werden. Mit dem Job ist es möglich alle Informationen des Mailformulars sowie die Anhänge auszuwerten und anschließend zurückzugeben ob ein Bestätigungsdialog angezeigt werden soll. Standardmäßig ist diese Prüfung deaktiviert

image
image1535×940 143 KB

Neu: Optionaler Job isMailerAllowed

Serverseitig ist es möglich mit dem neuen EmptyJob isMailerAllowed für Nutzergruppen den Mailer zu deaktivieren, wenn der Mailer deaktiviert ist, ist es nur möglich Mails bzw. Dokumente im Ansicht Tab zu sichten

Verbesserung: Konfigurierbarkeit von Funktionen auf der Benutzeroberfläche

Mit der 2.5.0 sind auf der Benutzeroberfläche neue als auch bereits existente Funktionen steuerbar geworden in der Konfiguration

  • allowAttachmentDownload (boolean): Steuert ob im Ansicht Tab Anhänge von E-Mails herunterladbar sind
  • allowAttachmentStore (boolean): Steuert ob im Ansicht Tab E-Mails abgelegt werden dürfen
  • initialTab („VIEWER“ oder „SEND“): Steuert den Standardtab mit dem sich der Embedded Mailer öffnet
  • hideSendStoreButton: Steuert ob auf Benutzeroberfläche der Senden & Ablegen Knopf angezeigt wird (z. B. wenn das Ablegen von Mails nicht erwünscht ist)
  • hideSendButton: Steuert ob auf Benutzeroberfläche der Senden Knopf angezeigt wird (z. B. wenn nur das Senden von Mails
  • confirmationCheckEnabled: Steuert ob die Prüfung mit dem Bestätigungsdialog aktiv ist (confirmationRequired EmptyJob)

Verbesserung: EML Parser

Mit der neuen Version ist es nötig die neue Version des EML Parsers zu installieren. Die neue Version stellt komplexere E-Mails deutlich besser dar und ist ebenfalls deutlich leichter zu installieren. Das Setup wurde angepasst, so dass es ohne Internet auskommt, alles nötige ist bereits im Archiv enthalten. Das neue Setup installiert den EML Parser Dienst automatisch mit reduzierten Dateisystemrechten und ohne Internetzugriff, somit ist die Sicherheit verbessert für alle neuen Installationen

Migration

Mit dem wechsel auf die 2.5.0 gibt es bezüglich der Konfiguration Breaking Changes

Konfiguration Dokumentation

mailing:
  server: # <---------------------------- Zuvor "backend"
    licenseKey: "ENCRYPTED-KEY"
    mailParserUrl: http://localhost:8000
    emptyJobCacheExpiryMins: 10
    delivery: # <------------------------ Verbindung zum Mail Server neu hier eingegliedert 
      provider: SMTP # <----------------- Hier sind die Werte "GRAPH_API bzw. "SMTP" möglich
      smtp: # <-------------------------- Je nach "provider" zu definieren
        host: my.smtp.host
        port: 25
        enable-ssl: false
        enable-start-tls: false
        auth:
          enable: true
          email: yourmail@smtp.host
          password: yourpassword
          encryptedPassword: false
        debug: false
      graph-api: # <--------------
        client-id: "CLIENT_ID"
        client-secret: "CLIENT_SECRET"
        tenant-id: "TENANT_ID"
        main-resource: "yourmail@smtp.host"

  client: # <---------------------------- Zuvor "frontend"
    allowNewContacts: false
    allowAttachmentDownload: true
    allowAttachmentStore: false
    initialTab: "VIEWER"
    hideSendStoreButton: false
    hideSendButton: false
    confirmationCheckEnabled: false

Zusätzlich ist es nötig die neue Version vom EMLParser zu installieren, wie der neue Parser installiert wird, ist in der Dokumentation nachzulesen

hierfür ist der Alte Dienst zuvor mit sc delete "ServiceName" zu entfernen (Bitte im Services.msc die genau Service-ID vom EML-Parser aufsuchen)

2 Likes