diff --git a/Automatisierter-Belegversand-f%C3%BCr-DEVONthink.md b/Automatisierter-Belegversand-f%C3%BCr-DEVONthink.md index 9b63c95..19d1f06 100644 --- a/Automatisierter-Belegversand-f%C3%BCr-DEVONthink.md +++ b/Automatisierter-Belegversand-f%C3%BCr-DEVONthink.md @@ -84,30 +84,34 @@ Nach der ersten Ausführung erstellt das System automatisch folgende Struktur in _config/ -├── belegversand.conf # Konfigurationsdatei -├── mail_vorlagen/ # Mail-Templates -│ └── belegversand # Standard-Template -├── README-Belegversand # Interne Hilfe -└── [weitere Dateien nach Versand] +|── belegversand.conf # Konfigurationsdatei +| +|── mail_vorlagen/ # Mail-Templates + +| └── belegversand # Standard-Template + +|── README-Belegversand # Interne Hilfe + +|── [weitere Dateien nach Versand] Die Konfigurationsdatei `belegversand.conf` befindet sich in DEVONthink unter `_config → belegversand.conf`. #### Wichtigste Parameter -; MAIL_TO_DEFAULT: Standard-Empfänger (z.B. steuer@example.com) -; MAIL_CC_TO_DEFAULT: Standard-CC-Empfänger (optional) -; MAIL_SUBJECT_PREFIX: Präfix für den Mail-Betreff (z.B. "Belegversand") -; ZIP_PASSWORD_DEFAULT: Standard-Passwort für ZIP-Archive (optional, keine Sonderzeichen) -; LOG_SENT_GROUP_NAME: Name der Ordnergruppe für Versandprotokolle (Standard: "Versendet") -; SENT_TAG_FOR_DOCS: Tag für versendete Belege (Standard: "gesendet") -; WRITE_DEBUG_LOG: Debug-Logging aktivieren (true/false) -; SHOW_README: Willkommensdialog beim Start anzeigen (true/false) -; MAILBODY_FOLDER_NAME: Ordner für Mail-Templates (Standard: "mail_vorlagen") -; MAILBODY_RECORD_NAME: Name des Standard-Templates (Standard: "belegversand") -; PATH_TO_DRYRUN_PREVIEW: Speicherort der Dry-Run Vorschau-Datei +- MAIL_TO_DEFAULT: Standard-Empfänger (z.B. steuer@example.com) +- MAIL_CC_TO_DEFAULT: Standard-CC-Empfänger (optional) +- MAIL_SUBJECT_PREFIX: Präfix für den Mail-Betreff (z.B. "Belegversand") +- ZIP_PASSWORD_DEFAULT: Standard-Passwort für ZIP-Archive (optional, keine Sonderzeichen) +- LOG_SENT_GROUP_NAME: Name der Ordnergruppe für Versandprotokolle (Standard: "Versendet") +- SENT_TAG_FOR_DOCS: Tag für versendete Belege (Standard: "gesendet") +- WRITE_DEBUG_LOG: Debug-Logging aktivieren (true/false) +- SHOW_README: Willkommensdialog beim Start anzeigen (true/false) +- MAILBODY_FOLDER_NAME: Ordner für Mail-Templates (Standard: "mail_vorlagen") +- MAILBODY_RECORD_NAME: Name des Standard-Templates (Standard: "belegversand") +- PATH_TO_DRYRUN_PREVIEW: Speicherort der Dry-Run Vorschau-Datei -==== Multiple Empfänger (CSV-Format) ==== +### Multiple Empfänger (CSV-Format) Mehrere E-Mail-Adressen können durch Kommas getrennt werden: @@ -118,28 +122,28 @@ MAIL_CC_TO_DEFAULT=cc1@example.com, cc2@example.com Die Adressen werden automatisch geparst und in Apple Mail einzeln eingefügt. -== Verwendung == +## Verwendung -=== Grundablauf === +### Grundablauf -# Belege in DEVONthink auswählen (Mehrfachauswahl möglich) -# Scripts → START aufrufen -# Dialog beantwortet (Empfänger, ZIP-Passwort, Dry-Run?) -# Dry-Run Vorschau anschauen (optional) -# Echtlauf → ZIP-Archive erstellt, Mail-Draft geöffnet, Logging durchgeführt +- Belege in DEVONthink auswählen (Mehrfachauswahl möglich) +- Scripts → START aufrufen +- Dialog beantwortet (Empfänger, ZIP-Passwort, Dry-Run?) +- Dry-Run Vorschau anschauen (optional) + -Echtlauf → ZIP-Archive erstellt, Mail-Draft geöffnet, Logging durchgeführt -=== Menü-Befehle === +### Menü-Befehle -; START: Haupteinstiegspunkt — startet Setup oder Versand -; About...: About-Dialog mit Versionsinformation und Links +- START: Haupteinstiegspunkt — startet Setup oder Versand +- About...: About-Dialog mit Versionsinformation und Links -=== Booking-Jahr Enforcement === +### Booking-Jahr Enforcement Das System verhindert Versandvermischung über mehrere Jahre: -; Mixed-Year Selection: Werden Belege aus verschiedenen Jahren auswählt, wird ein Fehler zurückgewiesen -; Separate Protokolle: Jedes Buchungsjahr hat eigene Versendet-Ordner mit separaten Logs -; Outsider-Belege: Dokumente außerhalb der Jahresstruktur werden separat gehandhabt +- Mixed-Year Selection: Werden Belege aus verschiedenen Jahren auswählt, wird ein Fehler zurückgewiesen +- Separate Protokolle: Jedes Buchungsjahr hat eigene Versendet-Ordner mit separaten Logs +- Outsider-Belege: Dokumente außerhalb der Jahresstruktur werden separat gehandhabt Beispiel-Struktur: @@ -157,7 +161,7 @@ Belege/ └── [← Separate Outsider-Logs] -=== Dry-Run Modus === +### Dry-Run Modus Vor jedem echten Versand kann ein Dry-Run durchgeführt werden: