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>
_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]
</source>
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]
</source>
=== Dry-Run Modus ===
### Dry-Run Modus
Vor jedem echten Versand kann ein Dry-Run durchgeführt werden: