Présentation des compléments Excel
Un complément Excel vous permet d’étendre les fonctionnalités de l’application Excel sur plusieurs plateformes, notamment Windows, Mac, iPad et dans un navigateur. Utilisez les compléments Excel dans un classeur pour :
- Interagir avec des objets Excel, lire et écrire des données Excel
- Étendre les fonctionnalités à l’aide du volet Office web ou du volet de contenu
- Ajouter des boutons personnalisés au ruban ou des éléments au menu contextuel
- Ajouter des fonctions personnalisées
- Fournir une interaction améliorée à l’aide de la fenêtre de dialogue
La plateforme de compléments Office fournit la structure et les API JavaScript Office.js qui vous permettent de créer et d’exécuter des compléments Excel. En utilisant la plateforme de compléments Office pour créer votre complément Excel, vous bénéficierez des avantages suivants.
- Prise en charge sur plusieurs plateformes : les compléments Excel s’exécutent sur Office sur le web, Windows, Mac et iPad.
- Déploiement centralisé : les administrateurs peuvent rapidement et facilement déployer des compléments Excel vers les utilisateurs d’une organisation.
- Utilisation de technologies web standard : créez votre complément Excel en utilisant des technologies web connues telles qu’HTML, CSS et JavaScript.
- Distribution via AppSource : partagez votre complément Excel avec un large public en le publiant sur AppSource.
Notes
Les compléments Excel sont différents des compléments COM et VSTO, qui sont des solutions d’intégration Office antérieures qui s’exécutent uniquement dans Office sur Windows. Contrairement aux compléments COM, les compléments Excel ne nécessitent pas l’installation de code sur l’appareil d’un utilisateur ou dans Excel.
Composants d’un complément Excel
Un complément Excel comprend deux composants de base : une application web et un fichier de configuration, appelé fichier manifeste.
L’application web utilise l’API JavaScript Office pour interagir avec les objets dans Excel et peut également faciliter l’interaction avec les ressources en ligne. Par exemple, un complément peut effectuer l’une des tâches suivantes.
- Créer, lire, mettre à jour et supprimer des données dans le classeur (feuilles de calcul, plages, tableaux, graphiques, éléments nommés, etc.).
- Effectuer une autorisation utilisateur avec un service en ligne à l’aide du flux OAuth 2.0 standard.
- Émettre des demandes d’API à Microsoft Graph ou toute autre API.
L’application web peut être hébergée sur un serveur web et peut être créée à l’aide de structures de côté client (par exemple, Angular, React, jQuery) ou des technologies côté serveur (par exemple, ASP.NET, Node.js, PHP).
Le manifeste est un fichier de configuration qui définit la façon dont le complément s’intègre aux clients Office en spécifiant des paramètres et des 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.
- La manière dont le complément est intégré à Excel, y compris toute interface utilisateur personnalisée créée par le complément (boutons du ruban, menus contextuels, etc.).
- Les autorisations requises par le complément, comme la lecture du document ou l’écriture dans celui-ci.
Pour permettre aux utilisateurs finals d’installer et d’utiliser un complément Excel, publiez son manifeste dans AppSource ou dans un catalogue de compléments. Pour plus de détails sur la publication dans AppSource, reportez-vous à la rubrique Mise à disposition de vos solutions dans AppSource et dans Office.
Fonctionnalités d’un complément Excel
En plus d’interagir avec le contenu du classeur, les compléments Excel peuvent ajouter des boutons personnalisés au ruban ou des commandes de menu, insérer des volets Office, ajouter des fonctions personnalisées, ouvrir des boîtes de dialogue et même incorporer des objets web enrichis, tels que des graphiques ou des visualisations interactives dans une feuille de calcul.
Commandes de complément
Les commandes de complément sont des éléments d’interface utilisateur qui étendent l’interface utilisateur d’Excel et lancent des actions dans votre complément. Vous pouvez utiliser les commandes de complément pour ajouter un bouton au ruban ou un élément à un menu contextuel dans Excel. Lorsque les utilisateurs sélectionnent une commande de complément, ils lancent des actions telles que l’exécution de code JavaScript ou l’affichage d’une page du complément dans un volet Office.
Pour plus d’informations sur les fonctionnalités des commandes, les plateformes prises en charge et les bonnes pratiques pour le développement de commandes, reportez-vous à la rubrique Commandes de complément pour Excel, Word et PowerPoint.
Volets Office
Les volets des tâches sont des surfaces d’interface qui s’affichent généralement sur le côté droit de la fenêtre dans Excel. Les volets Office permettent aux utilisateurs d’accéder à des contrôles d’interface qui exécutent du code pour modifier le document Excel ou afficher les données d’une source de données.
Pour plus d’informations sur les volets Office, reportez-vous à Volets Office dans les compléments Office. Pour consulter un exemple qui implémente un volet Office dans Excel, reportez-vous à Excel Add-in JS WoodGrove Expense Trends.
Fonctions personnalisées
Les fonctions personnalisées permettent aux développeurs d’ajouter de nouvelles fonctions dans Excel en définissant ces fonctions dans JavaScript dans le cadre d’un complément. Les utilisateurs d’Excel peuvent accéder aux fonctions personnalisées comme ils le feraient pour n’importe quelle fonction native d’Excel, telle que SUM().
Pour plus d’informations sur les fonctions personnalisées, voir Créer des fonctions personnalisées dans Excel.
Boîtes de dialogue
Les boîtes de dialogue sont des surfaces qui flottent au-dessus de la fenêtre active de l’application Excel. Vous pouvez utiliser les boîtes de dialogue pour des tâches comme l’affichage de pages de connexion impossibles à ouvrir directement dans un volet Office, les demandes de confirmation d’une action par l’utilisateur ou l’hébergement de vidéos pouvant être trop petites si elles sont limitées à un volet Office. Utilisez l’API de dialogue pour ouvrir des boîtes de dialogue dans votre complément Excel.
Pour plus d’informations sur les boîtes de dialogue et l’API de dialogue, consultez Utilisez l’API de boîte de dialogue dans vos compléments Office.
Compléments de contenu
Les compléments de contenu sont des surfaces que vous pouvez incorporer directement dans les documents Excel. Vous pouvez utiliser des compléments de contenu pour incorporer des objets riches, basés sur le web, tels que des graphiques, des visualisations de données ou des supports dans une feuille de calcul, ou autoriser l’accès des utilisateurs aux options d’interface qui exécutent le code pour modifier le document Excel ou afficher des données à partir d’une source de données. Utilisez les compléments de contenu lorsque vous souhaitez incorporer des fonctionnalités directement dans le document.
Pour plus d’informations sur les compléments de contenu, reportez-vous à Compléments Office de contenu. Pour consulter un exemple qui implémente un complément de contenu dans Excel, reportez-vous à Excel Content Add-in Humongous Insurance dans GitHub.
API JavaScript permettant d’interagir avec 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.
Étapes suivantes
Apprenez à créer votre premier complément Excel. Découvrez ensuite les concepts fondamentaux de la création de compléments Excel.