Commandes de complément pour Excel, Word et PowerPoint (Aperçu)

Office and SharePoint Add-ins

La dernière version de ce complément Office est disponible dans le référentiel GitHub des compléments.


Utilisez des commandes de complément dans votre complément pour étendre l’interface utilisateur d’Office par défaut dans Excel, Word et PowerPoint.

S’applique à :apps for Office | Excel 2016 | Office Add-ins | PowerPoint | Word 2016

Les commandes de complément sont des éléments qui étendent l’interface utilisateur d’Office par défaut et qui lancent des actions dans votre complément. Vous pouvez ajouter un bouton sur le ruban ou un élément à un menu contextuel. 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 de complément dans un volet de tâches. Les commandes de complément permettent aux utilisateurs de trouver et d’utiliser votre complément, ce qui contribue à augmenter l’adoption et la réutilisation de votre complément, ainsi qu’à améliorer la fidélisation des clients.

Vous pouvez utiliser les commandes de complément pour :

  • ajouter des boutons ou une liste déroulante de boutons au ruban ;

  • ajouter des options de menu individuelles, avec éventuellement un sous-menu, au menu contextuel ;

  • afficher votre complément, qui affiche une interface utilisateur pour interaction ;

  • exécuter du code JavaScript, ce qui se fait normalement sans afficher d’interface utilisateur ;

  • rendre vos compléments plus faciles à trouver en fournissant plusieurs emplacements permettant aux utilisateurs d’ouvrir votre complément. Vous pouvez démarrer votre complément à partir de boutons ou de menus contextuels, ou encore en utilisant Insertion > Mes compléments ;

  • ouvrir différentes pages dans votre complément. Avant, lorsqu'un complément était ouvert, il démarrait toujours sur la même page. Pour effectuer la transition vers d'autres pages de votre complément, le code devait gérer les transitions de l'interface utilisateur. Avec les commandes de complément, vous pouvez ouvrir n'importe quelle page dans votre complément.

  • afficher plusieurs complément de volet Office en même temps dans Excel 2016 ou Word 2016.

Pour obtenir une vue d'ensemble des commandes de complément dans Excel et Word, reportez-vous à la vidéo relatives aux commandes de complément du ruban Office (version préliminaire publique).

Prise en main des commandes de complément

  1. Téléchargez l’exemple de commandes du complément Office.

  2. Créez votre commande de complément en mettant à jour votre manifeste comme décrit dans Création de commandes de complément dans votre manifeste pour Excel, Word et PowerPoint (Aperçu). Pour plus d’informations pratiques, voir Meilleures pratiques en matière de développement de compléments Office.

Une fois que vous avez mis à jour le fichier manifeste, installez votre complément et testez vos commandes de complément. Vous pouvez tester vos commandes de complément dans :

  • Excel Online

  • Office sur un bureau Windows

Installer votre complément sur Excel Online

  1. Ouvrez Microsoft Office Online.

  2. Dans Commencer à utiliser les applications en ligne maintenant, sélectionnez Excel > Nouveau classeur vierge > Insertion.

  3. Dans Compléments, sélectionnez Compléments Office.

  4. Sur Compléments Office, sélectionnez Télécharger mon complément > Plus (...).

  5. Sélectionnez le fichier manifeste sur votre ordinateur, puis choisissez Télécharger le complément.

  6. Vérifiez que vos commandes de complément apparaissent dans le ruban ou le menu contextuel.

Problèmes connus des commandes de complément dans Excel Online

  • Lorsque vous fermez Excel Online, le complément et les commandes de complément se ferment aussi. Lorsque vous ouvrez ensuite un document dans Excel Online, vous devez effectuer à nouveau les étapes de la section Installer votre complément sur Excel Online.

  • Pour utiliser vos commandes de complément dans votre complément, téléchargez votre complément avec Insertion > OfficeCompléments > Télécharger mon complément. Les compléments soumis sur l’Office Store ou dans un catalogue de compléments d’une organisation interne dans SharePoint n’affichent pas les commandes de complément.

  • Seul Excel Online prend en charge les commandes de complément. La prise en charge par Word Online et PowerPoint Online sera ajoutée à l'avenir.

  • Si vous sélectionnez INSERTION > OfficeCompléments > MON ORGANISATION et que vous êtes redirigé vers l’Office Store, essayez de vous connecter à Excel Online. Ensuite, sélectionnez à nouveau MON ORGANISATION.

  • Si le volet de tâches ne se met pas à jour après que vous avez sélectionné d'autres commandes de complément, essayez d'actualiser la page dans votre navigateur.

Installer le complément sur Excel 2016 ou Word 2016 sur un bureau Windows

Avant d’installer votre complément, vérifiez que vous exécutez Excel 2016 ou Word 2016, version 16.0.6326, au minimum.

  1. Ouvrez Excel 2016 > Nouveau classeur > Fichier > Compte.

  2. Dans les mises à jour d’Office, assurez-vous que le numéro de version est au moins 16.0.6326.

Pour obtenir la dernière version d'Office qui inclut des fonctionnalités de développeur pour les versions préliminaires, effectuez l'une des opérations suivantes, selon votre abonnement :

  • Si vous êtes abonné à Office 365 Famille, Office 365 Personnel ou Office 365 Université, installez le build Office Insider.

    ou

  • Si vous disposez d’un abonnement commercial à Office 365, optez pour First Release, puis suivez les étapes ci-dessous.

  1. Téléchargez et exécutez l'outil de déploiement Office 2016.

  2. Remplacez configuration.xml par le fichier de configuration First Release.

  3. Ouvrez une invite de commande avec des privilèges élevés (Exécuter en tant qu'administrateur), puis exécutez la commande ci-dessous.

    setup.exe /configuration configuration.xml
    
  4. Vérifiez que le numéro de version d’Office est 16.0.6326.0000 ou ultérieur pour Excel ou Word, et 16.0.6568.2025 ou ultérieur pour PowerPoint.

Avant d'effectuer les étapes suivantes, assurez-vous que l'exécution de votre complément ne génère pas d'erreur. Par exemple, lorsque vous utilisez Visual Studio, appuyez sur F5 pour vérifier que votre complément ne génère pas d'erreur lorsqu'il est exécuté. Si votre complément génère des erreurs après que vous avez effectué les étapes suivantes, vous serez en mesure d'identifier la source de l'erreur plus facilement.

Installation de votre complément sur Office sur un bureau Windows

  1. Téléchargez et exécutez la clé de Registre à partir des exemples de commandes du complément Office pour activer les commandes de complément dans Office.

  2. Publiez le fichier manifeste de votre complément sur un partage de fichiers réseau. Pour plus d’informations, voir Création d’un catalogue de dossiers partagés réseau pour les compléments de contenu ou du volet Office.

  3. Fermez et rouvrez l'application hôte Office (Excel 2016 ou Word 2016).

  4. Sélectionnez Insertion > Mes compléments > DOSSIER PARTAGÉ.

  5. Choisissez votre complément, puis sélectionnez OK.

  6. Vérifiez que vos commandes de complément s'affichent dans Office. Si vos commandes de complément ne s'affichent pas sur l'interface utilisateur Office, sélectionnez Insertion > Mes compléments > Actualiser.

Problèmes connus avec les commandes de complément dans Office sur un bureau Windows

  • Si vous utilisez une version de type « Démarrer en un clic » d’Office, comme Office 365 ProPlus, assurez-vous que les mises à jour sont terminées avant d’installer votre complément.

  • Les commandes de complément sont prises en charge uniquement dans Excel 2016, Word 2016 et PowerPoint 2016.

  • Les compléments soumis sur l’Office Store ou dans un catalogue de compléments d’une organisation interne dans SharePoint n’affichent pas les commandes de complément. Vous pouvez uniquement charger votre fichier manifeste à partir du partage de fichiers.

  • Les mises à jour des commandes du complément ne s'affichent pas dans Office tant que vous n'actualisez pas la page. Si l'une des situations suivantes se présente, sélectionnez Insertion > Mes compléments > Actualiser :

    • Vous voulez supprimer du ruban des boutons en double ou qui ne fonctionnent pas. Vous pouvez également essayer de vider le cache en supprimant tous les fichiers contenus dans %LOCALAPPDATA%\Microsoft\Office\16.0\Wef\AppCommands, puis sélectionner Insertion > Mes compléments > Actualiser.

    • Votre complément de volet Office ne se charge pas.

    • Vous devez mettre à jour vos commandes de complément. Vous devrez peut-être actualiser deux fois vos commandes de complément pour qu'elles apparaissent sur le ruban.

  • Si vous souhaitez modifier les fichiers d’icône après l’installation de votre complément, vous pouvez effectuer l’une des opérations suivantes :

    • Accéder à %LOCALAPPDATA%\Microsoft\Office\16.0\Wef\icons et supprimer tous les fichiers de ce dossier.

      ou

    • Modifier le nom de fichier de licône dans l'élément<Resources>du manifeste et republier le complément.

  • Les commandes de complément sont toujours disponibles dans l’interface utilisateur Office, même si aucun document n’est affiché.

Afficher: