Automatisierter Belegversand für DEVONthink aktualisiert

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