Freigeben über

Inszenieren eines Office-Add-Ins in Microsoft Azure mit Visual Studio

  • Artikel

Das einfachste Office-Add-In besteht aus einer Manifestdatei und einer HTML-Seite. Die Manifestdatei beschreibt die Merkmale des Add-Ins, z. B. seinen Namen, welche Office-Desktopclients es ausführen kann, und die URL für die HTML-Seite des Add-Ins. Die HTML-Seite ist in einer Web-App enthalten, mit der Benutzer interagieren, wenn sie Ihr Add-In in einer Office-Clientanwendung installieren und ausführen. Sie können die Web-App eines Office-Add-Ins auf jeder Webhostingplattform hosten, einschließlich Azure.

In diesem Artikel wird beschrieben, wie Sie eine Web-App eines Add-Ins in Azure bereitstellen und das Add-In zu Testzwecken in einer Office-Clientanwendung querladen.

Wichtig

Der in diesem Artikel beschriebene Prozess gilt nicht für Outlook-Add-Ins. Anweisungen zum Staging von Add-Ins für Outlook in Azure finden Sie unter Bereitstellen eines Outlook-Add-Ins in Microsoft Azure mit Visual Studio.

Voraussetzungen

  1. Installieren Sie Visual Studio 2022 , und schließen Sie die Azure-Entwicklungsworkload ein.

    Hinweis

    Wenn Sie Visual Studio 2022 bereits installiert haben, verwenden Sie die Visual Studio-Installer, um sicherzustellen, dass die Azure-Entwicklungsworkload installiert ist.

  2. Office installieren

    Hinweis

    Wenn Office noch nicht installiert ist, können Sie sich für eine 1-monatige kostenlose Testversion registrieren.

  3. Rufen Sie ein Azure-Abonnement ab.

    Hinweis

    Wenn Sie noch nicht über ein Azure-Abonnement verfügen, können Sie im Rahmen Ihres Visual Studio-Abonnements ein Abo erhalten oder sich für die kostenlose Testversion registrieren.

Schritt 1: Erstellen eines freigegebenen Ordners zum Hosten der Add-In-Manifestdatei

  1. Öffnen Sie den Datei-Explorer auf Ihrem Entwicklungscomputer.

  2. Klicken Sie mit der rechten Maustaste auf das Laufwerk C:\ (oder wählen Sie es aus, und halten Sie es gedrückt), und wählen Sie dann Neuer>Ordner aus.

  3. Geben Sie „AddinManifests“ als Namen des neuen Ordners ein.

  4. Klicken Sie mit der rechten Maustaste auf den Ordner AddinManifests (oder wählen Sie sie aus, und halten Sie es gedrückt), und wählen Sie dann Für>bestimmte Personen freigeben aus.

  5. Wählen Sie in der Dateifreigabe den Dropdownpfeil und anschließend Jeder>Hinzufügen>Freigabe.

Hinweis

In dieser exemplarischen Vorgehensweise verwenden Sie eine lokale Dateifreigabe als vertrauenswürdigen Katalog, in dem Sie die Add-In-Manifestdatei speichern. In einem realen Szenario können Sie stattdessen die Manifestdatei in einem SharePoint-Katalog bereitstellen oder das Add-In in AppSource veröffentlichen.

Schritt 2: Hinzufügen der Dateifreigabe zum Katalog „Vertrauenswürdige Add-Ins“

  1. Starten Sie Word, und erstellen Sie ein Dokument.

    Hinweis

    Obwohl in diesem Beispiel Word verwendet wird, können Sie jede Beliebige Office-Anwendung verwenden, die Office-Add-Ins wie Excel, PowerPoint oder Project unterstützt.

  2. Klicken Sie auf Datei>Optionen.

  3. Wählen Sie im Dialogfeld mit den Word-Optionen die Option Trust Center und anschließend Einstellungen für das Trust Center aus.

  4. Wählen Sie im Dialogfeld Trust Center die Option Vertrauenswürdige Add-In-Kataloge aus. Geben Sie den UNC-Pfad (Universal Naming Convention) für die Dateifreigabe ein, die Sie zuvor als Katalog-URL erstellt haben (z. B. \\YourMachineName\AddinManifests), und wählen Sie dann Katalog hinzufügen aus.

  5. Aktivieren Sie das Kontrollkästchen für Im Menü anzeigen.

    Hinweis

    Wenn Sie eine Add-In-Manifestdatei auf einer Freigabe speichern, die als vertrauenswürdiger Web-Add-In-Katalog angegeben ist, wird das Add-In unter Freigegebener Ordner im Dialogfeld Office-Add-Ins angezeigt, das vonStart-Add-Ins>Get Add-Ins> gestartet wird.

  6. Schließen Sie Word.

Schritt 3: Erstellen eines Office-Add-Ins in Visual Studio

  1. Starten Sie Visual Studio als Administrator.

  2. Wählen Sie Neues Projekt erstellen aus.

  3. Geben Sie Add-In in das Suchfeld ein.

  4. Klicken Sie auf Word-Web-Add-In als Projekttyp und dann auf Weiter, um die Standardeinstellungen zu übernehmen.

