Mail Service
Die Mail Service Extension ermoeglicht den Versand von E-Mails ueber SMTP direkt aus BPMN-Prozessen.
Funktionsweise
Ein Service Task mit dem Typ MailService sendet eine E-Mail ueber den konfigurierten SMTP-Server. Die E-Mail-Parameter (Empfaenger, Betreff, Text) werden im PreScript des Service Tasks definiert.
Der Service Task benoetigt die Custom Property engine.setServiceTaskType mit dem Wert MailService.
BPMN-Konfiguration
Im PreScript des Service Tasks muessen folgende Parameter gesetzt werden:
| Parameter | Beschreibung | Pflicht |
|---|---|---|
recipient | E-Mail-Empfaenger | Ja |
recipientCc | CC-Empfaenger | Nein |
subject | Betreff | Ja |
mailtext | E-Mail-Text (Plain Text oder HTML) | Ja |
Beispiel PreScript
token.current.recipient = token.history.UserTask_1.email;
token.current.subject = 'Ihre Bestellung ' + token.history.UserTask_1.orderId;
token.current.mailtext = 'Vielen Dank fuer Ihre Bestellung.';HTML-E-Mails
Fuer HTML-Nachrichten muss mailtext mit <!DOCTYPE html> beginnen:
token.current.recipient = 'user@example.com';
token.current.subject = 'Statusbericht';
token.current.mailtext = '<!DOCTYPE html><html><body><h1>Bericht</h1><p>Details...</p></body></html>';Konfiguration
Die SMTP-Verbindung wird ueber Umgebungsvariablen konfiguriert:
Pflicht-Variablen
| Variable | Beschreibung | Beispiel |
|---|---|---|
mailServiceExtension__host | SMTP-Server | smtp.office365.com |
mailServiceExtension__sender | Absender-Adresse | ProcessCube® <noreply@example.com> |
mailServiceExtension__authUser | SMTP-Benutzername | user@example.com |
mailServiceExtension__authPass | SMTP-Passwort | geheim |
Optionale Variablen
| Variable | Beschreibung | Standard |
|---|---|---|
mailServiceExtension__port | SMTP-Port | 587 |
mailServiceExtension__authType | Authentifizierungstyp | login |
Signatur-Variablen (optional)
Eine automatische Signatur wird angehaengt, wenn mindestens eine der folgenden Variablen gesetzt ist:
| Variable | Beschreibung |
|---|---|
mailServiceExtension__signatureTitle | Titel der Signatur |
mailServiceExtension__signatureNote | Hinweistext |
mailServiceExtension__signatureContactPerson | Kontaktperson |
mailServiceExtension__signatureContactEmail | Kontakt-E-Mail |
Docker Compose Beispiel
services:
engine:
image: marketplace.processcube.io/processcube-io/processcube_engine
environment:
- mailServiceExtension__host=smtp.office365.com
- mailServiceExtension__sender=ProcessCube® <noreply@example.com>
- mailServiceExtension__authUser=user@example.com
- mailServiceExtension__authPass=geheim
- mailServiceExtension__signatureTitle=ProcessCube® Notification
- mailServiceExtension__signatureNote=Bitte antworten Sie nicht auf diese E-Mail!Die Studio-Erweiterung custom_service_tasks enthaelt fuer diese Extension ein zusaetzliches Formular zur erleichterten Eingabe der Parameter.