Übersicht über Excel-Add-InsExcel add-ins overview

Ein Excel-Add-In ermöglicht es Ihnen, Ihre Excel-Anwendungsfunktionen über mehrere Plattformen hinweg auszuführen, einschließlich Windows, Mac, iPad und im Browser. Verwendung von Excel-Add-Ins innerhalb einer Arbeitsmappe:An Excel add-in allows you to extend Excel application functionality across multiple platforms including Office on Windows, Office Online, Office for Mac, and Office for iPad. Use Excel add-ins within a workbook to:

  • Interagieren mit Excel-Objekten, Lesen und Schreiben von Excel-DatenInteract with Excel objects, read and write Excel data.
  • Erweitern der Funktionalität mithilfe eines webbasierten Aufgaben- oder InhaltsbereichsExtend functionality using web based task pane or content pane
  • Hinzufügen von benutzerdefinierten Befehlsschaltflächen auf dem Menüband oder kontextbezogenen MenüelementenAdd custom ribbon buttons or contextual menu items
  • Bereitstellen umfangreicherer Interaktion mit einem DialogfeldfensterProvide richer interaction using dialog window

Die Office-Add-Ins-Plattform bietet das Framework und die Office.js JavaScript-APIs zum Erstellen und Ausführen von Excel-Add-Ins. Das Erstellen einer Excel-Add-In mithilfe der Office-Add-Ins-Plattform bietet die folgenden Vorteile:The Office Add-ins platform provides the framework and Office.js JavaScript APIs that enable you to create and run Excel add-ins. By using the Office Add-ins platform to create your Excel add-in, you'll get the following benefits:

  • Plattformübergreifende Unterstützung: Excel-Add-Ins werden in Office für Windows, Mac und auf dem iPad ausgeführt.Cross-platform support: Excel add-ins run in Office on Windows, Mac, iOS, and Office Online.
  • Zentrale Bereitstellung: Administratoren können schnell und einfach Excel-Add-Ins für Benutzer in der gesamten Organisation bereitstellen.Centralized deployment: Admins can quickly and easily deploy Excel add-ins to users throughout an organization.
  • Verwenden der standardmäßigen Webtechnologie: Erstellen Sie Ihr Excel-Add-In mit vertrauten Webtechnologien wie HTML, CSS und JavaScript.Use of standard web technology: Create your Excel add-in using familiar web technologies such as HTML, CSS, and JavaScript.
  • Verteilung über AppSource: Teilen Sie Ihr Excel-Add-In mit einem breiten Publikum, indem Sie es in AppSource veröffentlichen.Distribution via AppSource: Share your Excel add-in with a broad audience by publishing it to AppSource.

Hinweis

Excel-Add-Ins unterscheiden sich von früheren Office-Integrationslösungen wie COM- oder VSTO-Add-Ins, die nur auf Office für Windows ausgeführt werden. Im Gegensatz zu COM-Add-Ins müssen für Excel-Add-Ins keine Codes auf dem Gerät des Benutzers oder innerhalb von Excel installiert werden.Excel add-ins are different from COM and VSTO add-ins, which are earlier Office integration solutions that run only in Office on Windows. Unlike COM add-ins, Excel add-ins do not require you to install any code on a user's device, or within Excel.

Komponenten eines Excel-Add-InComponents of an Excel add-in

Ein Excel-Add-In umfasst zwei Hauptkomponenten: eine Web-Anwendung und eine Konfigurationsdatei namens Manifestdatei.An Excel add-in includes two basic components: a web application and a configuration file, called a manifest file.

Die Webanwendung verwendet die JavaScript-API für Office, um mit Objekten in Excel zu interagieren, und kann auch die Interaktion mit Online-Ressourcen vereinfachen. Ein Add-In kann beispielsweise die folgenden Aufgaben ausführen:The web application uses the JavaScript API for Office to interact with objects in Excel, and can also facilitate interaction with online resources. For example, an add-in can perform any of the following tasks:

  • Erstellen, Lesen, Aktualisieren und Löschen von Daten in der Arbeitsmappe (Arbeitsblätter, Bereiche, Tabellen, Diagramme, benannte Elemente und mehr).Create, read, update, and delete data in the workbook (worksheets, ranges, tables, charts, named items, and more).
  • Durchführen der Benutzerautorisierung eines Onlinedienstes mithilfe des standardmäßigen OAuth 2.0 Flusses.Perform user authorization with an online service by using the standard OAuth 2.0 flow.
  • Ausgeben von API-Anfragen an Microsoft Graph oder eine beliebige andere API.Issue API requests to Microsoft Graph or any other API.

