Was ein Workflow ist

Ein Workflow ist eine geordnete Liste von Schritten, die auf eine Mail angewendet wird. Auslöser: du selbst (Taste w) oder eine Regel, die eingehende Mails automatisch durch den Workflow schickt.

Die drei Schritt-Typen

Schritt	Was er tut
Anhänge speichern	Schreibt alle Anhänge in einen Zielordner — optional gefiltert, z. B. nur `.csv` oder `.pdf`
Body als Datei	Exportiert den Mailtext als Markdown, Text oder `.eml`
Skript ausführen	Startet ein eigenes Python-Skript aus deinem freigegebenen Skript-Ordner

Läuft ein Schritt schief, stoppt die Kette nicht — jeder Schritt liefert ein eigenes Ergebnis, alles landet im Ergebnis-Dialog.

Beispiel: Rechnungs-CSV automatisch verarbeiten

Workflow „Buchhaltung" anlegen mit zwei Schritten: Anhänge speichern (Filter *.csv) → Skript ausführen (import.py).
Regel anlegen: Absender-Domain musterfirma.de + Anhang-Endung .csv → Workflow ausführen.
Trockenmodus eine Woche beobachten, dann live schalten.

Ab da landet jede Rechnungs-CSV automatisch in deiner Buchhaltung — ohne dass du die Mail öffnest.

Platzhalter für Pfade und Skripte

In Zielordnern und Skript-Parametern stehen Variablen zur Verfügung:

Variable	Inhalt
`$subject`	Betreff der Mail
`$from`	Absender-Adresse
`$date`	Mail-Datum
`$attachments_dir`	Ordner mit allen Anhängen der Mail
`$csv`	Pfad zur ersten CSV-Anlage
`$body_md`	Pfad zum exportierten Body (nach einem Body-als-Datei-Schritt)
`$body_essentials`	Mailtext ohne Signatur und Zitate — direkt als Skript-Input gedacht

Ein Zielordner wie D:\Belege\$date wird so automatisch pro Mail sinnvoll benannt.

Skripte — mächtig, aber eingezäunt

Freigegebener Ordner: Skripte dürfen nur aus einem Verzeichnis stammen, das du in den Einstellungen freigibst. Nirgendwo sonst.
Parameter-Assistent: CrystalMail liest die argparse-Definition deines Python-Skripts und schlägt die passenden Parameter vor — inklusive Typen und Hilfetexten.
Rückfragen möglich: Ein Parameter kann dich beim Ausführen kurz fragen (mit sinnvoller Vorbelegung, z. B. dem Betreff).
Python-Interpreter ist frei wählbar (Standard: py unter Windows, python3 sonst).

Nach erfolgreichem Lauf archivieren

Jeder Workflow hat optional den Schalter „Danach archivieren": Hat alles geklappt, räumt CrystalMail die Mail gleich weg. Was du noch prüfen willst, bleibt liegen.

Für Fortgeschrittene: Entwürfe von außen

Andere Werkzeuge können CrystalMail auch dazu bringen, einen fertigen Entwurf im Composer zu öffnen (z. B. aus Vorlagen oder generierten Inhalten) — praktisch für eigene Automatisierungen. Details stehen in docs/import_workflows.md im Quellcode.

Mails, die Dinge für dich tun.