Querladen von Office-Add-Ins zum Testen von einer Netzwerkfreigabe

  • Artikel

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.
  • 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 bezieht sich nur auf 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.

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

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

  2. Ö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.

  3. Öffnen Sie im Dialogfeld Eigenschaften die Registerkarte Freigabe, und wählen Sie dann die Schaltfläche Freigeben.

    Dialogfeld

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

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

    Dialogfeld

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

Manuelles Konfigurieren der Vertrauensstellung

  1. Öffnen Sie ein neues Dokument in Excel, Word, PowerPoint oder Project.

  2. Klicken Sie auf die Registerkarte Datei und dann auf Optionen.

  3. Wählen Sie Sicherheitscenter aus, und wählen Sie dann die Schaltfläche Einstellungen für das Sicherheitscenter aus.

  4. Wählen Sie Vertrauenswürdige Add-In-Kataloge.

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

    Dialogfeld

  6. Nach der Eingabe des vollständigen Netzwerkpfads des Ordners in das Feld Katalog-URL wählen Sie die Katalog hinzufügen-Schaltfläche.

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

    Dialogfeld

  8. Klicken Sie auf die Schaltfläche OK , um das Dialogfeld Optionen zu schließen.

  9. Schließen Sie die Office-Anwendung und öffnen Sie sie erneut, damit die Änderungen wirksam werden.

Konfigurieren der Vertrauensstellung mit einem Registrierungsskript

  1. Erstellen Sie in einem Text-Editor eine Datei mit dem Namen TrustNetworkShareCatalog.reg.

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

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

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

    Dialogfeld

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

  6. Schließen Sie alle Office-Anwendungen.

  7. Führen Sie die Datei "TrustNetworkShareCatalog.reg" genauso wie jede ausführbare Datei aus, z. B. durch Doppelklicken.

Querladen des Add-Ins

  1. 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 ihr Add-In in Office im Web ausführen oder in AppSource veröffentlichen möchten, 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.

  2. Wählen Sie in Excel, Word oder PowerPoint im MenübandStart-Add-Ins> und dann Add-Ins abrufen aus. Wählen Sie in Project auf der Registerkarte Projekt des Menübands die Option Meine Add-Ins aus.

  3. Wählen Sie im Dialogfeld Office-Add-Ins oben die Option Freigegebener Ordner aus.

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