Die Webanwendung kann auf einem beliebigen Webserver gehostet und mithilfe von clientseitigen Frameworks (z. B. Angular, React, jQuery) oder serverseitigen Technologien (z. B. ASP.NET, Node.js, PHP) erstellt werden.The web application can be hosted on any web server, and can be built using client-side frameworks (such as Angular, React, jQuery) or server-side technologies (such as ASP.NET, Node.js, PHP).

manifest ist eine XML-Konfigurationsdatei, die definiert, wie das Add-In in Office-Clients integriert wird. Die Definition erfolgt dabei durch Angeben von Einstellungen und Funktionen wie:The manifest is an XML configuration file that defines how the add-in integrates with Office clients by specifying settings and capabilities such as:

  • Die URL der Add-In-Webanwendung.The URL of the add-in's web application.
  • Der Anzeigename, die Beschreibung, die ID, die Version und das Standardgebietsschema des Add-Ins.The add-in's display name, description, ID, version, and default locale.
  • Wie das Add-In in Excel integriert ist, einschließlich benutzerdefinierter Benutzeroberflächen (Menübandschaltflächen, Kontextmenüs usw.), die das Add-In erstellt.How the add-in integrates with Excel, including any custom UI that the add-in creates (ribbon buttons, context menus, and so on).
  • Berechtigungen, die das Add-In benötigt, wie Lese- und Schreibzugriff auf das Dokument.Permissions that the add-in requires, such as reading and writing to the document.

Damit Endbenutzer ein Excel-Add-In installieren und verwenden können, müssen Sie das Manifest in AppSource oder im Katalogs eines Add-Ins veröffentlichen.To enable end users to install and use an Excel add-in, you must publish its manifest either to AppSource or to an add-ins catalog.

Funktionen eines Excel-Add-InsCapabilities of an Excel add-in

Neben der Interaktion mit dem Inhalt einer Arbeitsmappe kann ein Excel-Add-In benutzerdefinierte Befehlsschaltflächen auf dem Menüband oder Menübefehle hinzufügen, Aufgabenbereiche einfügen, Dialogfelder öffnen und sogar umfangreiche webbasierte Inhalte, webbasierte Objekte wie Tabellen oder interaktive Visualisierungen direkt in ein Arbeitsblatt einbetten.In addition to interacting with the content in the workbook, Excel add-ins can add custom ribbon buttons or menu commands, insert task panes, open dialog boxes, and even embed rich, web-based objects such as charts or interactive visualizations within a worksheet.

Add-In-BefehleAdd-in commands

Add-In-Befehle sind Benutzeroberflächenelemente, die die Excel-Benutzeroberfläche erweitern und Aktionen in Ihrem Add-In starten. Sie können Add-In-Befehle verwenden, um eine Schaltfläche auf dem Menüband oder ein Element zu einem Kontextmenü in Excel hinzuzufügen. Wenn Benutzer einen Add-In-Befehl auswählen, werden Aktionen, wie das Ausführen von JavaScript-Code oder das Anzeigen einer Add-In-Seite in einem Aufgabenbereich initiiert.Add-in commands are UI elements that extend the Excel UI and start actions in your add-in. You can use add-in commands to add a button on the ribbon or an item to a context menu in Excel. When users select an add-in command, they initiate actions such as running JavaScript code, or showing a page of the add-in in a task pane.

Add-In-BefehleAdd-in commands

Add-In-Befehle in Excel

Weitere Informationen zu Befehlsfunktionen, unterstützten Plattformen und bewährten Methoden für die Entwicklung von Add-In-Befehlen finden Sie unter Add-In-Befehle für Excel, Word und PowerPoint.For more information about command capabilities, supported platforms, and best practices for developing add-in commands, see Add-in commands for Excel, Word, and PowerPoint.

AufgabenbereicheTask panes

Aufgabenbereiche sind Teile der Benutzeroberfläche, die in der Regel auf der rechten Seite des Fensters in Excel angezeigt werden. Aufgabenbereiche gewähren Benutzern Zugriff auf Benutzeroberflächen-Steuerelemente, die Code ausführen, um das Excel-Dokument oder Anzeigedaten aus einer Datenquelle zu ändern.Task panes are interface surfaces that typically appear on the right side of the window within Excel. Task panes give users access to interface controls that run code to modify the Excel document or display data from a data source.

AufgabenbereichTask pane

Excel-Aufgabenbereich-Add-In

Weitere Informationen zu Aufgabenbereichen finden Sie unter Aufgabenbereiche in Office-Add-Ins. Ein Beispiel für die Implementierung eines Aufgabenbereichs in Excel finden Sie unter Excel Add-in JS WoodGrove Expense Trends.For more information about task panes, see Task panes in Office Add-ins. For a sample that implements a task pane in Excel, see Excel Add-in JS WoodGrove Expense Trends.

DialogfelderDialog boxes

