Mail Service

Funktionsbeschreibung

Es wurde ein Service Task programmiert, der E-Mails über einen SMTP-Server versenden kann.

Dieser kann im Studio an jeder beliebigen Stelle definiert werden.

Der Service Task benötigt die Custom Property engine.setServiceTaskType mit dem Wert MailService.

Zusätzlich zu den statischen Umgebungsvariablen müssen die folgenden dynamischen Parameter im PreScript definiert werden:

Empfänger recipient
Empfänger cc (optional) recipientCc
Betreff subject
E-Mail-Text mailtext

Für den Versand von E-Mails wurde das externe Modul "nodemailer": "^6.9.3" angebunden.

Neben reinen Textnachrichten können auch HTML-Nachrichten versendet werden.

Hierzu muss der Parameter mailtext mit dem Tag <!DOCTYPE html> beginnen.

Zusätzlich kann durch die Konfiguration von Parametern eine automatische Signatur erstellt und angehängt werden.

Konfiguration

Die weiter unten aufgeführten ersten 4 Umgebungsvariablen müssen beim Start des Engine-Containers übergeben werden.

Die restlichen Variablen sind optional und dienen, neben der Anpassung der Konfiguration des E-Mail-Versands, zur Konfiguration einer Standardsignatur.

Letzteres benötigt mindestens einen der unten genannten Signaturparameter.

Environment Variablen


  environment:
  - mailServiceExtension__host=smtp.office365.com
  - mailServiceExtension__sender=5Minds ProcessCube Notification <Muster.Mustermann@muster.de>
  - mailServiceExtension__authUser=null
  - mailServiceExtension__authPass=null
  #- mailServiceExtension__port=587
  #- mailServiceExtension__authType=login
  - mailServiceExtension__signatureTitle=5Minds ProcessCube Notification
  - mailServiceExtension__signatureNote=Bitte antworten Sie nicht auf diese E-Mail!
  - mailServiceExtension__signatureContactPerson=Muster Mustermann, Musterposition
  - mailServiceExtension__signatureContactEmail=Muster.Mustermann@muster.de

Abhängigkeiten

Die Studio-Erweiterung custom_service_tasks enthält für diese Erweiterung ein zusätzliches Formular zur erleichterten Eingabe der benötigten Parameter.