Erstellen von Office-Add-In-Projekten mit dem Microsoft 365 Agents Toolkit

Ein primäres Tool für die Entwicklung von Microsoft 365-Apps und -Agents, einschließlich Office-Add-Ins, ist das Microsoft 365 Agents Toolkit.

Add-Ins, die mit agents Toolkit erstellt wurden, verwenden das einheitliche Manifest für Microsoft 365.

Installieren Sie die neueste Version von Agents Toolkit in Visual Studio Code, wie unter Installieren von Microsoft 365 Agents Toolkit beschrieben.

Erstellen eines Office-Add-In-Projekts

1. Öffnen Sie Visual Studio Code, und wählen Sie das Symbol Agents Toolkit in der Aktivitätsleiste aus.

   

2. Wählen Sie Neue App erstellenaus.

3. Das Dropdownmenü Neues Projekt wird geöffnet. Die aufgeführten Optionen variieren je nach Ihrer Version des Agents Toolkits. Wählen Sie Office-Add-In aus.

   

4. Das Dropdownmenü App-Features mit einem Office-Add-In wird geöffnet. Die aufgeführten Optionen variieren je nach Ihrer Version des Agents Toolkits. Wählen Sie Aufgabenbereich aus.

   

5. Wählen Sie im daraufhin geöffneten Dialogfeld Arbeitsbereichsordner den Ordner aus, in dem Sie das Projekt erstellen möchten.

6. Geben Sie dem Projekt (ohne Leerzeichen) einen Namen, wenn Sie dazu aufgefordert werden. Agents Toolkit erstellt das Projekt mit Basisdateien und Gerüsten. Anschließend wird das Projekt in einem zweiten Visual Studio Code-Fenster geöffnet. Schließen Sie das ursprüngliche Visual Studio Code-Fenster.

   Hinweis

   Das generierte Projekt ist so konfiguriert, dass es in Excel, Outlook, PowerPoint und Word installiert werden kann. Sie können das Manifest und die Quelldateien nach Bedarf bearbeiten, um zu ändern, welche Office-Anwendungen unterstützt werden.

7. Navigieren Sie im Visual Studio Code-TERMINAL zum Stammverzeichnis des Projekts, und führen Sie aus npm install.

8. Vergewissern Sie sich nach Abschluss der Installation, dass Sie Ihr Add-In aus Visual Studio Code querladen können. Die Schritte zum Querladen hängen von der Office-Anwendung ab, in der Sie das Add-In testen möchten.

Querladen in Excel, PowerPoint oder Word

1. Wählen Sie In Visual Studio Codeausführenanzeigen | aus. Wählen Sie im Dropdownmenü AUSFÜHREN UND DEBUGGEN eine der folgenden Optionen aus:

   • Excel Desktop (Edge Chromium)
   • PowerPoint Desktop (Edge Chromium)
   • Word Desktop (Edge Chromium)

2. Drücken Sie F5. Das Projekt wird erstellt, und ein Node dev-server-Fenster wird geöffnet. Dieser Vorgang kann einige Minuten dauern. Schließlich wird die Desktopversion der ausgewählten Office-Anwendung geöffnet.

   Hinweis

   Wenn Sie zum ersten Mal ein Office-Add-In quer auf Ihren Computer geladen haben (oder das erste Mal seit mehr als einem Monat), werden Sie möglicherweise aufgefordert, ein altes Zertifikat zu löschen und/oder ein neues zu installieren. Stimmen Sie beiden Eingabeaufforderungen zu.

3. Im Menüband Start wird eine Contoso-Add-In-Registerkarte mit zwei Schaltflächen angezeigt. Verwenden Sie eine Schaltfläche, um eine Aktion im geöffneten Office-Dokument auszuführen. Verwenden Sie die andere , um den Aufgabenbereich des Add-Ins zu öffnen.

   Hinweis

   Unabhängig davon, welche Schaltfläche Sie auswählen, wird eine WebView-Aufforderung Zum Beenden beim Laden angezeigt. Wählen Sie OK aus.

   Tipp

   Durch das Querladen in Office unter Windows wird das Add-In auch in Office im Web verfügbar, sodass Sie es auch auf dieser Plattform testen können. Nachdem dieser Schritt abgeschlossen ist, minimieren Sie das Office unter Windows-Anwendungsfenster, und navigieren Sie in einem Browser zu https://excel.cloud.microsoft/, https://word.cloud.microsoft/oder https://powerpoint.cloud.microsoft/, je nachdem, was für das Zu testende Add-In geeignet ist. Öffnen Sie ein neues oder vorhandenes Dokument in der Office-Anwendung im Web. Die Schaltflächen sollten auf dem Menüband Start wie in Office unter Windows angezeigt werden.

4. Um das Debuggen zu beenden und das Add-In zu deinstallieren, wählen Sie Debuggen in Visual Studio Code ausführen | beenden aus.

   Hinweis

   Wenn der vorherige Schritt anscheinend keine Auswirkungen hat, deinstallieren Sie das Add-In, indem Sie ein TERMINAL in Visual Studio Code öffnen und dann den Befehl ausführen npm run stop. Durch das Schließen des Serverfensters wird der Server nicht zuverlässig beendet, und das Schließen der Office-Anwendung führt nicht zuverlässig dazu, dass Office das Add-In nicht mehr anfordert.

Andere Möglichkeiten zum Querladen

Unter Querladen von Office-Add-Ins, die das einheitliche Manifest für Microsoft 365 verwenden, finden Sie alternative Möglichkeiten zum Querladen eines Excel-, PowerPoint- oder Word-Add-Ins, einschließlich über den App Store in Teams.

Querladen in Outlook

1. Stellen Sie sicher, dass Ihr Konto in Ihrem Microsoft 365-Entwicklermandanten auch ein E-Mail-Konto in Outlook desktop ist. Wenn dies nicht der Fall ist, befolgen Sie die Anleitung unter Hinzufügen eines E-Mail-Kontos zu Outlook.

2. Schließen Sie den Outlook-Desktop.

3. Öffnen Sie in Visual Studio Code das Agents Toolkit.

4. Vergewissern Sie sich im Abschnitt KONTEN , dass Sie bei Microsoft 365 angemeldet sind.

5. Wählen Sie In Visual Studio Codeausführenanzeigen | aus. Wählen Sie im Dropdownmenü AUSFÜHREN UND DEBUGGEN die Option Outlook Desktop (Edge Chromium) aus, und drücken Sie dann F5. Das Projekt wird erstellt, und ein Node dev-server-Fenster wird geöffnet. Dieser Vorgang kann einige Minuten dauern, und dann wird Outlook Desktop geöffnet.

   Hinweis

   Wenn Sie zum ersten Mal ein Office-Add-In quer auf Ihren Computer geladen haben (oder das erste Mal seit mehr als einem Monat), werden Sie möglicherweise aufgefordert, ein altes Zertifikat zu löschen und/oder ein neues zu installieren. Stimmen Sie beiden Eingabeaufforderungen zu.

6. Öffnen Sie den PosteingangIhrer Microsoft 365-Kontoidentität , und öffnen Sie eine beliebige Nachricht. Eine Contoso-Add-In-Registerkarte mit zwei Schaltflächen wird im Menüband Start (oder im Menüband Nachricht angezeigt, wenn Sie die Nachricht in einem eigenen Fenster geöffnet haben).

7. Klicken Sie auf die Schaltfläche Aufgabenbereich anzeigen , und ein Aufgabenbereich wird geöffnet. Klicken Sie auf die Schaltfläche Aktion ausführen , und am oberen Rand der Nachricht wird eine kleine Benachrichtigung angezeigt.

   Hinweis

   Unabhängig davon, welche Schaltfläche Sie auswählen, wird eine WebView-Aufforderung Zum Beenden beim Laden angezeigt. Wählen Sie OK aus.

8. Um das Debuggen zu beenden und das Add-In zu deinstallieren, wählen Sie Debuggen in Visual Studio Code ausführen | beenden aus.

   Hinweis

   Wenn der vorherige Schritt anscheinend keine Auswirkungen hat, deinstallieren Sie das Add-In, indem Sie ein TERMINAL in Visual Studio Code öffnen und dann den Befehl ausführen npm run stop. Durch das Schließen des Serverfensters wird der Server nicht zuverlässig beendet, und das Schließen der Office-Anwendung führt nicht zuverlässig dazu, dass Office das Add-In nicht mehr anfordert.

Entwickeln Ihres Projekts

Jetzt können Sie das Projekt ändern und entwickeln. Befolgen Sie an Stellen, an denen die Anleitungen in der Dokumentation zu Office-Add-Ins abhängig davon, welcher Manifesttyp verwendet wird, die Anweisungen für das einheitliche Manifest.