# Lokales Testen des Produktions-Add-Ins (Sideloading)

Wenn der lokale Entwicklungs-Server (`npm start`) nicht läuft, kann das Produktions-Add-In (welches auf dem Live-Server gehostet wird) nicht einfach in der Excel Desktop-App über das Microsoft Admin-Center "hochgeladen" werden.
Um die Produktions-Version (`manifest.prod.xml`) dauerhaft lokal in Excel zu installieren, nutzt man unter Windows einen **freigegebenen Netzwerkordner (Shared Folder)**.

Folge dieser Schritt-für-Schritt-Anleitung, um dein lokales Excel für das Produktions-Add-In einzurichten:

## 1. Vorbereitung des Produktions-Manifests

1. Stelle sicher, dass du eine tagesaktuelle Version der `manifest.prod.xml` hast. Du kannst diese unter anderem **direkt aus dem entwickelten Add-In herunterladen**, wenn du es lokal laufen hast (Link unten im Add-In: *Prod-Manifest (.xml)*).
2. Diese Datei enthält die echten Produktions-URLs statt der `localhost`-Adressen.

*(Optional: Wenn du Dev- und Prod-Add-In gleichzeitig in Excel nutzen möchtest, stelle sicher, dass die `<Id>` in der `manifest.prod.xml` von der ID in der normalen `manifest.xml` abweicht.)*

## 2. Einen lokalen Ordner freigeben (Shared Folder)

Excel Desktop benötigt zwingend einen Netzwerkpfad (Share), um Manifeste lokal zu finden.

1. Erstelle irgendwo auf deinem PC einen neuen Ordner, z. B. `C:\ExcelManifests`.
2. Lege deine heruntergeladene `manifest.prod.xml` in diesen Ordner.
3. Klicke im Windows Explorer mit der **rechten Maustaste** auf den Ordner -> **Eigenschaften**.
4. Gehe zum Reiter **Freigabe** und klicke auf **Erweiterte Freigabe...**.
5. Setze den Haken bei **Diesen Ordner freigeben**. Merke dir den Freigabenamen (meist der Ordnername, z.B. `ExcelManifests`).
6. Klicke auf **OK** und schließe die Eigenschaften. Du solltest nun den Netzwerkpfad sehen (z. B. `\\DeinPCName\ExcelManifests` oder `\\localhost\ExcelManifests`).

## 3. Den Ordner in Excel als "Trusted Catalog" hinzufügen

Damit Excel diesen freigegebenen Ordner nach Manifesten durchsucht:

1. Öffne ein beliebiges lokales **Excel**.
2. Gehe auf **Datei** -> **Optionen** -> **Trust Center** (bzw. Sicherheitscenter).
3. Klicke auf den Button **Einstellungen für das Trust Center...**.
4. Wähle im linken Menü **Vertrauenswürdige Add-In-Kataloge** aus.
5. Trage unten bei **Katalog-URL** den Netzwerkpfad aus Schritt 2 ein (z. B. `\\localhost\ExcelManifests`).
6. Klicke auf **Katalog hinzufügen**.
7. **WICHTIG:** Setze den Haken bei **Im Menü anzeigen** (Show in Menu) für diesen neuen Eintrag!
8. Klicke auf **OK** und **starte Excel komplett neu**.

## 4. Das Produktions-Add-in in Excel laden

Nach dem Neustart von Excel:

1. Gehe im Menüband auf den Reiter **Einfügen** -> **Add-Ins abrufen** (Get Add-ins).
2. Oben im erscheinenden Dialogfenster siehst du nun einen neuen Reiter namens **FREIGEGEBENER ORDNER** (Shared Folder).
3. Klicke darauf. Dort taucht nun dein Produktions-Add-in auf.
4. Klicke auf **Hinzufügen**.

**Das war's!** 
Ab sofort kannst du dein Produktions-Add-in ganz normal über das Menü starten, auch wenn dein lokaler Entwicklungs-Server aus ist.

### Updates des Add-Ins
Da die Excel Desktop-App bei jedem Start des Add-Ins die aktuellsten React/Web-Dateien von deinem Server lädt, musst du diesen Prozess **nicht** bei jedem Update wiederholen. 

Du musst die `manifest.prod.xml` im Ordner `C:\ExcelManifests` nur dann aktualisieren (überschreiben) und das Add-In neu in Excel laden, wenn sich grundlegende Metadaten im Manifest ändern (wie z. B. der Name des Add-Ins, die URL, Icons oder angeforderte Berechtigungen).