diff --git a/README.md b/README.md index 478d5b5..53a6f11 100644 --- a/README.md +++ b/README.md @@ -40,6 +40,7 @@ Alle ausführlichen Leitfäden und Dokumentationen findest du im Ordner [`/docs` 2. **[Entwickler-Setup](./docs/02_Entwicklung_Setup.md)**: Wie setze ich das Projekt lokal auf und entwickle weiter? 3. **[Benutzerhandbuch](./docs/03_Benutzerhandbuch.md)**: Die Schritt-für-Schritt Anleitung für die Endnutzer. 4. **[Deployment & Hosting](./docs/04_Deployment.md)**: Wie kommt das Tool auf den Ubuntu-Server und in das M365 Admin Center? +5. **[Lokales Prod-Add-In (Sideloading)](./docs/05_Lokales_Prod_Sideloading.md)**: Wie lade ich das Produktions-Add-in in meiner lokalen Excel-App, wenn der Dev-Server nicht läuft? --- diff --git a/docs/05_Lokales_Prod_Sideloading.md b/docs/05_Lokales_Prod_Sideloading.md new file mode 100644 index 0000000..4da2ef6 --- /dev/null +++ b/docs/05_Lokales_Prod_Sideloading.md @@ -0,0 +1,54 @@ +# 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 `` 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). diff --git a/docs/README.md b/docs/README.md new file mode 100644 index 0000000..9ac0d11 Binary files /dev/null and b/docs/README.md differ diff --git a/webpack.config.js b/webpack.config.js index b393f61..42b1bae 100644 --- a/webpack.config.js +++ b/webpack.config.js @@ -72,6 +72,11 @@ module.exports = async (env, options) => { from: "assets/*", to: "assets/[name][ext][query]", }, + { + from: "docs/*", + to: "docs/[name][ext][query]", + noErrorOnMissing: true, + }, { from: "manifest*.xml", to: "[name]" + "[ext]",