Vue d’ensemble de la plateforme de compléments pour OfficeOffice Add-ins platform overview

La plateforme des compléments Office permet de créer des solutions qui étendent des applications Office et interagissent avec du contenu dans des documents Office. Les compléments Office vous permettent d’utiliser des technologies web que vous connaissez, telles que le code HTML, CSS et JavaScript, pour étendre Word, Excel, PowerPoint, OneNote, Project et Outlook, et interagir avec ces programmes. Votre solution peut être exécutée dans Office sur plusieurs plateformes, notamment Office pour Windows, Office Online, Office pour Mac et Office pour iPad.You can use the Office Add-ins platform to build solutions that extend Office applications and interact with content in Office documents. With Office Add-ins, you can use familiar web technologies such as HTML, CSS, and JavaScript to extend and interact with Word, Excel, PowerPoint, OneNote, Project, and Outlook. Your solution can run in Office across multiple platforms, including Office for Windows, Office Online, Office for the Mac, and Office for the iPad.

Les compléments Office offrent presque les mêmes possibilités qu’une page web dans un navigateur. Vous pouvez utiliser la plateforme des compléments Office pour :Office Add-ins can do almost anything a webpage can do inside a browser. Use the Office Add-ins platform to:

  • Ajout de nouvelles fonctionnalités à des clients Office : vous pouvez importer des données externes dans Office, automatiser des documents Office, exposer des fonctionnalités tierces dans des clients Office et bien plus encore. Par exemple, vous pouvez utiliser l’API Microsoft Graph pour établir une connexion vers des données qui améliorent la productivité.Add new functionality to Office clients - Bring external data into Office, automate Office documents, expose third-party functionality in Office clients, and more. For example, use Microsoft Graph API to connect to data that drives productivity.

  • Créer de nouveaux objets interactifs et enrichis qui peuvent être incorporés dans des documents Office : vous pouvez incorporer des cartes, des graphiques et des visualisations interactives que les utilisateurs peuvent ajouter à leurs feuilles de calcul Excel et présentations PowerPoint.Create new rich, interactive objects that can be embedded in Office documents - Embed maps, charts, and interactive visualizations that users can add to their own Excel spreadsheets and PowerPoint presentations.

En quoi les compléments Office sont-ils différents des compléments COM et VSTO ?How are Office Add-ins different than COM and VSTO add-ins?

Les compléments COM ou VSTO sont des solutions d’intégration à Office antérieures qui s’exécutent uniquement sur Office pour Windows. Contrairement aux compléments COM, les compléments Office n’incluent pas de code exécuté sur l’appareil de l’utilisateur ou sur le client Office. Pour un complément Office, l’application hôte, par exemple Excel, lit le manifeste du complément et insère les commandes de menu et les boutons de ruban personnalisés du complément dans l’interface utilisateur. Lorsque cela est nécessaire, elle charge le code JavaScript et HTML du complément, qui est exécuté dans le contexte d’un navigateur dans un bac à sable (sandbox).COM or VSTO add-ins are earlier Office integration solutions that run only on Office for Windows. Unlike COM add-ins, Office Add-ins don't involve code that runs on the user's device or in the Office client. For an Office Add-in, the host application, for example Excel, reads the add-in manifest and hooks up the add-in’s custom ribbon buttons and menu commands in the UI. When needed, it loads the add-in's JavaScript and HTML code, which executes in the context of a browser in a sandbox.

Les compléments Office offrent les avantages suivants par rapport aux compléments créés à l’aide de VBA, COM ou VSTO :Office Add-ins provide the following advantages over add-ins built using VBA, COM, or VSTO:

  • Prise en charge sur plusieurs plateformes. Les compléments Office s’exécutent dans Office pour Windows, Mac, iOS et Office Online.Cross-platform support. Office Add-ins run in Office for Windows, Mac, iOS, and Office Online.

  • Déploiement et distribution centralisés. Les administrateurs peuvent déployer des compléments Office de façon centralisée dans une organisation.Centralized deployment and distribution. Admins can deploy Office Add-ins centrally across an organization.

  • Accès facile via AppSource. Vous pouvez mettre votre solution à disposition d’un large public en l’envoyant à AppSource.Easy access via AppSource. You can make your solution available to a broad audience by submitting it to AppSource.

  • S’appuie sur des technologies web standard. Vous pouvez utiliser n’importe quelle bibliothèque pour créer des compléments Office.Based on standard web technology. You can use any library you like to build Office Add-ins.

Composants d’un complément OfficeComponents of an Office Add-in

Un complément Office inclut deux composants de base : un fichier manifeste XML et votre propre application web. Le manifeste définit différents paramètres, y compris la façon dont votre complément s’intègre avec les clients Office. Votre application web doit être hébergée sur un serveur web ou un service d’hébergement web, tel que Microsoft Azure.An Office Add-in includes two basic components: an XML manifest file, and your own web application. The manifest defines various settings, including how your add-in integrates with Office clients. Your web application needs to be hosted on a web server, or web hosting service, such as Microsoft Azure.

Figure 1. Manifeste de complément (XML) + page web (HTML, JS) = un complément OfficeFigure 1. Add-in manifest (XML) + webpage (HTML, JS) = an Office Add-in

Manifeste + page web = complément Office

ManifesteManifest

Le manifeste est un fichier XML qui spécifie les paramètres et les fonctionnalités du complément, notamment :The manifest is an XML file that specifies settings and capabilities of the add-in, such as:

  • Le nom d’affichage, la description, l’ID, la version et les paramètres régionaux par défaut du complément.The add-in's display name, description, ID, version, and default locale.

  • La façon dont le complément s’intègre à Office.How the add-in integrates with Office.

  • Le niveau d’autorisation et les conditions d’accès aux données pour le complément.The permission level and data access requirements for the add-in.

Application webWeb app

Le complément Office le plus simple est composé d’une page HTML statique qui est affichée dans une application Office, mais qui n’interagit pas avec le document Office ou une autre ressource Internet. Toutefois, pour créer un complément qui interagit avec des documents Office ou permet à l’utilisateur d’interagir avec les ressources en ligne à partir d’une application hôte Office, vous pouvez utiliser n’importe quelle technologie, aussi bien côté client que serveur, prise en charge par votre fournisseur d’hébergement (par exemple, ASP.NET, PHP ou Node.js). Pour interagir avec des clients et des documents Office, vous pouvez utiliser les API JavaScript Office.js.The most basic Office Add-in consists of a static HTML page that is displayed inside an Office application, but that doesn't interact with either the Office document or any other Internet resource. However, to create an experience that interacts with Office documents or allows the user to interact with online resources from an Office host application, you can use any technologies, both client and server side, that your hosting provider supports (such as ASP.NET, PHP, or Node.js). To interact with Office clients and documents, you use the Office.js JavaScript APIs.

Figure 2. Composants d’un complément Office Hello WorldFigure 2. Components of a Hello World Office Add-in

Composants d’un complément Hello World

Extension des clients Office et interaction avec ces clientsExtending and interacting with Office clients

Les compléments Office offrent les possibilités suivantes dans une application Office hôte :Office Add-ins can do the following within an Office host application:

  • Étendre les fonctionnalités (toutes les applications Office)Extend functionality (any Office application)

  • Créer de nouveaux objets (Excel ou PowerPoint)Create new objects (Excel or PowerPoint)

Étendre les fonctionnalités d’OfficeExtend Office functionality

Vous pouvez ajouter de nouvelles fonctionnalités aux applications Office via les éléments d’interface suivants :You can add new functionality to Office applications via the following:

  • Commandes de menu et boutons de ruban personnalisées (collectivement appelés « commandes de complément »)Custom ribbon buttons and menu commands (collectively called “add-in commands”)

  • Volets Office à insérerInsertable task panes

Les éléments d’interface personnalisés et les volets Office sont définis dans le manifeste du complément.Custom UI and task panes are specified in the add-in manifest.

Commandes de menu et boutons personnalisésCustom buttons and menu commands

Vous pouvez ajouter des éléments de menu et des boutons de ruban personnalisé au ruban d’Office pour bureau Windows et Office Online. Les utilisateurs peuvent ainsi accéder à votre complément directement à partir de leur application Office. Les boutons de commande peuvent lancer différentes actions, par exemple afficher un volet Office comportant du contenu HTML personnalisé ou exécuter une fonction JavaScript.You can add custom ribbon buttons and menu items to the ribbon in Office for Windows Desktop and Office Online. This makes it easy for users to access your add-in directly from their Office application. Command buttons can launch different actions such as showing a task pane with custom HTML or executing a JavaScript function.

Figure 3. Commandes des compléments dans le rubanFigure 3. Add-in commands in the ribbon

Commandes de menu et boutons personnalisés

Volets OfficeTask panes

Vous pouvez utiliser des volets Office en plus des commandes de complément pour permettre aux utilisateurs d’interagir avec votre solution. Les clients qui ne prennent pas en charge les commandes de complément (Office 2013 et Office pour iPad) exécutent votre complément sous la forme d’un volet Office. Les utilisateurs lancent les compléments de volet Office via le bouton Mes compléments situé sous l’onglet Insertion.You can use task panes in addition to add-in commands to enable users to interact with your solution. Clients that do not support add-in commands (Office 2013 and Office for iPad) run your add-in as a task pane. Users launch task pane add-ins via the My Add-ins button on the Insert tab.

