35 lines
1.7 KiB
Markdown
35 lines
1.7 KiB
Markdown
|
# `email` — E-Mail versenden
|
||
|
|
|
||
|
|
**Zweck:** Versendet eine E-Mail (ohne Benutzerinteraktion) mit Betreff, Text und optionalen Anhängen. Der Versand erfolgt über den Mail-Spooler des Systems; Empfänger, Betreff, Text und Anhänge unterstützen Platzhalter. Im Testmodus (`test_modus_mail` gesetzt) wird der Empfänger umgeleitet und CC/BCC unterdrückt.
|
||
|
|
|
||
|
|
**Parameter**
|
||
|
|
|
||
|
|
| Name | Pflicht? | Default | Beschreibung |
|
||
|
|
|---|---|---|---|
|
||
|
|
| `an` | **ja** | — | Empfängeradresse(n) |
|
||
|
|
| `titel` | **ja** | — | Betreff |
|
||
|
|
| `text` | **ja** | — | Mailtext (HTML erlaubt, CDATA empfohlen) |
|
||
|
|
| `cc` | nein | — | CC-Empfänger, kommagetrennt |
|
||
|
|
| `bcc` | nein | — | BCC-Empfänger, kommagetrennt |
|
||
|
|
| `attachments/file` | nein | — | Ein `<file>`-Element je Anhang (Pfad); optionales Attribut `name="…"` setzt einen sprechenden Anzeigenamen (ebenfalls mit Platzhaltern), sonst wird der Dateiname des Pfads verwendet |
|
||
|
|
|
||
|
|
**Eingangswerte:** Beliebige Kontextvariablen in allen Feldern. Zwei Komfort-Anreicherungen (nur für das Rendern dieser Mail):
|
||
|
|
- Jede Variable mit Suffix `_json`, die gültiges JSON enthält, steht zusätzlich ohne Suffix als Liste zur Verfügung — nutzbar als Template-Section: `{{#mkz_auswahl}}<li>{{mkz}} — {{name}}</li>{{/mkz_auswahl}}`
|
||
|
|
- Ist `{{vkz}}` gesetzt, werden `{{tg_name}}` und `{{tg_kurzname}}` automatisch nachgeschlagen, sofern noch nicht vorhanden.
|
||
|
|
|
||
|
|
**Ausgangswerte:** keine.
|
||
|
|
|
||
|
|
```xml
|
||
|
|
<task type="email" id="info_mail">
|
||
|
|
<config>
|
||
|
|
<an>{{gewaehlte_person_mail}}</an>
|
||
|
|
<cc>info@example.org</cc>
|
||
|
|
<titel>Neuer Vorgang {{WORKFLOW_ID}}</titel>
|
||
|
|
<text><![CDATA[Sehr geehrte Damen und Herren, ...]]></text>
|
||
|
|
<attachments>
|
||
|
|
<file name="Antrag_{{vkz}}.pdf">{{latest_pdf_path}}</file>
|
||
|
|
</attachments>
|
||
|
|
</config>
|
||
|
|
</task>
|
||
|
|
```
|