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 dem Agents Toolkit erstellt wurden, verwenden das einheitliche Manifest für Microsoft 365.

Hinweis

Informationen zu Clients und Plattformen, die Office-Add-Ins unterstützen, die das einheitliche Manifest für Microsoft 365 verwenden, finden Sie unter Office-Add-Ins mit dem einheitlichen App-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 Agents-Toolkit-Symbol in der Aktivitätsleiste.

   

2. Wählen Sie Neue App erstellenaus.

3. Das Dropdown-Menü Neues Projekt wird geöffnet. Die aufgelisteten Optionen variieren je nach Version des Agents-Toolkits. Office-Add-In auswählen.

   

4. Das Dropdownmenü "App-Funktionen, die ein Office-Add-In verwenden " wird geöffnet. Die aufgelisteten Optionen variieren je nach Version des Agents-Toolkits. Wählen Sie den Aufgabenbereich aus.

   

5. Ein Dropdownmenü mit den zu unterstützenden Office-Anwendungen wird geöffnet. Wählen Sie mindestens eine Anwendung aus, in der das Add-In ausgeführt werden soll.

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

7. Geben Sie dem Projekt einen Namen (ohne Leerzeichen), 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 auf den zuvor ausgewählten Office-Anwendungen installiert werden kann. Sie können das Manifest und die Quelldateien nach Bedarf bearbeiten, um zu ändern, welche Office-Anwendungen unterstützt werden.

8. Navigieren Sie in Visual Studio Code TERMINAL zum Stammverzeichnis des Projekts und führen Sie npm installaus.

9. Überprüfe nach Abschluss der Installation, ob du dein Add-In von Visual Studio Code querladen kannst. Die Schritte zum Querladen variieren je nach Office-Anwendung, in der Sie das Add-In testen möchten.

Querladen in Excel, PowerPoint oder Word

Hinweis

Dieser Abschnitt gilt nur, wenn Sie das Add-In auf einem Windows-Computer entwickeln.

1. Wählen SieAusführung in Visual Studio Code anzeigen | 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 auf Ihren Computer quergeladen 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-Eingabeaufforderung "Beim Laden anhalten " 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. Minimieren Sie nach Abschluss dieses Schritts das Anwendungsfenster von Office unter Windows, 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 Add-In geeignet ist, das Sie testen. Öffnen Sie ein neues oder vorhandenes Dokument in der Office-Anwendung im Web. Die Schaltflächen sollten auf dem Menüband "Start" angezeigt werden, genau wie in Office unter Windows.

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

   Hinweis

   Wenn der vorherige Schritt keine Wirkung zu haben scheint, deinstallieren Sie das Add-In, indem Sie ein TERMINAL in Visual Studio Code öffnen und dann den Befehl npm run stopausführen. Das Schließen des Serverfensters beendet den Server nicht zuverlässig, und das Schließen der Office-Anwendung führt nicht zuverlässig dazu, dass Office den Erwerb des Add-Ins aufhebt.

Weitere Möglichkeiten zum Querladen

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

Querladen in Outlook

Hinweis

Wenn Ihr Entwicklungscomputer Windows ist, stellen Sie sicher, dass Ihr Outlook-Client das klassische Outlook für Windows und nicht das neue Outlook unter Windows ist. Es gibt derzeit einen Fehler, der verhindert, dass Add-Ins, die mit dem Agents Toolkit erstellt wurden, ordnungsgemäß in das neue Outlook für Windows oder in Outlook im Web quergeladen werden.

1. Stellen Sie sicher, dass Ihr Konto in Ihrem Microsoft 365-Entwicklermandanten auch ein E-Mail-Konto in Outlook auf dem Desktop ist. Falls nicht, folgen Sie der Anleitung unter Hinzufügen eines E-Mail-Kontos zu Outlook.

2. Schließen Sie Outlook Desktop.

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

4. Überprüfen Sie im Abschnitt KONTEN , ob Sie bei Microsoft 365 angemeldet sind.

5. Wählen SieAusführung in Visual Studio Code anzeigen | 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, dann wird Outlook Desktop geöffnet.

   Hinweis

   Wenn Sie zum ersten Mal ein Office-Add-In auf Ihren Computer quergeladen 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. Im Menüband "Start" (oder im Menüband "Nachricht", wenn Sie die Nachricht in einem eigenen Fenster geöffnet haben) wird eine Contoso-Add-In-Registerkarte mit zwei Schaltflächen angezeigt.

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

   Hinweis

   Unabhängig davon, welche Schaltfläche Sie auswählen, wird eine WebView-Eingabeaufforderung "Beim Laden anhalten " angezeigt. Wählen Sie OK aus.

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

   Hinweis

   Wenn der vorherige Schritt keine Wirkung zu haben scheint, deinstallieren Sie das Add-In, indem Sie ein TERMINAL in Visual Studio Code öffnen und dann den Befehl npm run stopausführen. Das Schließen des Serverfensters beendet den Server nicht zuverlässig, und das Schließen der Office-Anwendung führt nicht zuverlässig dazu, dass Office den Erwerb des Add-Ins aufhebt.

Entwickeln Ihres Projekts

Jetzt können Sie das Projekt ändern und weiterentwickeln. Befolgen Sie an Stellen, an denen die Anleitung in der Dokumentation zu Office-Add-Ins je nach verwendetem Manifesttyp verzweigt ist, die Anweisungen für das einheitliche Manifest.