diff --git a/Automatisierter-Belegversand-f%C3%BCr-DEVONthink.md b/Automatisierter-Belegversand-f%C3%BCr-DEVONthink.md index e335bda..06b3004 100644 --- a/Automatisierter-Belegversand-f%C3%BCr-DEVONthink.md +++ b/Automatisierter-Belegversand-f%C3%BCr-DEVONthink.md @@ -80,12 +80,7 @@ Falls nach dem Clone noch `.applescript`-Dateien vorhanden sind, war `compile.sh ### Automatische Initialisierung -Nach der ersten Ausführung erstellt das System in der aktuellen DEVONthink-Datenbank unter... - -_config/ - -...die Steuerverzeichnisse. - +Nach der ersten Ausführung erstellt das System in der aktuellen DEVONthink-Datenbank unter `_config` die Steuerverzeichnisse. Die Konfigurationsdatei `belegversand.conf` befindet sich in DEVONthink unter `_config → belegversand.conf`. #### Wichtigste Parameter @@ -105,12 +100,8 @@ Die Konfigurationsdatei `belegversand.conf` befindet sich in DEVONthink unter `_ ### Multiple Empfänger (CSV-Format) Mehrere E-Mail-Adressen können durch Kommas getrennt werden: - - -MAIL_TO_DEFAULT=recipient1@example.com, recipient2@example.com -MAIL_CC_TO_DEFAULT=cc1@example.com, cc2@example.com - - +- MAIL_TO_DEFAULT=recipient1@example.com, recipient2@example.com +- MAIL_CC_TO_DEFAULT=cc1@example.com, cc2@example.com Die Adressen werden automatisch geparst und in Apple Mail einzeln eingefügt. ## Verwendung @@ -136,140 +127,85 @@ Das System verhindert Versandvermischung über mehrere Jahre: - Separate Protokolle: Jedes Buchungsjahr hat eigene Versendet-Ordner mit separaten Logs - Outsider-Belege: Dokumente außerhalb der Jahresstruktur werden separat gehandhabt -Beispiel-Struktur: - - -Belege/ -├── 2026/ -│ ├── 01_Januar/ -│ ├── [weitere Monate] -│ └── Versendet/ [← Logs für 2026-Versand] -├── 2027/ -│ ├── 01_Januar/ -│ ├── [weitere Monate] -│ └── Versendet/ [← Logs für 2027-Versand] -└── Provisionsabrechnungen/ - └── [← Separate Outsider-Logs] - - ### Dry-Run Modus Vor jedem echten Versand kann ein Dry-Run durchgeführt werden: -# Simuliert den kompletten Versandprozess -# Erstellt Vorschau-Datei mit allen Details -# Zeigt Dialog mit Zusammenfassung -# User kann bestätigen oder abbrechen +- Simuliert den kompletten Versandprozess +- Erstellt Vorschau-Datei mit allen Details +- Zeigt Dialog mit Zusammenfassung +- User kann bestätigen oder abbrechen Die Vorschau-Datei wird auf der lokalen Festplatte gespeichert (Pfad konfigurierbar). -=== Mail-Drafts === +### Mail-Drafts Das System erstellt keinen automatischen Versand, sondern Mail-Drafts: -# ZIP-Archive werden erzeugt -# Apple Mail öffnet mit neuem Draft (nicht gesendet!) -# User kann Template prüfen, weitere Empfänger hinzufügen -# Benutzerdefinierter Versand per Knopfdruck in Mail +- ZIP-Archive werden erzeugt +- Apple Mail öffnet mit neuem Draft (nicht gesendet!) +- User kann Template prüfen, weitere Empfänger hinzufügen +- Benutzerdefinierter Versand per Knopfdruck in Mail Dies ermöglicht volle Kontrolle über den Versand. -=== Mail-Templates === +### Mail-Templates +Seit Version 1.4 unterstützt der Belegversand beliebig viele Mail-Templates. Templates werden aus DEVONthink geladen (`_config/mail_vorlagen/`). Das System zeigt einen Dialog zur Template-Auswahl, wenn mehrere Vorlagen vorhanden sind. -Beispiel-Template: +## Protokollierung - -Sehr geehrte/r Frau/Herr, +Die Versende-Vorgänge werden zweifach protokolliert. +- Maschinell lesbar im *.JSON-Lines Format für technische Weiterverarbeitung: +- Menschlich lesbar, im *.MD-Format, mit Übersichten nach Versandlauf: -beiliegend erhalten Sie die angeforderten Unterlagen. +## Troubleshooting -Mit freundlichen Grüßen - +### Scripts funktionieren nicht -== Protokollierung == - -=== NDJSON-Logs === - -Maschinell lesbar im JSON-Lines Format für technische Weiterverarbeitung: - - -{"timestamp":"2026-01-15T10:30:45Z","type":"record","record_uuid":"abc123","record_name":"Invoice-001","status":"sent"} -{"timestamp":"2026-01-15T10:30:46Z","type":"email","to":"recipient@example.com","zip_file":"archive.zip","status":"created"} -{"timestamp":"2026-01-15T10:30:47Z","type":"tag","record_uuid":"abc123","tag":"gesendet","status":"applied"} - - -=== Markdown-Logs === - -Menschlich lesbar mit Übersichten nach Versandlauf: - - -# Belegversand Logs — 2026 - -## Versandlauf 2026-01-15 10:30 -**Versendete Belege:** 5 Stück -**Empfänger:** recipient@example.com -**ZIP-Datei:** belegversand_2026-01-15_103045.zip -**Passwort:** [konfiguriert] -**Status:** Erfolgreich - -### Versandte Dokumente -- Invoice-001 (UUID: abc123...) -- Invoice-002 (UUID: def456...) -... - - -== Troubleshooting == - -=== Scripts funktionieren nicht === - -==== Problem: "Script nicht gefunden" ==== +#### Problem: "Script nicht gefunden" Häufigste Ursache: `compile.sh` wurde nicht ausgeführt. -Lösung: -# Prüfen ob `.scpt`-Dateien vorhanden sind: ls ~/Library/Application\ Scripts/com.devon-technologies.think/Menu/Belegversand/Helpers/scripts/ -# Falls nur `.applescript`-Dateien vorhanden → ./compile.sh erneut ausführen -# Auf Fehlermeldungen achten +#### Lösung: +- Prüfen ob `.scpt`-Dateien vorhanden sind: ls ~/Library/Application\ Scripts/com.devon-technologies.think/Menu/Belegversand/Helpers/scripts/ +- Falls nur `.applescript`-Dateien vorhanden → ./compile.sh erneut ausführen +- Auf Fehlermeldungen achten -==== Problem: Script-Zugriff verweigert ==== +### Problem: Script-Zugriff verweigert -Lösung: -# System Settings → Privacy & Security → Automation -# DEVONthink sollte mit entsprechenden Rechten gelistet sein -# Script Editor öffnen und START.scpt öffnen -# Compile (⌘K) — sollte ohne Fehler durchlaufen +#### Lösung: +- System Settings → Privacy & Security → Automation +- DEVONthink sollte mit entsprechenden Rechten gelistet sein +- Script Editor öffnen und START.scpt öffnen +- Compile (⌘K) — sollte ohne Fehler durchlaufen -=== ZIP wird nicht erstellt === +### ZIP wird nicht erstellt -* ZIP-Passwort in Config überprüfen (keine Sonderzeichen!) -* Ausreichend Festplatte vorhanden? -* Staging-Ordner in DEVONthink beschreibbar? + -ZIP-Passwort in Config überprüfen (###Keine### Sonderzeichen, keine Leerzeichen!) +- Ausreichend Festplatte vorhanden? +- Staging-Ordner in DEVONthink beschreibbar? -=== Mail-Draft öffnet sich nicht === +### Mail-Draft öffnet sich nicht -* Apple Mail ist geöffnet? -* Script-Zugriff für Mail aktiviert? -* Mail-Templates-Ordner vorhanden? +- Apple Mail ist geöffnet? +- Script-Zugriff für Mail aktiviert? +- Mail-Templates-Ordner vorhanden? -=== "Mixed-Year-Selection"-Fehler === +### "Mixed-Year-Selection"-Fehler Dies ist kein Fehler, sondern Schutz vor Versandvermischung: -; Lösung 1: Nur Belege aus einem Buchungsjahr auswählen -; Lösung 2: Belege in mehreren Versänden verteilen +- Lösung 1: Nur Belege aus einem Buchungsjahr auswählen +- Lösung 2: Belege in mehreren Versänden verteilen -=== Debug-Informationen aktivieren === +### Debug-Informationen aktivieren In `belegversand.conf`: - - WRITE_DEBUG_LOG=true - - Debug-Logs erscheinen dann in `/tmp/DT-Belegversand-debug.log`. == Versionshistorie == @@ -280,25 +216,25 @@ Debug-Logs erscheinen dann in `/tmp/DT-Belegversand-debug.log`. ; 1.1: Konfigurationssystem ; 1.0: Erste funktionale Version -== Entwicklung == +## Entwicklung Quellcode liegt als `.applescript`-Dateien vor (lesbar, git-freundlich). Zur lokalen Entwicklung: -# Quelldateien (`.applescript`) editieren -# `./compile.sh` ausführen -# In DEVONthink testen -# Bei Änderungen: `./compile.sh` erneut ausführen +- Quelldateien (`.applescript`) editieren +- `./compile.sh` ausführen +- In DEVONthink testen +- Bei Änderungen: `./compile.sh` erneut ausführen -== Support == +## Support Für technische Fragen oder Probleme: * Wiki-Dokumentation durchlesen (diese Seite) * Debug-Log aktivieren und analysieren * Im Gitea-Repository ein Issue erstellen (falls Zugriff vorhanden) -== Externe Links == +## Externe Links -* [https://gitea.tuxi.ddnss.de/enchiriadis/DEVONthink-Belegversand-Automatisation Repository] (privat, erfordert Zugriff) -* [https://www.devontechnologies.com DEVONthink Homepage] -* [https://support.apple.com/mail Apple Mail Documentation] +- [https://gitea.tuxi.ddnss.de/enchiriadis/DEVONthink-Belegversand-Automatisation Repository] (privat, erfordert Zugriff) +- [https://www.devontechnologies.com DEVONthink Homepage] +- [https://support.apple.com/mail Apple Mail Documentation]