Dialogfelder sind Oberflächen, die frei verschiebbar über dem aktiven Fenster der Excel-Anwendung angezeigt werden. Mit Dialogfeldern können Sie z. B. folgende Aufgaben durchführen: Anzeigen von Anmeldeseiten, die nicht direkt in einem Aufgabenbereich geöffnet werden, Auffordern zur Bestätigung einer Benutzeraktion oder Hosten von Videos, die in einem Aufgabenbereich möglicherweise zu klein angezeigt werden. Verwenden Sie die Dialog-API, um Dialogfelder in Ihrem Office-Add-In zu öffnen.Dialog boxes are surfaces that float above the active Excel application window. You can use dialog boxes for tasks such as displaying sign-in pages that can't be opened directly in a task pane, requesting that the user confirm an action, or hosting videos that might be too small if confined to a task pane. To open dialog boxes in your Excel add-in, use the Dialog API.

DialogfeldDialog box

Add-in-Dialogfeld in Excel

Weitere Informationen über die Dialogfelder und die Dialogfeld-API finden Sie unter Dialogfelder in Office-Add-Ins und Verwenden der Dialogfeld-API in Ihren Office-Add-Ins.For more information about dialog boxes and the Dialog API, see Dialog boxes in Office Add-ins and Use the Dialog API in your Office Add-ins.

Inhalts-Add-InsContent add-ins

Inhalts-Add-Ins sind Flächen, die Sie direkt in Excel-Dokumente einbetten können. Mit Inhalts-Add-Ins können Sie umfangreiche, webbasierte Objekte, wie z. B. Diagramme, Datenvisualisierungen oder Medien in ein Arbeitsblatt einbetten oder Benutzern Zugriff auf die Benutzeroberflächen-Schnittstellen ermöglichen, die Code zum Ändern des Excel-Dokuments ändern oder der Anzeigedaten aus einer Datenquelle ausführen. Verwenden Sie Inhalts-Add-Ins, wenn Sie Funktionalität direkt in das Dokument einbetten möchten.Content add-ins are surfaces that you can embed directly into Excel documents. You can use content add-ins to embed rich, web-based objects such as charts, data visualizations, or media into a worksheet or to give users access to interface controls that run code to modify the Excel document or display data from a data source. Use content add-ins when you want to embed functionality directly into the document.

Inhalts-Add-InContent add-in

Excel-Inhalts-Add-In

Weitere Informationen zu Inhaltes-Add-Ins finden Sie unter Inhalts-Add-Ins in Office. Ein Beispiel, in dem ein Inhalts-Add-In implementiert wird, finden Sie unter Excel Content Add-in Humongous Insurance auf GitHub.For more information about content add-ins, see Content Office Add-ins. For a sample that implements a content add-in in Excel, see Excel Content Add-in Humongous Insurance in GitHub.

JavaScript-APIs für die Interaktion mit ArbeitsmappeninhaltenJavaScript APIs to interact with workbook content

Ein Excel-Add-in interagiert mit Objekten in Excel mithilfe der JavaScript-API für Office, die zwei Modelle von JavaScript-Objekt enthält:An Excel add-in interacts with objects in Excel by using the JavaScript API for Office, which includes two JavaScript object models:

  • Excel-JavaScript-API: Die mit Office 2016 eingeführte Excel- JavaScript-API bietet stark typisierte Excel-Objekte, die Sie verwenden können, um auf Arbeitsblätter, Bereiche, Tabellen, Diagramme und mehr zugreifen.Excel JavaScript API: Introduced with Office 2016, the Excel JavaScript API provides strongly-typed Excel objects that you can use to access worksheets, ranges, tables, charts, and more.

  • Allgemeine API: Die mit Office 2013 eingeführte allgemeine API ermöglicht es Ihnen, auf Funktionen wie z. B. Benutzeroberflächen, Dialoge und Client-Einstellungen zuzugreifen, die in mehreren Host-Anwendungen wie Word, Excel und PowerPoint enthalten sind.Common API: Introduced with Office 2013, the Common API enables you to access features such as UI, dialogs, and client settings that are common across multiple types of host applications such as Word, Excel, and PowerPoint. Daran, dass die allgemeine API eingeschränkte Funktionen für die Interaktion mit Excel bereitstellt, können Sie es verwenden, wenn das Add-in auf Excel 2013 ausgeführt werden muss.Because the Common API does provide limited functionality for Excel interaction, you can use it if your add-in needs to run on Excel 2013.

Nächste SchritteNext steps

Beginnen Sie, indem Sie Ihr erstes Excel-Add-In erstellen.Get started by creating your first Excel add-in. Erfahren Sie im nächsten Schritt mehr über die zentralen Konzepte des Erstellens von Excel-Add-Ins.Then, learn about the core concepts of building Excel add-ins.

Siehe auchSee also