Entwicklerhandbuch für VSTO-Add-Ins für Office-Web-Add-Ins

  • Artikel

Sie haben also einige VSTO-Add-Ins für Office-Anwendungen erstellt, die unter Windows ausgeführt werden, und jetzt erkunden Sie die neue Art der Erweiterung von Office, die unter Windows, Mac und der Webbrowserversion der Office-Suite ausgeführt wird: Office Web-Add-Ins.

Wichtig

COM- und VSTO-Add-Ins werden im neuen Outlook unter Windows , das sich derzeit in der Vorschau befindet, nicht unterstützt. Diese Add-Ins werden weiterhin im klassischen Desktopclient von Outlook unter Windows unterstützt. Weitere Informationen finden Sie unter Entwickeln von Outlook-Add-Ins für neues Outlook unter Windows (Vorschauversion).

Ihr Verständnis der Objektmodelle für die Excel-, Word- und anderen Office-Anwendungen wird von großem Nutzen sein, da die Objektmodelle in Office Web-Add-Ins ähnliche Muster aufweisen. Es gibt jedoch einige Herausforderungen:

  • Sie arbeiten mit einer anderen Sprache (JavaScript oder TypeScript) anstelle von C# oder Visual Basic .NET. (Es gibt auch eine Möglichkeit, wie weiter unten beschrieben, einen Teil Ihres vorhandenen Codes in einem Web-Add-In wiederzuverwenden.)
  • Office Web-Add-Ins werden anders als VSTO-Add-Ins bereitgestellt.
  • Office-Web-Add-Ins sind Webanwendungen, die in einem vereinfachten Webview-Steuerelement ausgeführt werden, das in die Office-Anwendung eingebettet ist. Daher müssen Sie ein grundlegendes Verständnis von Webanwendungen und deren Hosting auf Webservern oder Cloudkonten erlangen.

Aus diesen Gründen dupliziert ein Großteil dieses Artikels unseren Leitfaden für Anfänger zu Office-Erweiterungen. Wir haben einige Lernressourcen hinzugefügt, um VSTO-Add-In-Entwickler dabei zu unterstützen, ihre Erfahrung zu nutzen und ihnen auch dabei zu helfen, ihren vorhandenen Code wiederzuverwenden.

Schritt 0: Voraussetzungen

  • Office Web-Add-Ins (auch als Office-Add-Ins bezeichnet) sind im Wesentlichen in Office eingebettete Webanwendungen. Daher sollten Sie zunächst ein grundlegendes Verständnis von Webanwendungen und deren Hosting im Web haben. Darüber gibt es im Internet, in Büchern und in Onlinekursen eine enorme Menge an Informationen. Eine gute Möglichkeit zu beginnen, wenn Sie überhaupt keine Vorkenntnisse über Webanwendungen haben, ist die Suche nach "Was ist eine Web-App?" in Ihrer Suchmaschine.
  • Die primäre Programmiersprache, die Sie bei der Erstellung von Office-Add-Ins verwenden werden, ist JavaScript oder TypeScript. Wenn Sie mit keiner dieser Sprachen vertraut sind, aber Erfahrung mit VBA, VB.NET, C# haben, ist TypeScript wahrscheinlich einfacher zu erlernen. Auch hier gibt es eine Fülle von Informationen über diese Sprachen im Internet, in Büchern und in Onlinekursen.

Schritt 1: Beginnen Sie mit den Grundlagen

Wir wissen, dass Sie eifrig mit der Programmierung beginnen möchten, aber es gibt einige Dinge über Office-Add-Ins, die Sie lesen sollten, bevor Sie Ihre IDE oder Ihren Code-Editor öffnen.

  • Überblick über die Plattform für Office-Add-Ins: Finden Sie heraus, was Office-Web-Add-Ins sind und wie sie sich von älteren Methoden zur Erweiterung von Office, wie z. B. VSTO-Add-Ins, unterscheiden.
  • Entwickeln von Office-Add-Ins: Verschaffen Sie sich einen Überblick über die Entwicklung und den Lebenszyklus von Office-Add-Ins, einschließlich der Tools, der Erstellung einer Add-In-Benutzeroberfläche und der Verwendung der JavaScript-APIs zur Interaktion mit dem Office-Dokument.

Diese Artikel enthalten eine Menge Links, aber wenn Sie gerade zu Office Web-Add-Ins wechseln, empfehlen wir Ihnen, nach deren Lektüre hierher zurückzukehren, und mit dem nächsten Abschnitt fortzufahren.

Schritt 2: Installieren Sie die Tools und erstellen Sie Ihr erstes Add-In

Sie haben jetzt das große Ganze im Blick, also tauchen Sie mit einem unserer Schnellstarts ein. Zum Kennenlernen der Plattform empfehlen wir den Excel-Schnellstart. Es gibt eine Version, die auf Visual Studio basiert, während eine weitere auf Node.js und Visual Studio Code basiert. Wenn Sie gerade von VSTO-Add-Ins wechseln, werden Sie das Arbeiten mit der Visual Studio-Version wahrscheinlich einfacher finden.

Schritt 3: Code

Sie lernen das Fahren nicht, indem Sie das Benutzerhandbuch lesen, also beginnen Sie mit diesem Excel-Tutorial mit dem Codieren. Sie werden die Office-JavaScript-Bibliothek und etwas XML im Manifest des Add-Ins verwenden. Sie müssen sich nichts merken, da Sie in späteren Schritten mehr Hintergrundinformationen über beides erhalten.

Schritt 4: Grundlegendes zur JavaScript-Bibliothek

Verschaffen Sie sich einen überblick über die Office JavaScript-Bibliothek mit dem Tutorial Grundlegendes zu den Office JavaScript-APIs aus der Microsoft Learn-Schulung.

Erkunden Sie dann die Office-JavaScript-APIs mit dem Script Lab-Tool – einer Sandbox zum Ausführen und Erkunden der APIs.

Spezielle Ressource für VSTO-Add-In-Entwickler

Dies wäre ein guter Ausgangspunkt, um sich das Beispiel-Add-In Excel-Add-In "JavaScript SalesTracker" anzusehen. Es wurde entwickelt, um die Ähnlichkeiten und Unterschiede zwischen VSTO-Add-Ins und Office Web-Add-Ins deutlich zu machen. In der Readme-Datei des Beispiels werden die wichtigsten Vergleichspunkte aufgeführt.

Schritt 5: Grundlegendes zum Manifest

Verschaffen Sie sich einen Überblick über die Zwecke des Web-Add-In-Manifests und eine Einführung in das XML-Markup oder JSON im Office-Add-Ins-Manifest.

Schritt 6 (nur für VSTO-Entwickler): erneute Verwendung von eigenem VSTO-Code

Sie können einigen eigenen VSTO-Add-In-Code in einem Office Web-Add-In wiederverwenden, indem Sie ihn auf dem Server in das Back-End Ihrer Webanwendung verschieben und als Web-API für Ihr JavaScript oder TypeScript zur Verfügung stellen. Anweisungen hierzu finden Sie unter Tutorial: Gemeinsame Nutzung von Code in VSTO- und Office-Add-Ins unter Verwendung einer gemeinsamen Codebibliothek.

Nächste Schritte

Herzlichen Glückwunsch zum Abschluss des Lehrpfads für Office Web-Add-Ins für VSTO-Add-In-Entwickler! Hier sind einige Vorschläge zur weiteren Erkundung unserer Dokumentation: