Créer votre premier complément du volet des tâches de Word

S’applique à : Word 2016 ou version ultérieure sur Windows, et Word sur iPad et Mac

Cet article décrit comment créer un complément du volet des tâches de Word.

Créer le complément

Vous pouvez créer un complément Office à l’aide du générateur Yeoman pour les compléments Office ou de Visual Studio. Le générateur Yeoman crée un projet Node.js qui peut être géré avec du Visual Studio Code ou n’importe quel autre éditeur, alors que Visual Studio crée une solution Visual Studio. Sélectionnez l’onglet correspondant à votre choix, puis suivez les instructions de création de votre complément et testez-le localement.

Conseil

Pour utiliser le générateur d’Yeoman pour créer un complément qui utilise l’authentification unique (SSO), consultez les instructions de la section Démarrage rapide de l’authentification unique (SSO).

Conditions préalables

Notes

Si vous n’êtes pas familiarisé avec les nœuds.js ou npm, vous devez commencer par configuration de votre environnement de développement.

  • Node.js (la dernière version LTS)

  • La dernière version deYeoman et du Générateur Yeoman Générateur de compléments Office. Pour installer ces outils globalement, exécutez la commande suivante via l’invite de commande.

    npm install -g yo generator-office
    

    Notes

    Même si vous avez déjà installé le générateur Yeoman, nous vous recommandons de mettre à jour votre package vers la dernière version via npm.

Création du projet de complément

Exécutez la commande suivante pour créer un projet de complément à l’aide du générateur Yeoman.

yo office

Notes

Lorsque vous exécutez la commande yo office, il est possible que vous receviez des messages d’invite sur les règles de collecte de données de Yeoman et les outils CLI de complément Office. Utilisez les informations fournies pour répondre aux invites comme vous l’entendez.

Lorsque vous y êtes invité, fournissez les informations suivantes pour créer votre projet de complément.

  • Sélectionnez un type de projet : Office Add-in Task Pane project
  • Sélectionnez un type de script : Javascript
  • Comment souhaitez-vous nommer votre complément ? My Office Add-in
  • Quelle application client Office voulez-vous prendre en charge ? Word

Capture d'écran montrant les invites et les réponses pour le générateur Yeoman dans une interface de ligne de commande.

Après avoir exécuté l’assistant, le générateur crée le projet et installe les composants Node de prise en charge.

Conseil

Vous pouvez ignorer les instructions suivantes fournies par le générateur Yeoman une fois que le complément a été créé. Les instructions détaillées de cet article fournissent tous les conseils nécessaires à l’exécution de ce didacticiel.

Explorer le projet

Le projet de complément que vous avez créé avec le générateur Yeoman contient un exemple de code pour un complément de volet Office de base. Pour explorer les composants de votre projet de complément, ouvrez le projet dans votre éditeur de code et passez en revue les fichiers répertoriés ci-dessous. Lorsque vous êtes prêt à tester votre complément, passez à la section suivante.

  • Le fichier ./manifest.xml du répertoire racine du projet définit les paramètres et fonctionnalités du complément. Pour en savoir plus sur le fichier manifest.xml, consultez manifeste XML des compléments Office.
  • Le fichier ./src/taskpane/taskpane.html contient les balises HTML du volet Office.
  • Le fichier ./src/taskpane/taskpane.css contient le style CSS appliqué au contenu du volet Office.
  • Le fichier ./src/taskpane/taskpane.js contient le code d’API JavaScript pour Office qui facilite l’interaction entre le volet des tâches et l’application cliente Office.

Essayez

  1. Accédez au dossier racine du projet.

    cd "My Office Add-in"
    
  2. Pour démarrer le serveur web local et charger indépendamment votre complément, procédez comme suit.

    Notes

    Les compléments Office doivent utiliser le protocole HTTPS, et non HTTP, même lorsque vous développez. Si vous êtes invité à installer un certificat après avoir exécuté une des commandes suivantes, acceptez d’installer le certificat fourni par le générateur Yeoman.

    Conseil

    Si vous testez votre complément sur Mac, exécutez la commande suivante avant de continuer. Lorsque vous exécutez cette commande, le serveur web local démarre.

    npm run dev-server
    
    • Pour tester votre complément dans Word, exécutez la commande suivante dans le répertoire racine de votre projet. Cela a pour effet de démarrer le serveur web local (s’il n’est pas déjà en cours d’exécution) et d’ouvrir Word avec votre complément chargé.

      npm start
      
    • Pour tester votre complément dans Word sur un navigateur, exécutez la commande suivante dans le répertoire racine de votre projet. Lorsque vous exécutez cette commande, le serveur web local démarre (s’il n’est pas déjà en cours d’exécution).

      npm run start:web
      

      Pour utiliser votre complément, ouvrez un nouveau document dans Word sur le web, puis chargez la version test de votre complément en suivant les instructions de l’article relatif au chargement de version test des compléments Office dans Office sur le web.

  3. Dans Word, ouvrez un nouveau document, sélectionnez l’onglet Accueil, puis choisissez le bouton Afficher le volet des tâches du ruban pour ouvrir le volet des tâches du complément.

    Capture d’écran de l’application Word avec le bouton Afficher le volet Office mis en évidence.

  4. En bas du volet Office, sélectionnez le lien Exécuter pour ajouter le texte en police de couleur bleue « Hello World » au document.

    Capture d’écran de l’application Word avec le complément du volet des tâches chargé.

Étapes suivantes

Félicitations, vous avez créé un complément du volet des tâches de Word ! Maintenant, découvrez les fonctionnalités d’un complément Word et créez un complément plus complexe en suivant le didacticiel dédié.

Voir aussi