Symptom: Dialog „Microsoft Outlook ist nicht gestartet.“

Ursache: Die Anwendung benötigt eine laufende Outlook-Classic-Instanz. Sie startet Outlook nicht automatisch, da ein automatischer COM-Start den UI-Thread blockieren würde.

Lösung:

1. Starten Sie Microsoft Outlook (Classic-Version, nicht „New Outlook“).
2. Warten Sie, bis Outlook vollständig geladen ist.
3. Klicken Sie auf „Ja“ im Dialog.

Prüfung: Task-Manager → OUTLOOK.EXE muss als Prozess laufen.

Symptom: Dialog „Das gespeicherte Passwort konnte nicht entschlüsselt werden.“

Ursache: Die Mapping-Datei wurde auf einem anderen Computer oder von einem anderen Windows-Benutzer erstellt. DPAPI-Verschlüsselung ist user-scoped — der Schlüssel ist an das Windows-Profil gebunden.

Lösung:

1. Geben Sie das SQL-Passwort im angezeigten Dialog erneut ein.
2. Das Passwort wird automatisch mit dem DPAPI-Schlüssel des aktuellen Benutzers re-encrypted und in der Mapping-Datei gespeichert.
3. Beim nächsten Start funktioniert die automatische Entschlüsselung.

Symptom: Fehlermeldung „Outlook-Ordner XYZ nicht gefunden.“

Lösung:

1. Prüfen Sie, ob der Ordner im aktuellen Outlook-Profil existiert.
2. Falls nicht: Die Anwendung bietet an, den Ordner automatisch zu erstellen (mit Bestätigungsdialog).
3. Alternativ: Öffnen Sie den Mapping-Designer und wählen Sie einen anderen Ordner im Schritt „Quellen / Server“.

Hinweis: Der Ordnerpfad wird relativ zum Outlook-Konto gespeichert. Wenn das Konto gewechselt wurde, stimmt der Pfad nicht mehr.

Symptom: „DB-Verbindung fehlgeschlagen“ oder Timeout.

Checkliste:

1. Servername prüfen: Hostname/IP korrekt? Instanzname angegeben (z.B. SERVER\SQLEXPRESS)?
2. ODBC-Treiber installiert? Öffnen Sie odbcad32.exe und prüfen Sie unter „Treiber“ ob „ODBC Driver 17 for SQL Server“ (oder neuer) vorhanden ist.
3. SQL Server läuft? Prüfen Sie den Dienst „SQL Server (MSSQLSERVER)“ in services.msc.
4. Firewall: Port 1433 (TCP) muss für SQL Server freigegeben sein. Bei benannten Instanzen auch Port 1434 (UDP) für den SQL Browser.
5. Authentifizierung:
   • Windows-Auth: Prüfen Sie Netzwerk-Konnektivität und SQL Server-Berechtigungen.
   • SQL-Auth: Prüfen Sie Benutzername und Passwort.

Diagnose: Der ODBC-Fehlertext wird im MessageLog-Panel angezeigt.

Symptom: „Vergleich fehlgeschlagen. Details siehe Protokolldatei.“

Häufige Ursachen:

1. SQL-Fehler im generierten SELECT: Öffnen Sie den Mapping-Designer, gehen Sie zum SQL-Test-Schritt und führen Sie die Test-Abfrage aus. Kopieren Sie das SQL in SSMS für detaillierte Fehleranalyse.
2. Outlook-Verbindung unterbrochen: Starten Sie Outlook neu.
3. Timeout bei großen Datenmengen: Prüfen Sie die Zeilenanzahl der Wurzeltabelle im Designer.

Symptom: SQL-Fehler mit „SSMA_CC$…$disallow_zero_length“ im MessageLog.

Ursache: SSMA-migrierte Datenbanken (von Access zu SQL Server) haben CHECK-Constraints die leere Strings ablehnen.

Lösung: Die Anwendung setzt leere Parameter automatisch als NULL statt als leere Strings. Wenn das Problem trotzdem auftritt, prüfen Sie ob die betroffene Spalte NOT NULL ohne Default-Wert ist.

Symptom: Phantom-Diffs bei Kontakten ohne Geburtstag/Jahrestag.

Ursache: Outlook speichert „nicht gesetzt“ als Sentinel-Datum im Jahr 4501.

Lösung: Die Anwendung filtert dieses Sentinel-Datum automatisch und gibt stattdessen einen leeren String zurück. Wenn das Problem trotzdem auftritt, prüfen Sie die OutlookSync-Version (Fix ab Build 26.02.15).

Symptom: Nach Filtern zeigt das Grid Daten aus anderen Zeilen an.

Ursache: Älterer Bug in der Index-Zuordnung zwischen gefilterter und physischer Recordliste.

Lösung: Aktualisieren Sie auf die neueste Version. Der Bug wurde durch MapToPhysicalIndex in der MemoryDataSet-Komponente behoben.

Symptom: INSERT schlägt still fehl, kein FK-Resolver-Dialog sichtbar.

Ursache: Wenn DisplayColumns für die Parent-Tabelle nicht im Mapping vorhanden sind, konnte der Dialog in älteren Versionen nicht angezeigt werden.

Lösung:

1. Prüfen Sie im MessageLog die Zeilen mit „FK Resolution“ — dort ist protokolliert welche Relation, SourceColumn, HintValue und DisplayColumns verwendet werden.
2. Stellen Sie sicher, dass für die Parent-Tabelle mindestens ein Feld-Mapping existiert (z.B. CompanyName ← ParentTable.NameColumn).
3. Aktualisieren Sie auf die neueste Version — der Fallback auf SELECT * FROM ParentTable wurde als Fix hinzugefügt.

Wolfgang van der Stille @ EMSR DATA d.o.o. — Outlook Sync