Go to file

duffyduck 84ba78a1c5 Rewrite as standalone C# WinForms app Replace the Office Web Add-in with a native Windows application. The web add-in required Exchange/M365 for registration which is not available in all customer environments (standalone Office, POP/IMAP only). The new app: - Uses COM Interop to access Outlook contacts directly - Communicates with Starface REST API (accepts self-signed certs) - Runs as System Tray app with optional auto-sync - Profile-based config stored in %AppData% - No webserver, no certificates, no Exchange, no M365 needed - Inno Setup installer for clean MSI-style deployment - Works with any Outlook version (Classic and New) Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>		2026-04-03 10:26:58 +02:00
installer	Rewrite as standalone C# WinForms app	2026-04-03 10:26:58 +02:00
src/StarfaceOutlookSync	Rewrite as standalone C# WinForms app	2026-04-03 10:26:58 +02:00
.gitignore	Update .gitignore for C# standalone app	2026-04-03 10:26:39 +02:00
README.md	Rewrite as standalone C# WinForms app	2026-04-03 10:26:58 +02:00
StarfaceOutlookSync.sln	Rewrite as standalone C# WinForms app	2026-04-03 10:26:58 +02:00

README.md

Starface Kontakt-Sync

Windows-Anwendung zur bidirektionalen Synchronisation von Kontakten zwischen Microsoft Outlook und einer Starface Telefonanlage.

Funktionen

Bidirektionale Synchronisation von Kontakten zwischen Outlook und Starface
Profil-System zum Verwalten mehrerer Sync-Konfigurationen (verschiedene Adressbuecher oder Anlagen)
Starface-Adressbuecher: Zentrales Adressbuch, persoenliches Adressbuch und Tag-basierte Adressbuecher
Outlook-Kontaktordner: Frei waehlbarer Kontaktordner als Sync-Ziel
Sync-Richtung konfigurierbar: Outlook -> Starface, Starface -> Outlook oder bidirektional
Intelligentes Matching: Kontakte werden anhand von E-Mail-Adresse oder Name abgeglichen
Aenderungserkennung: Nur geaenderte Kontakte werden uebertragen (Hash-basiert)
Auto-Sync: Optionaler automatischer Sync in konfigurierbarem Intervall
System Tray: Laeuft im Hintergrund, Schnell-Sync per Rechtsklick
Kompatibel mit Outlook Classic und dem neuen Outlook
Komplett lokal: Kein Exchange, kein Microsoft 365, kein Cloud-Konto erforderlich

Voraussetzungen

Windows 10/11
.NET Framework 4.8 (in Windows 10/11 bereits enthalten)
Microsoft Outlook (Classic oder Neu, beliebige Version)
Starface Telefonanlage ab Version 6.7 (REST-API)

Installation beim Kunden

Setup ausfuehren

StarfaceOutlookSync_Setup_0.0.0.1.exe ausfuehren
Installationsoptionen waehlen:
- Desktop-Verknuepfung erstellen (optional)
- Bei Windows-Anmeldung automatisch starten (empfohlen)
Fertig - die App startet automatisch

Nach der Installation

App starten (Tray-Icon oder Desktop-Verknuepfung)
"Neues Profil" klicken
Starface-Verbindungsdaten eingeben (Host, Login-ID, Kennwort)
"Verbindung testen" und "Adressbuecher laden"
Starface-Adressbuch und Outlook-Kontaktordner waehlen
Speichern und "Jetzt synchronisieren"

Deinstallation

Ueber Windows Einstellungen -> Apps oder die Systemsteuerung. Benutzerdaten (Profile, Mappings) werden mit entfernt.

Entwicklung

Bauen

# In Visual Studio oeffnen und bauen, oder:
dotnet build src/StarfaceOutlookSync/StarfaceOutlookSync.csproj -c Release

Installer erstellen

Inno Setup 6 installieren
Release-Build erstellen
installer/setup.iss in Inno Setup oeffnen und kompilieren
Setup-EXE wird in dist/ erstellt

Projektstruktur

outlook-sync/
├<><E2949C>─ StarfaceOutlookSync.sln          # Visual Studio Solution
├── installer/
│   └── setup.iss                     # Inno Setup Script
└── src/StarfaceOutlookSync/
    ├── StarfaceOutlookSync.csproj    # Projektdatei
    ├── Program.cs                    # Entry Point (Single Instance)
    ├── Models/
    │   ├── UnifiedContact.cs         # Kontakt-Datenmodell
    │   └── SyncProfile.cs           # Profile, Mappings, Ergebnisse
    ├── Services/
    │   ├── StarfaceApiClient.cs      # Starface REST-API Client
    │   ├── OutlookContactsService.cs # Outlook COM Interop
    │   ├── ProfileManager.cs         # Profilverwaltung (AppData)
    │   └── SyncEngine.cs            # Bidirektionale Sync-Logik
    └── UI/
        ├── MainForm.cs              # Hauptfenster + System Tray
        ├── ProfileEditorForm.cs     # Profil anlegen/bearbeiten
        ├── SyncProgressForm.cs      # Sync-Fortschritt mit Log
        └── AboutForm.cs             # Info-Dialog

Synchronisierte Kontaktfelder

Feld	Outlook (COM)	Starface (REST)
Vorname	FirstName	NAME
Nachname	LastName	SURNAME
Firma	CompanyName	COMPANY
Position	JobTitle	JOB_TITLE
E-Mail	Email1Address	EMAIL
Telefon (Buero)	BusinessTelephoneNumber	OFFICE_PHONE_NUMBER
Mobiltelefon	MobileTelephoneNumber	MOBILE_PHONE_NUMBER
Telefon (Privat)	HomeTelephoneNumber	PRIVATE_PHONE_NUMBER
Fax	BusinessFaxNumber	FAX_NUMBER
Strasse	BusinessAddressStreet	STREET
Stadt	BusinessAddressCity	CITY
PLZ	BusinessAddressPostalCode	POSTAL_CODE
Bundesland	BusinessAddressState	STATE
Land	BusinessAddressCountry	COUNTRY
Webseite	WebPage	URL
Notizen	Body	NOTE
Anrede	Title	SALUTATION
Geburtstag	Birthday	BIRTHDAY

Technische Details

Architektur

Die Anwendung ist eine native Windows-App (WinForms, .NET Framework 4.8). Sie greift direkt per COM Interop auf Outlook-Kontakte zu und kommuniziert per REST-API mit der Starface. Kein Webserver, kein Browser, kein Exchange erforderlich.

StarfaceOutlookSync.exe
  ├── COM Interop -> Outlook Kontakte (lokal)
  ├── REST-API    -> Starface Telefonanlage (HTTPS)
  └── Dateisystem -> Profile & Mappings (%AppData%)

Datenspeicherung

Alle Daten werden lokal pro Benutzer gespeichert:

%AppData%\StarfaceOutlookSync\profiles.json - Sync-Profile mit Zugangsdaten
%AppData%\StarfaceOutlookSync\mappings\ - Kontakt-Zuordnungen pro Profil

SSL-Zertifikate

Self-signed Zertifikate der Starface werden automatisch akzeptiert. Es ist kein manueller Zertifikat-Import erforderlich.

Lizenz

HackerSoft - Hacker-Net Telekommunikation Stefan Hacker Am Wunderburgpark 5b 26135 Oldenburg

README.md Unescape Escape