====== Fehlerbehebung ======

===== Outlook ist nicht gestartet =====

**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:**

  - Starten Sie Microsoft Outlook (Classic-Version, **nicht** "New Outlook").
  - Warten Sie, bis Outlook vollständig geladen ist.
  - Klicken Sie auf "Ja" im Dialog.

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

----

===== Passwort konnte nicht entschlüsselt werden =====

**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:**

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

<WRAP round tip>
**Prävention:** Verwenden Sie **Windows-Authentifizierung** statt SQL-Auth, wenn die Mapping-Datei zwischen Benutzern geteilt werden soll (→ [[.:configuration#dpapi-passwort-verschluesselung|DPAPI-Hinweise]]).
</WRAP>

----

===== Outlook-Ordner nicht gefunden =====

**Symptom:** Fehlermeldung "Outlook-Ordner XYZ nicht gefunden."

**Lösung:**

  - Prüfen Sie, ob der Ordner im aktuellen Outlook-Profil existiert.
  - Falls nicht: Die Anwendung bietet an, den Ordner automatisch zu erstellen (mit Bestätigungsdialog).
  - 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.

----

===== Verbindung fehlgeschlagen =====

**Symptom:** "DB-Verbindung fehlgeschlagen" oder Timeout.

**Checkliste:**

  - **Servername prüfen:** Hostname/IP korrekt? Instanzname angegeben (z.B. ''SERVER\SQLEXPRESS'')?
  - **ODBC-Treiber installiert?** Öffnen Sie ''odbcad32.exe'' und prüfen Sie unter "Treiber" ob "ODBC Driver 17 for SQL Server" (oder neuer) vorhanden ist.
  - **SQL Server läuft?** Prüfen Sie den Dienst "SQL Server (MSSQLSERVER)" in ''services.msc''.
  - **Firewall:** Port 1433 (TCP) muss für SQL Server freigegeben sein. Bei benannten Instanzen auch Port 1434 (UDP) für den SQL Browser.
  - **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.

----

===== Diff-Berechnung fehlgeschlagen =====

**Symptom:** "Vergleich fehlgeschlagen. Details siehe Protokolldatei."

**Häufige Ursachen:**

  - **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.
  - **Outlook-Verbindung unterbrochen:** Starten Sie Outlook neu.
  - **Timeout bei großen Datenmengen:** Prüfen Sie die Zeilenanzahl der Wurzeltabelle im Designer.

----

===== INSERT schlägt fehl (CHECK-Constraint) =====

**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.

----

===== Geburtstag/Jahrestag zeigt 01.01.4501 =====

**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).

----

===== Grid zeigt falsche Daten bei aktiven Filtern =====

**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.

----

===== FK-Dialog erscheint nicht =====

**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:**

  - Prüfen Sie im MessageLog die Zeilen mit "FK Resolution" — dort ist protokolliert welche Relation, SourceColumn, HintValue und DisplayColumns verwendet werden.
  - Stellen Sie sicher, dass für die Parent-Tabelle mindestens ein Feld-Mapping existiert (z.B. ''CompanyName ← ParentTable.NameColumn'').
  - 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//

{{tag>outlooksync system troubleshooting fehlerbehebung support}}