99 Fehlersuche und häufige Fragen
99.1 Übersicht ¶
Dieses Kapitel sammelt typische Fragen und typische Stolperfallen im Umgang mit dem Programm. Die Antworten sind Kurzfassungen - ausführliche Beschreibungen finden Sie in den jeweils referenzierten Kapiteln.
99.2 E-Mails werden nicht erkannt ¶
Symptom: Ein Profil verarbeitet keine Mails, obwohl Mails dem Filter entsprechen sollten.
Mögliche Ursachen:
- Profil ist deaktiviert - kontrollieren Sie das Aktiv-Häkchen in der Profilliste
- Filter ist zu restriktiv - testen Sie ihn im Ergebnisvorschau-Tab des Profil-Editors mit Beispiel-Nachrichten
- Überwachte Ordner sind falsch - der Ordner-Pfad muss exakt zum Server passen (siehe Kapitel 50.6)
- Mails sind älter als der Erst-Lauf des Programms - neue Mails ab dem ersten Programm-Start werden erkannt; ältere brauchen die Nachholverarbeitung (siehe Kapitel 60.2)
Schritt-für-Schritt-Diagnose: Im Verarbeitungs-Log unter Tab Kein Treffer sehen Sie, ob die Mail überhaupt gesehen wurde. Wenn ja: Filter prüfen. Wenn nein: Ordner-Konfiguration und Konto-Verbindung prüfen.
99.3 IDLE liefert keine Echtzeit-Benachrichtigung ¶
Symptom: Mails werden mit Verzögerung von Minuten erkannt statt sekundenschnell.
Mögliche Ursachen:
- IDLE ist im Konto deaktiviert (siehe Kapitel 50.5)
- Firewall schließt lange offene Verbindungen - typische Verdächtige: Unternehmens-Firewalls mit kurzem Timeout
- Server unterstützt kein IDLE - manche Hoster haben es deaktiviert (selten)
Lösung: Bei aggressiven Firewalls IDLE im Konto-Editor deaktivieren - das Prüf-Intervall übernimmt die Erkennung. Bei sehr kritischen Latenz-Anforderungen das Prüf-Intervall (siehe Kapitel 40.7) verkürzen.
99.4 „Kategorie setzen” funktioniert nicht ¶
Symptom: Die Aufgabe Kategorie setzen wird im Log als „übersprungen” angezeigt.
Grund: Kategorien sind ein Microsoft-365-/Exchange-Feature. IMAP- und POP3-Konten kennen keine Kategorien.
Lösung: Bei IMAP-Konten verwenden Sie stattdessen die Aufgabe Markierung setzen (Flags wie Wichtig, Privat, Beruflich). Bei POP3-Konten gibt es keine Entsprechung.
99.5 Pfad ist zu lang - Datei kann nicht gespeichert werden ¶
Symptom: Beim Speichern von Anhängen erscheint ein Fehler „Pfad zu lang”.
Grund: Windows hat ein Pfadlimit von 260 Zeichen (MAX_PATH). Bei tief verschachtelten Strukturen mit Platzhaltern wie <SenderName> - <Subject> - <EmailYear4>-<EmailMonth>-<EmailDay> wird das Limit schnell überschritten.
Lösungen:
- Pfad-Komponenten kürzen - Teilstring-Platzhalter wie
<SubjectPartL{0,40}> verwenden (siehe Kapitel 70.1.5)
- Ordnertiefe reduzieren - z.B.
<EmailYear4>\<EmailMonth> statt <EmailYear4>\<EmailMonth>\<EmailDay>\<SenderName>
- Ziel-Ordner umlegen - von
C:\Users\Username\Documents\AEP-Archiv\ auf D:\AEP\ (Wurzelpfade sparen Zeichen)
99.6 Demo-Modus zeigt nur 2 Profile ¶
Symptom: Nach der Installation lassen sich nicht mehr als 2 Profile aktivieren.
Grund: Im Demo-Modus ist die Anzahl aktiver Profile auf 2 beschränkt (siehe Kapitel 60.6).
Lösung: Lizenz erwerben und über Hauptmenü → Lizenzschlüssel eingeben… einspielen.
99.7 Service-Modus läuft, aber verarbeitet nichts ¶
Symptom: Der Windows-Dienst startet, aber im Log erscheinen keine neuen Einträge.
Häufigste Ursache: Der Dienst läuft unter „Lokales System”. Lokales System hat keinen Zugriff auf:
- Microsoft-365-OAuth-Tokens (sind benutzergebunden)
- Im Windows Credential Manager abgelegte Passwörter (sind benutzergebunden)
- Netzwerk-Drucker (sind benutzergebunden)
Lösung: Dienst auf einen dedizierten Service-Account umstellen (siehe Kapitel 60.3.3). Im Service-Account-Kontext einmal interaktiv anmelden und Konten konfigurieren.
99.8 Profil-Migration auf neuen PC: Konten funktionieren nicht mehr ¶
Symptom: Nach Backup-Wiederherstellung auf einem neuen PC scheitern Microsoft-365-Konten und/oder Konten mit Credential-Manager-Speicherung an der Anmeldung.
Grund: Microsoft-365-Refresh-Tokens sind an LocalAppData des alten Benutzers gebunden und werden bewusst nicht mit übertragen. Im Modus Windows Credential Manager liegen Passwörter im Tresor des alten Windows-Benutzers - der neue Benutzer hat darauf keinen Zugriff. Im Standard-Modus (verschlüsselt in der Profildatei) sind Passwörter portabel und funktionieren ohne Nacharbeit.
Lösung: Pro Microsoft-365-Konto einmal die OAuth-Anmeldung neu durchführen. Bei Credential-Manager-gespeicherten Passwörtern: einmalig neu eingeben. Die übrige Konfiguration (Filter, Aufgaben, Pfade) wandert problemlos mit (siehe Kapitel 60.4).
99.9 Mails werden doppelt verarbeitet ¶
Symptom: Eine Mail erscheint zwei oder mehr Mal im Verarbeitungs-Log.
Mögliche Ursachen:
- Mehrere Profile verarbeiten dieselbe Mail - eines davon ist gewollt, ein anderes nicht
- Nachholen-Lauf wurde manuell ausgelöst, ohne „Bereits erfolgreich verarbeitete ignorieren” zu aktivieren
Lösung:
- Mehrere Profile: prüfen Sie im Verarbeitungs-Log, mit welchen Profilen die Nachricht verarbeitet wurde, und kontrollieren Sie die Filter-Überlappung. Typischer Fall ist ein zu breiter Standard-Filter neben einem speziellen Filter. Im Nachholen-Dialog die Skip-Option aktivieren.
- Mehrfach-Speicherung: bei der Aufgabe Anhänge speichern schalten Sie Datei nicht überschreiben ein - so werden bestehende Dateien nicht durch erneute Verarbeitung überschrieben.
99.10 Verzögerte Verarbeitung wirkt nicht sofort ¶
Frage: Eine verzögerte Verarbeitung mit 30 Sekunden Wartezeit löst erst nach mehreren Minuten aus.
Grund: Das Programm prüft die wartenden Mails nur in Prüf-Zyklen - wenn das Prüf-Intervall 1 Minute ist, wird die 30-Sekunden-Wartezeit erst beim nächsten Prüf-Lauf bemerkt.
Lösung: Prüf-Intervall auf 30 Sekunden verkürzen, oder die Verzögerung an das Prüf-Intervall anpassen (z.B. mindestens 2 Minuten Verzögerung statt 30 Sekunden).
99.11 Wo ist das Programm-AppData-Verzeichnis? ¶
Anwendungs-Modus: %APPDATA%\AutomaticEmailProcessor\
Service-Modus: AppData des Service-Accounts, typisch C:\Users\<service-user>\AppData\Roaming\AutomaticEmailProcessor\ oder bei dedizierten Service-Konten unter C:\Windows\System32\config\systemprofile\AppData\Roaming\ (bei Lokales System - nicht empfohlen).
Im AppData liegen alle Konfigurationen: Profiles.json, Options.json, EmailAccounts.json, Logs, Token-Caches.
99.12 Weitere Hilfe ¶
Bei Fragen, die hier nicht beantwortet sind:
- Hauptmenü → Hilfe öffnet die ausführliche Programmhilfe
- Schritt-für-Schritt-Anleitungen in der Online-Hilfe decken typische Workflows ab (Erste Schritte, Anhänge speichern, Microsoft 365 einrichten, Profile importieren)
- Bug-Reports und Feature-Wünsche an den Hersteller (Kontaktdaten siehe Hauptmenü → Über…)
- Über Hauptmenü → Weiteres → Fehlerbericht erzeugen… lässt sich ein gebündelter Fehler-Bericht für Support-Anfragen erzeugen - er enthält Logs, System- und Versions-Informationen
- Das Fehler-Log (siehe Kapitel 80.2) enthält bei systemischen Problemen die für eine Diagnose nötigen Stack-Traces