E-Mail: Anhänge ermitteln

Modellierer haben verschiedene Möglichkeiten, das EPK-Element E-Mail mit Anhängen zu versehen. Die Nutzung des EPK-Elementes Dokument und der Element-Eigenschaft Anhänge werden ausführlich erläutert auf der Seite Dispatch of E-Mail Attachments.

Eine weitere Option ist die Nutzung der Funktion: Ermittlung der E-Mail Anhänge. Die Funktion ermöglicht es, die Anhänge dynamisch zu ermitteln.

Sobald die Funktion: Ermittlung der E-Mail Anhänge verwendet wird, werden die Anhänge ausschließlich darüber definiert. Das entsprechende Eingabefeld zur manuellen Konfiguration der Anhänge wird dann ignoriert.

Verwendung der Funktion: Ermittlung der E-Mail Anhänge

Wenn Sie Anhänge dynamisch ermittelt wollen, öffnen Sie in der Sidebar Editieren des E-Mail-Elements die Entwickler-Optionen:

Wählen Sie die Funktion: Ermittlung der E-Mail Anhänge aus und klicken Sie auf das Zahnrad neben der Funktion:

Es öffnet sich ein Editor, in dem Sie Ihren JavaScript Code eingeben können. Beenden Sie Ihre Eingaben mit Speichern:

Achtung: Nicht gespeicherte Eingaben gehen beim Klick auf Schließen verloren!

Aufbau der Funktion

Die Funktion, die zur Ermittlung der Anhänge aufgerufen wird, erwartet als Rückgabeparameter ein Array, das pro anzuhängender Datei ein Objekt enthält. Das Objekt muss aus einem filename und einer url bestehen. Der Anhang wird in der E-Mail mit dem filename angezeigt. Der Name kann frei gewählt werden:

Ermittlung einer pdf-Datei als Anhang

// Die Funktion liefert ein Array, das filename und url der anzuhängenden Datei enthält
 
return [{
   "filename": "meinNeuerAnhangName.pdf",
   "url": "https://meine-page.de/meinAnhang.pdf"
}];

Es ist auch möglich, Dateien zu verwenden, die in BPaaS hochgeladen wurden und dort mit URL gespeichert sind:

// Die Funktion liefert ein Array, das filename und url der anzuhängenden Datei enthält

return [{
   "filename": "meinAnhang.pdf",
   "url": "https://scheer-solutions.com/mustermann_gmbh/app/storage/mustermann/6e92-4d79"
}];