Créer des projets de complément Office avec teams Toolkit

  • Article

Le kit de ressources Teams est un outil principal pour le développement d’applications Teams. Vous pouvez créer des compléments Office avec teams Toolkit, avec les restrictions suivantes.

  • Les compléments créés avec teams Toolkit utilisent le manifeste unifié pour Microsoft 365.

  • Seuls les compléments Outlook peuvent être créés pour l’instant. Nous travaillons d’arrache-pied pour activer la prise en charge dans teams Toolkit pour les compléments vers d’autres applications et plateformes Office.

    Remarque

    Les compléments Office qui utilisent le manifeste unifié pour Microsoft 365 sont directement pris en charge dans Office sur le web, dans la nouvelle version d’Outlook sur Windows et dans Office sur Windows connecté à un abonnement Microsoft 365, version 2304 (build 16320.00000) ou ultérieure.

    Lorsque le package d’application qui contient le manifeste unifié est déployé dans AppSource ou dans le Centre d’administration Microsoft 365 , si le manifeste a une propriété « alternateIcons » valide, un manifeste de complément uniquement est généré à partir du manifeste unifié et stocké. Ce manifeste de complément uniquement permet d’installer le complément sur les plateformes qui ne prennent pas directement en charge le manifeste unifié, notamment Office sur Mac, Office sur mobile, les versions d’abonnement d’Office sur Windows antérieures à 2304 (build 16320.00000) et les versions perpétuelles d’Office sur Windows.

Installez la dernière version de Teams Toolkit dans Visual Studio Code, comme décrit dans Installer teams Toolkit.

Créer un projet de complément Outlook

  1. Ouvrez Visual Studio Code et sélectionnez l’icône Teams Toolkit dans la barre d’activité.

    Icône du Kit de ressources Teams.

  2. Sélectionnez Créer une application.

  3. Dans la liste déroulante Nouveau projet , sélectionnez Complément Outlook.

    Les quatre options de la liste déroulante Nouveau projet. La quatrième option est appelée « Complément Outlook ».

  4. Dans la liste déroulante Fonctionnalités de l’application à l’aide d’un complément Outlook , sélectionnez Volet tâches.

    Les deux options de la liste déroulante Fonctionnalités de l’application à l’aide d’un complément Outlook. La première option « Taskpane » est sélectionnée.

  5. Dans la boîte de dialogue Dossier de l’espace de travail qui s’ouvre, sélectionnez le dossier dans lequel vous souhaitez créer le projet.

  6. Donnez un nom au projet (sans espace) lorsque vous y êtes invité. Teams Toolkit crée le projet avec des fichiers de base et une structure automatique. Il ouvre ensuite le projet dans une deuxième fenêtre Visual Studio Code. Fermez la fenêtre Visual Studio Code d’origine.

  7. Dans le terminal Visual Studio Code, accédez à la racine du projet et exécutez npm install.

  8. Avant d’apporter des modifications au projet, vérifiez que vous pouvez charger une version test de votre complément Outlook à partir de Visual Studio Code. Procédez comme suit :

    1. Assurez-vous que votre compte dans votre location de développeur Microsoft 365 est également un compte de messagerie dans outlook de bureau. Si ce n’est pas le cas, suivez les instructions fournies dans Ajouter un compte de messagerie à Outlook.
    2. Fermez le Bureau Outlook.
    3. Dans Visual Studio Code, ouvrez Teams Toolkit.
    4. Dans la section COMPTES , vérifiez que vous êtes connecté à Microsoft 365.
    5. Sélectionnez Afficher | l’exécution dans Visual Studio Code. Dans le menu déroulant EXÉCUTER ET DÉBOGUER , sélectionnez l’option Bureau Outlook (Edge Chromium), puis appuyez sur F5. Le projet est généré et une fenêtre Node dev-server s’ouvre. Ce processus peut prendre quelques minutes. Finalement, le bureau Outlook s’ouvre.
    6. Ouvrez la boîte de réceptionde votre identité de compte Microsoft 365 et ouvrez un message. Un onglet Complément Contoso avec deux boutons s’affiche dans le ruban Accueil (ou le ruban Message , si vous avez ouvert le message dans sa propre fenêtre).
    7. Cliquez sur le bouton Afficher le volet Office et un volet Office s’ouvre. Cliquez sur le bouton Effectuer une action et une petite notification s’affiche en haut du message.
    8. Pour arrêter le débogage et désinstaller le complément, sélectionnez Exécuter | Arrêter le débogage dans Visual Studio Code.

Vous pouvez maintenant modifier et développer le projet. Dans les emplacements où les instructions fournies dans la documentation des compléments Office se branchent en fonction du type de manifeste utilisé, veillez à suivre les instructions relatives au manifeste unifié.