Querladen von Office-Add-Ins zu TestzweckenSideload Office Add-ins for testing

Sie können ein Office-Add-In zu Testzwecken in einem Office-Client installieren, der unter Windows ausgeführt wird, indem Sie das Manifest mithilfe eines freigegebenen Ordnerkatalogs auf einer Dateifreigabe im Netzwerk veröffentlichen.You can install an Office Add-in for testing in an Office client running on Windows by publishing the manifest to a network file share (instructions below).

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.If your add-in project was created with a sufficiently recent version of the Yeoman generator for Office Add-ins, the add-in will automatically sideload in the Office desktop client when you run npm start.

Dieser Artikel gilt nur für das Testen von Word-, Excel- oder PowerPoint-Add-Ins unter Windows.This article applies only to testing Word, Excel, PowerPoint, and Project add-ins on Windows. Wenn Sie auf einer anderen Plattform testen oder ein Outlook-Add-In testen möchten, sehen Sie sich eines der folgenden Themen an, um Ihr Add-In querzuladen:If you want to test on another platform or want to test an Outlook add-in, see one of the following topics to sideload your add-in:

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.The following video walks you through the process of sideloading your add-in on Office desktop or Office Online using a shared folder catalog.

Freigeben eines OrdnersShare a folder

  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.In File Explorer on the Windows computer where you want to host your add-in, go to the parent folder, or drive letter, of the folder you want to use as your shared folder catalog.

  2. Öffnen Sie das Kontextmenü für den Ordner, den Sie als Katalog mit freigegebenen Ordnern verwenden möchten (mit der rechten Maustaste auf den Ordner klicken), und wählen Sie Eigenschaften aus.Open the context menu for the folder you want to use as your shared folder catalog (right-click the folder) and choose Properties.

  3. Öffnen Sie im Dialogfeld Eigenschaften die Registerkarte Freigabe, und wählen Sie dann die Schaltfläche Freigeben.Within the Properties dialog window, open the Sharing tab and then choose the Share button.

    Dialogfeld "Ordnereigenschaften" mit hervorgehobener Registerkarte "Freigabe" und Schaltfläche "Freigeben"

  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.Within the Network access dialog window, add yourself and any other users and/or groups with whom you want to share your add-in. Sie benötigen mindestens Lese-/Schreibzugriff auf den Ordner.You will need at least Read/Write permission to the folder. Nachdem Sie Personen für die Freigabe ausgewählt haben, wählen Sie die Schaltfläche Freigeben aus.After you have finished choosing people to share with, choose the Share button.

  5. Wenn Sie eine Bestätigung erhalten, dass Ihr Ordner freigegeben wurde, notieren Sie den vollständigen Netzwerkpfad, der unmittelbar nach dem Ordnernamen angezeigt wird.When you see confirmation that Your folder is shared, make note of the full network path that's displayed immediately following the folder name. (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.) Wählen Sie die Fertig-Schaltfläche, um das Netzwerkzugriff-Dialogfeld zu schließen.(You will need to enter this value as the Catalog Url when you specify the shared folder as a trusted catalog, as described in the next section of this article.) Choose the Done button to close the Network access dialog window.

    Netzwerkzugriff-Dialog mit hervorgehobenem Freigabepfad

  6. Wählen Sie die Schaltfläche OK aus, um das Dialogfeld Eigenschaften zu schließen.Choose the Close button to close the Properties dialog window.

Geben Sie den freigegebenen Ordner als vertrauenswürdigen Katalog an.Specify the shared folder as a trusted catalog

  1. Öffnen Sie ein neues Dokument in Excel, Word, PowerPoint oder Project.Open a new document in Excel, Word, PowerPoint, or Project.

  2. Klicken Sie auf die Registerkarte Datei und dann auf Optionen.Choose the File tab, and then choose Options.

  3. Wählen Sie Sicherheitscenter aus, und wählen Sie dann die Schaltfläche Einstellungen für das Sicherheitscenter aus.Choose Trust Center, and then choose the Trust Center Settings button.

  4. Wählen Sie Vertrauenswürdige Add-In-Kataloge.Choose Trusted Add-in Catalogs.

  5. Geben Sie im Feld Katalog-URL den vollständigen Netzwerkpfad zu dem Ordner ein, den Sie zuvor freigegeben haben.In the Catalog Url box, enter the full network path to the folder that you shared previously. 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.If you failed to note the folder's full network path when you shared the folder, you can get it from the folder's Properties dialog window, as shown in the following screenshot.

    Dialog "Ordnereigenschaften" mit hervorgehobener Registerkarte "Freigabe" und Netzwerkpfad

  6. Nach der Eingabe des vollständigen Netzwerkpfads des Ordners in das Feld Katalog-URL wählen Sie die Katalog hinzufügen-Schaltfläche.After you've entered the full network path of the folder into the Catalog Url box, choose the Add catalog button.

  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.Select the Show in Menu check box for the newly-added item, and then choose the OK button to close the Trust Center dialog window.

    Dialog "Sicherheitscenter" mit ausgewähltem Katalog

  8. Wählen Sie die OK-Schaltfläche aus, um das Dialogfeld Word-Optionen zu schließen.Choose the OK button to close the Word Options dialog window.

  9. Schließen Sie die Office-Anwendung und öffnen Sie sie erneut, damit die Änderungen wirksam werden.Close and reopen the Office application so your changes will take effect.

Querladen des Add-InsSideload your add-in

  1. Legen Sie die Manifest-XML-Datei eines Add-Ins, das Sie testen, in den freigegebenen Ordnerkatalog.Put the manifest XML file of any add-in that you are testing in the shared folder catalog. Beachten Sie, dass Sie die Webanwendung selbst auf einem Webserver bereitstellen.Note that you deploy the web application itself to a web server. Achten Sie darauf, die URL im SourceLocation-Element der Manifestdatei anzugeben.Be sure to specify the URL in the SourceLocation element of the manifest file.

    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 das Add-In in Office Online ausführen oder das Add-In 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.While not strictly required in all add-in scenarios, using an HTTPS endpoint for your add-in is strongly recommended. Add-ins that are not SSL-secured (HTTPS) generate unsecure content warnings and errors during use. If you plan to run your add-in in Office Online or publish your add-in to AppSource, it must be SSL-secured. If your add-in accesses external data and services, it should be SSL-secured to protect data in transit. Self-signed certificates can be used for development and testing, so long as the certificate is trusted on the local machine.

  2. Wählen Sie in Excel, Word oder PowerPoint Meine Add-Ins aus der Registerkarte Einfügen des Menübands aus.In Excel, Word, or PowerPoint, select My Add-ins on the Insert tab of the ribbon. Wählen Sie in Project Meine Add-Ins auf der Registerkarte Projekt im Menüband aus.In Project, select My Add-ins on the Project tab of the ribbon.

  3. Wählen Sie im Dialogfeld Office-Add-Ins oben die Option Freigegebener Ordner aus.Choose SHARED FOLDER at the top of the Office Add-ins dialog box.

  4. Wählen Sie den Namen des Add-Ins aus, und klicken Sie auf Hinzufügen, um das Add-In einzufügen.Select the name of the add-in and choose OK to insert the add-in.

Siehe auchSee also