Créer des compléments Excel pour Excel

Utilisez un complément Excel lorsque vous souhaitez automatiser des tâches de classeur, connecter des données de classeur à des services externes, ajouter des calculs personnalisés ou guider les utilisateurs avec une expérience web dans Excel. Les compléments Excel s’exécutent dans Excel sur le Web, Windows, Mac et iPad, ce qui vous permet de créer une solution pour plusieurs plateformes.

Avec la plateforme des compléments Office et Office.js, vous pouvez :

  • Lire et écrire des données de classeur, notamment des feuilles de calcul, des plages, des tableaux, des graphiques et des éléments nommés.
  • Étendez le ruban et le menu contextuel ou ajoutez un volet Office ou un volet de contenu avec une interface utilisateur web.
  • Ajoutez des fonctions personnalisées que les utilisateurs appellent à partir de cellules de feuille de calcul.
  • Ouvrez les boîtes de dialogue pour la connexion, la confirmation et d’autres tâches ciblées.

La plateforme prend également en charge le déploiement centralisé, les technologies web standard telles que HTML, CSS et JavaScript, et la publication via la Place de marché Microsoft.

Remarque

Les compléments Excel sont différents des compléments COM et VSTO, qui s’exécutent uniquement dans Office sur Windows. Les compléments Excel ne nécessitent pas l’installation de code sur l’appareil d’un utilisateur ou dans Excel.

Commencer par les tâches de complément Excel les plus courantes

Si vous débutez avec les compléments Excel, commencez par le guide de démarrage rapide Excel. Ensuite, utilisez ces articles pour approfondir le modèle objet Excel et les scénarios de classeur courants :

Ce que vous pouvez créer avec un complément Excel

En plus d’utiliser le contenu du classeur, les compléments Excel peuvent ajouter des commandes, afficher des volets Office, définir des fonctions personnalisées, ouvrir des boîtes de dialogue et incorporer du contenu web enrichi dans une feuille de calcul.

Conseil

Certains termes de cet article ont une signification spécifique dans le contexte des compléments Office. Pour obtenir les définitions de ces termes, consultez le glossaire des compléments Office.

Commandes de complément

Les commandes de complément étendent l’interface utilisateur Excel et démarrent des actions dans votre complément. Vous pouvez ajouter un bouton au ruban ou un élément à un menu contextuel. Lorsque les utilisateurs sélectionnent une commande, ils peuvent exécuter du code JavaScript ou ouvrir une page à partir du complément dans un volet Office.

Commandes de complément dans Excel.

Pour plus d’informations sur les plateformes prises en charge et les conseils de conception, voir Commandes de complément pour Excel, Word et PowerPoint.

Volets de tâches

L’interface du volet Office s’affiche sur le côté droit de la fenêtre Excel. Il fournit aux utilisateurs des contrôles qui exécutent du code, mettent à jour le classeur ou affichent les données d’une autre source.

Complément du volet Office dans Excel.

Pour plus d’informations, voir Volets office dans les compléments Office. Pour obtenir un exemple fonctionnel, voir Complément Excel JS WoodGrove Expense Trends.

Fonctions personnalisées

Les fonctions personnalisées vous permettent de définir de nouvelles fonctions de feuille de calcul en JavaScript dans le cadre d’un complément. Les utilisateurs peuvent les appeler de la même façon qu’ils appellent des fonctions intégrées telles que SUM().

Image animée montrant un utilisateur final insérant la fonction personnalisée MYFUNCTION.SPHEREVOLUME dans une cellule d’une feuille de calcul Excel.

Pour plus d’informations, voir Créer des fonctions personnalisées dans Excel.

Boîtes de dialogue

Les boîtes de dialogue flottent au-dessus de la fenêtre Excel active. Utilisez-les pour les flux de connexion qui ne peuvent pas s’ouvrir directement dans un volet Office, pour confirmer une action ou pour héberger du contenu qui a besoin d’un espace plus ciblé. Pour ouvrir une boîte de dialogue dans votre complément, utilisez l’API Dialog.

Boîte de dialogue de complément dans Excel.

Pour plus d’informations, voir Utiliser l’API de boîte de dialogue dans vos compléments Office.

Compléments de contenu

Un complément de contenu est incorporé directement dans une feuille de calcul. Utilisez-en une lorsque vous souhaitez que les utilisateurs interagissent avec un graphique, une visualisation de données, une expérience multimédia ou tout autre contenu web dans le document lui-même.

Complément de contenu dans Excel.

Pour plus d’informations, voir Compléments Office de contenu. Pour obtenir un exemple fonctionnel, voir Complément de contenu Excel : Assurance Humongous.

Contenu d’un complément Excel

Un complément Excel comprend deux parties de base : une application web et un manifeste.

L’application web utilise l’API JavaScript Office pour travailler avec des objets dans Excel et se connecter à des ressources en ligne. Par exemple, l’application web peut :

  • Créer, lire, mettre à jour et supprimer des données de classeur.
  • Authentifiez les utilisateurs auprès d’un service en ligne à l’aide d’OAuth 2.0.
  • Envoyer des demandes à Microsoft Graph ou à une autre API web.

Vous pouvez héberger l’application web sur n’importe quel serveur web et la générer avec des infrastructures côté client telles que Angular, React ou jQuery, ou avec des technologies côté serveur telles que ASP.NET, Node.js ou PHP.

Le manifeste est un fichier de configuration qui définit la façon dont le complément s’intègre à Office. Il spécifie les paramètres et les fonctionnalités tels que :

  • L’URL de l’application web du complément.
  • Le nom d’affichage, la description, l’ID, la version et les paramètres régionaux par défaut du complément.
  • Comment le complément s’intègre à Excel, y compris l’interface utilisateur personnalisée, comme les boutons du ruban et les éléments de menu contextuel .
  • Autorisations requises par le complément, telles que la lecture ou l’écriture de données de document.

Pour mettre un complément Excel à la disposition des utilisateurs, publiez son manifeste sur la Place de marché Microsoft ou dans un catalogue de compléments. Pour plus d’informations sur la publication sur la Place de marché, voir Rendre vos solutions disponibles sur la Place de marché Microsoft et dans Office.

API JavaScript pour le contenu du classeur

Un complément Excel interagit avec des objets dans Excel en utilisant l’API Office JavaScript, qui inclut deux modèles d’objets JavaScript :

  • API JavaScript pour Excel : incluse dans Office 2016, l’API JavaScript pour Excel fournit des objets Excel fortement typés que vous pouvez utiliser pour accéder aux feuilles de calcul, aux plages, aux tableaux, aux graphiques et bien plus encore.

  • API commune : incluse dans Office 2013, l’API commune vous permet d’accéder à des fonctionnalités telles qu’une interface utilisateur, des boîtes de dialogue et des paramètres du client, qui sont communes à plusieurs types d’applications Office. Les fonctionnalités limitées pour l’interaction Excel dans l’API commune ont été remplacées par l’API JavaScript Excel.

Voir aussi