Figure 4. Volet OfficeFigure 4. Task pane

Utiliser les volets Office en plus des commandes de complément

Extension des fonctionnalités OutlookExtend Outlook functionality

Les compléments Outlook peuvent développer le ruban Office et s’afficher en regard d’un élément Outlook quand vous le visualisez ou le composez. Ils fonctionnent avec un message électronique, une demande de réunion, une réponse à une demande de réunion, une annulation de réunion ou un rendez-vous quand l’utilisateur visualise un élément reçu, répond à un élément ou en crée un.Outlook add-ins can extend the Office ribbon and also display contextually next to an Outlook item when you're viewing or composing it. They can work with an email message, meeting request, meeting response, meeting cancellation, or appointment when a user is viewing a received item or replying or creating a new item.

Les compléments Outlook peuvent accéder à des informations contextuelles à partir de l’élément, telles qu’une adresse ou un ID de suivi, et utiliser ces données pour accéder à d’autres informations sur le serveur ou provenant de services web pour créer des expériences utilisateur attrayantes. Dans la plupart des cas, un complément Outlook peut être exécuté sans modification sur les différentes applications hôte prise en charge, notamment Outlook, Outlook pour Mac, Outlook Web App et Outlook Web App pour appareils, afin d’offrir une expérience homogène sur le bureau, en ligne, sur les tablettes et sur les appareils mobiles.Outlook add-ins can access contextual information from the item, such as an address or tracking ID, and then use that data to access additional information on the server and from web services to create compelling user experiences. In most cases, an Outlook add-in runs without modification on the various supporting host applications, including Outlook, Outlook for Mac, Outlook Web App, and Outlook Web App for devices, to provide a seamless experience on the desktop, web, and tablet and mobile devices.

Pour accéder à une vue d’ensemble des compléments Outlook, reportez-vous à la rubrique Présentation des compléments Outlook.For an overview of Outlook add-ins, see Outlook add-ins overview.

Création d’objets dans des documents OfficeCreate new objects in Office documents

Vous pouvez incorporer des objets web, appelés compléments de contenu, dans des documents Excel et PowerPoint. Ces compléments de contenu vous permettent d’intégrer des visualisations de données web enrichies, du contenu multimédia (comme un lecteur vidéo YouTube ou une galerie d’images) et d’autres types de contenu externe.You can embed web-based objects called content add-ins within Excel and PowerPoint documents. With content add-ins, you can integrate rich, web-based data visualizations, media (such as a YouTube video player or a picture gallery), and other external content.

Figure 5. Complément de contenuFigure 5. Content add-in

Incorporer des objets web appelés compléments de contenu

API JavaScript pour OfficeOffice JavaScript APIs

Les API JavaScript Office sont composées d’objets et de membres permettant de créer des compléments et d’interagir avec le contenu Office et les services web. Il existe un modèle objet commun que se partagent Excel, Outlook, Word, PowerPoint, OneNote et Project. Il existe également des modèles objet plus complets et propres à l’hôte pour Excel et Word. Ces API permettent d’accéder à des objets connus tels que des paragraphes et des classeurs, ce qui facilite la création de complément pour un hôte spécifique.The Office JavaScript APIs contain objects and members for building add-ins and interacting with Office content and web services. There is a common object model that is shared by Excel, Outlook, Word, PowerPoint, OneNote and Project. There are also more extensive host-specific object models for Excel and Word. These APIs provide access to well-known objects such as paragraphs and workbooks, which makes it easier to create an add-in for a specific host.

Étapes suivantesNext steps

Pour plus d’informations sur la façon de commencer à créer votre complément Office, essayez nos ressources de démarrage rapide en 5 minutes.To learn more about how to start building your Office Add-in, try out our 5-minute Quickstarts. You can start building add-ins right away using Visual Studio or any other editor. Vous pouvez commencer à créer des compléments instant en utilisant Visual Studio ou tout autre éditeur.To learn more about how to start building your Office Add-in, try out our 5-minute Quickstarts. You can start building add-ins right away using Visual Studio or any other editor.

Pour commencer à concevoir des solutions offrant des expériences utilisateur efficaces et attrayantes, consultez les instructions de conception et les meilleures pratiques pour les compléments Office.To start planning solutions that create effective and compelling user experiences, get familiar with the design guidelines and best practices for Office Add-ins.

Voir aussiSee also