Querladen von Office-Add-Ins zum Testen von einer Netzwerkfreigabe
Sie können ein Office-Add-In in einem Office-Client unter Windows testen, indem Sie das Manifest auf einer Netzwerkdateifreigabe veröffentlichen (anweisungen folgen). Diese Bereitstellungsoption soll verwendet werden, wenn Sie die Entwicklung und Tests auf einem localhost abgeschlossen haben und das Add-In von einem nicht lokalen Server oder Cloudkonto aus testen möchten.
Wichtig
Die Bereitstellung per Netzwerkfreigabe wird für Produktions-Add-Ins nicht unterstützt. Diese Methode weist die folgenden Einschränkungen auf.
- Das Add-In kann nur auf Windows-Computern installiert werden.
- Add-Ins, die das einheitliche Manifest für Microsoft 365 verwenden, werden nicht unterstützt, wenn sie in einer Netzwerkfreigabe veröffentlicht werden.
- Wenn eine neue Version eines Add-Ins das Menüband ändert, z. B. durch Hinzufügen einer benutzerdefinierten Registerkarte oder einer benutzerdefinierten Schaltfläche, muss jeder Benutzer das Add-In neu installieren.
Hinweis
Wenn das Add-In-Projekt mit einer hinreichend neueren Version des Yeoman-Generators für Office Add-Ins erstellt wurde, wird das Add-In automatisch im Office Desktop-Client quergeladen, wenn Sie npm start
ausführen.
Dieser Artikel gilt nur für das Testen von Word-, Excel-, PowerPoint- und Project-Add-Ins und nur unter Windows. Wenn Sie auf einer anderen Plattform testen oder ein Outlook-Add-In testen möchten, lesen Sie eines der folgenden Themen zum Querladen Ihres Add-Ins.
- Office-Add-Ins in Office Online für Tests querladen
- Querladen von Office-Add-Ins unter Mac zu Testzwecken
- Querladen von Office-Add-Ins auf dem iPad zum Testen
- Querladen von Outlook-Add-Ins zu Testzwecken
Das folgende Video führt Sie durch den Prozess des Querladens von Add-Ins auf Office-Desktop oder in Office Online mithilfe eines Katalogs mit freigegebenen Ordnern.
Freigeben eines Ordners
Wechseln Sie auf dem Windows-Computer, auf dem Sie das Add-in hosten möchten, zum übergeordneten Ordner oder zum Laufwerkbuchstaben des Ordners, den Sie als die, den Sie als freigegebenen Ordnerkatalog verwenden möchten.
Öffnen Sie das Kontextmenü für den Ordner, den Sie als Freigegebenen Ordnerkatalog verwenden möchten (klicken Sie z. B. mit der rechten Maustaste auf den Ordner), und wählen Sie Eigenschaften aus.
Öffnen Sie im Dialogfeld Eigenschaften die Registerkarte Freigabe, und wählen Sie dann die Schaltfläche Freigeben.
Fügen Sie im Dialogfeld Netzwerkzugriff sich selbst und alle anderen Benutzer und/oder Gruppen hinzu, mit denen Sie das Add-In teilen möchten. Sie benötigen mindestens lese-/schreibberechtigung für den Ordner. Nachdem Sie die Auswahl von Personen für die Freigabe abgeschlossen haben, wählen Sie die Schaltfläche Freigeben aus.
Wenn die Bestätigung Ihr Ordner ist freigegeben angezeigt wird , notieren Sie sich den vollständigen Netzwerkpfad, der unmittelbar nach dem Ordnernamen angezeigt wird. (Sie müssen diesen Wert als Katalog-URL eingeben, wenn Sie den freigegebenen Ordner als vertrauenswürdigen Katalog angeben, wie im nächsten Abschnitt dieses Artikels beschrieben.) Klicken Sie auf die Schaltfläche Fertig , um das Dialogfeld Netzwerkzugriff zu schließen.
Wählen Sie die Schaltfläche OK aus, um das Dialogfeld Eigenschaften zu schließen.
Geben Sie den freigegebenen Ordner als vertrauenswürdigen Katalog an.
Es gibt zwei Optionen für die Angabe dieser Vertrauensstellung. Befolgen Sie die Anweisungen für die Option, die für Ihr Setup besser funktioniert.
- Konfigurieren Sie die Vertrauensstellung manuell.
- Konfigurieren Sie die Vertrauensstellung mit einem Registrierungsskript.
Manuelles Konfigurieren der Vertrauensstellung
Öffnen Sie ein neues Dokument in Excel, Word, PowerPoint oder Project.
Klicken Sie auf die Registerkarte Datei und dann auf Optionen.
Wählen Sie Sicherheitscenter aus, und wählen Sie dann die Schaltfläche Einstellungen für das Sicherheitscenter aus.
Wählen Sie Vertrauenswürdige Add-In-Kataloge.
Geben Sie im Feld Katalog-URL den vollständigen Netzwerkpfad zu dem Ordner ein, den Sie zuvor freigegeben haben. Wenn Sie bei der Freigabe des Ordners den vollständigen Netzwerkpfad des Ordners nicht notiert haben, können Sie ihn über das Eigenschaften-Dialogfeld des Ordners wie im folgenden Screenshot gezeigt abrufen.
Nach der Eingabe des vollständigen Netzwerkpfads des Ordners in das Feld Katalog-URL wählen Sie die Katalog hinzufügen-Schaltfläche.
Wählen Sie das Kontrollkästchen Im Menü anzeigen für das neu hinzugefügte Element, und wählen Sie dann die OK-Schaltfläche zum Schließen des Sicherheitscenter-Dialogfelds.
Klicken Sie auf die Schaltfläche OK , um das Dialogfeld Optionen zu schließen.
Schließen Sie die Office-Anwendung und öffnen Sie sie erneut, damit die Änderungen wirksam werden.
Konfigurieren der Vertrauensstellung mit einem Registrierungsskript
Erstellen Sie in einem Text-Editor eine Datei mit dem Namen TrustNetworkShareCatalog.reg.
Fügen Sie der Datei den folgenden Inhalt hinzu.
Windows Registry Editor Version 5.00 [HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\WEF\TrustedCatalogs\{-random-GUID-here-}] "Id"="{-random-GUID-here-}" "Url"="\\\\-share-\\-folder-" "Flags"=dword:00000001
Verwenden Sie eines der zahlreichen Onlinetools für die GUID-Erstellung, z. B. GUID-Generator, um eine Zufalls-GUID zu generieren, und ersetzen Sie in der Datei "TrustNetworkShareCatalog.reg" die Zeichenfolge "-random-GUID-here-"-an beiden Stellen durch die GUID. (Die einschließenden
{}
-Symbole sollten beibehalten werden.)Ersetzen Sie den
Url
-Wert durch den vollständigen Netzwerkpfad zu dem Ordner, den Sie zuvor freigegeben haben. (Beachten Sie, dass alle\
-Zeichen in der URL verdoppelt werden müssen.) Wenn Sie bei der Freigabe des Ordners den vollständigen Netzwerkpfad des Ordners nicht notiert haben, können Sie ihn über das Eigenschaften-Dialogfeld des Ordners wie im folgenden Screenshot gezeigt abrufen.Die gesamte Datei sollte jetzt wie folgt aussehen. Speichern Sie sie.
Windows Registry Editor Version 5.00 [HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\WEF\TrustedCatalogs\{01234567-89ab-cedf-0123-456789abcedf}] "Id"="{01234567-89ab-cedf-0123-456789abcedf}" "Url"="\\\\TestServer\\OfficeAddinManifests" "Flags"=dword:00000001
Schließen Sie alle Office-Anwendungen.
Führen Sie die Datei "TrustNetworkShareCatalog.reg" genauso wie jede ausführbare Datei aus, z. B. durch Doppelklicken.
Querladen des Add-Ins
Speichern Sie die XML-Manifestdatei eines beliebigen Add-Ins, das Sie testen, in den Katalog des freigegebenen Ordners. Beachten Sie, dass Sie die Webanwendung selbst auf einem Webserver bereitstellen. Achten Sie darauf, die URL im <SourceLocation-Element> der Manifestdatei anzugeben.
Wichtig
Die Verwendung eines HTTPS-Endpunkts für Ihr Add-In ist zwar nicht in allen Add-In-Szenarien streng erforderlich, wird aber unbedingt empfohlen. Add-Ins, die nicht SSL-gesichert (HTTPS) sind, generieren Warnungen zu unsicheren Inhalten und Fehlern während der Verwendung. Wenn Sie planen, Ihr Add-In in Office im Web auszuführen oder ihr Add-In in AppSource zu veröffentlichen, muss es SSL-gesichert sein. Wenn Ihr Add-In auf externe Daten und Dienste zugreift, sollte es SSL-gesichert sein, damit die Daten bei der Übertragung geschützt sind. Selbstsignierte Zertifikate können für die Entwicklung und für Tests verwendet werden, sofern das Zertifikat auf dem lokalen Computer als vertrauenswürdig festgelegt ist.
Hinweis
Verwenden Sie für Visual Studio-Projekte das vom Projekt im
{projectfolder}\bin\Debug\OfficeAppManifests
Ordner erstellte Manifest.Wählen Sie in Excel, Word oder PowerPoint im MenübandStart-Add-Ins> und dann Weitere Add-Ins aus. Wählen Sie in Project auf der Registerkarte Projekt des Menübands die Option Meine Add-Ins aus.
Wählen Sie im Dialogfeld Office-Add-Ins oben die Option Freigegebener Ordner aus.
Wählen Sie den Namen des Add-Ins aus, und klicken Sie auf Hinzufügen, um das Add-In einzufügen.
Entfernen eines quergeladenen Add-Ins
Sie können ein zuvor quergeladenes Add-In entfernen, indem Sie den Office-Cache auf Ihrem Computer löschen. Ausführliche Informationen zum Löschen des Caches unter Windows finden Sie im Artikel Löschen des Office-Caches.
Weitere Artikel
Office Add-ins