Visual Studio erstellt ein Word-Basis-Add-in, das Sie veröffentlichen können, ohne Änderungen an dem Webprojekt vorzunehmen. Um ein Add-In für eine andere Office-Anwendung wie Excel zu erstellen, wiederholen Sie die Schritte, und wählen Sie einen Projekttyp mit der gewünschten Office-Anwendung aus.

Schritt 4: Veröffentlichen Ihrer Office-Add-In-Web-App in Azure

  1. Klicken Sie bei geöffnetem Add-In-Projekt in Visual Studio mit der rechten Maustaste auf das Webprojekt (oder wählen Sie es aus, und halten Sie es gedrückt), und wählen Sie dann Veröffentlichen aus.

  2. Befolgen Sie die Anweisungen unter Veröffentlichen Ihrer Web-App. Überspringen Sie die Artikelabschnitte, die vor dem Veröffentlichen Ihrer Web-App stehen, aber stellen Sie sicher, dass die Visual Studio-Schaltfläche oben auf der Seite ausgewählt ist.

    Visual Studio veröffentlicht das Webprojekt für Ihr Office-Add-In in Ihrer Azure-Web-App. Wenn Visual Studio die Veröffentlichung des Webprojekts abgeschlossen hat, wird Ihr Browser geöffnet und zeigt eine Webseite mit dem Text "Ihre Web-App wird ausgeführt und wartet auf Ihren Inhalt" an. Dies ist die aktuelle Standardseite für die Web-App.

  3. Kopieren Sie die Stamm-URL (z. B. https://YourDomain.azurewebsites.net). Sie benötigen sie, wenn Sie die Add-In-Manifestdatei weiter unten in diesem Artikel bearbeiten.

Schritt 5: Bearbeiten und Bereitstellen der Add-In-Manifestdatei

  1. Erweitern Sie in Visual Studio bei geöffnetem Office-Add-In im Projektmappen-Explorer das Projekt, sodass beide Projekte angezeigt werden.

  2. Erweitern Sie das Office-Add-In-Projekt (z. B. WordWebAddIn), klicken Sie mit der rechten Maustaste auf den Manifestordner (oder wählen Sie diesen aus, und halten Sie es gedrückt), und wählen Sie dann Öffnen aus. Die Add-In-Manifestdatei wird geöffnet.

  3. Suchen Sie in der Manifestdatei alle Instanzen von "~remoteAppUrl", und ersetzen Sie sie durch die Stamm-URL der Add-In-Web-App in Azure. Dies ist die URL, die Sie zuvor kopiert haben, nachdem Sie die Add-In-Web-App in Azure veröffentlicht haben (Beispiel: https://YourDomain.azurewebsites.net).

  4. Wählen Sie Datei und anschließend Alle speichern aus. Kopieren Sie als Nächstes die Add-In-Manifestdatei (z. B. WordWebAddIn.xml).

  5. Navigieren Sie mithilfe des Programms Datei-Explorer zu der Netzwerkdateifreigabe, die Sie unter Schritt 1: Erstellen eines freigegebenen Ordners erstellt haben, und fügen Sie die Manifestdatei in den Ordner ein.

Schritt 6: Einfügen und Ausführen des Add-Ins in der Office-Clientanwendung

  1. Starten Sie Word, und erstellen Sie ein Dokument.

  2. Wählen SieStart-Add-Ins> und dann Add-Ins abrufen aus.

  3. Wählen Sie im Dialogfeld Office-Add-Ins die Option Freigegebener Ordner aus. Word durchsucht den Ordner, den Sie als Katalog vertrauenswürdiger Add-Ins angegeben haben (unter Schritt2: Hinzufügen der Dateifreigabe zum Katalog „Vertrauenswürdige Add-Ins“) und zeigt die Add-Ins im Dialogfeld an. Es sollte ein Symbol für das Beispiel-Add-In angezeigt werden.

  4. Wählen Sie das Symbol für Ihr Add-In aus, und klicken Sie dann auf Hinzufügen. Die Schaltfläche Aufgabenbereich anzeigen für Ihr Add-In wird zum Menüband hinzugefügt.

  5. Wählen Sie im Menüband der Registerkarte Start die Schaltfläche Aufgabenbereich anzeigen. Das Add-In wird in einem Aufgabenbereich auf der rechten Seite des aktuellen Dokuments geöffnet.

  6. Stellen Sie sicher, dass das Add-In funktioniert, indem Sie beliebigen Text im Dokument markieren und die Schaltfläche Hervorheben! im Aufgabenbereich auswählen.

Bereitstellen von Updates

Sie stellen Updates für Ihre Webanwendung auf die gleiche Weise bereit, wie zuvor beschrieben. Änderungen am Manifest erfordern eine erneute Verteilung Des Manifests an Benutzer. Der hierfür ausgeführte Prozess hängt von Ihrer Veröffentlichungsmethode ab. Weitere Informationen zum Aktualisieren Ihres Add-Ins finden Sie unter Verwalten Ihres Office-Add-Ins.

Siehe auch