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