Guide du développeur de compléments VSTO sur les compléments web Office

  • Article

Vous avez donc créé des compléments VSTO pour les applications Office qui s’exécutent sur Windows et vous explorez maintenant la nouvelle façon d’étendre Office qui s’exécutera sur Windows, Mac et la version de navigateur web de la suite Office : Compléments web Office.

Importante

Les compléments COM et VSTO ne sont pas pris en charge dans le nouvel Outlook sur Windows actuellement en préversion. Ces compléments sont toujours pris en charge dans le client de bureau Outlook sur Windows classique. Pour en savoir plus, voir Développer des compléments Outlook pour les nouveaux outlook sur Windows (préversion).

Votre compréhension des modèles objets pour Excel, Word et les autres applications Office sera très utile, car les modèles d’objets dans les compléments web Office suivent les mêmes modèles. Il y a cependant quelques défis :

  • Vous allez utiliser un autre langage (JavaScript ou TypeScript) au lieu de C# ou Visual Basic .NET. (Il existe également un moyen, décrit plus loin, de réutiliser une partie de votre code existant dans un complément web.)
  • Les compléments web Office ne sont pas déployés différemment des compléments VSTO.
  • Les compléments Web Office sont des applications web qui s’exécutent dans un contrôle d’affichage web simplifié incorporé dans l’application Office. Vous devez donc acquérir une compréhension de base des applications web et de la façon dont elles sont hébergées sur des serveurs web ou des comptes cloud.

Pour ces raisons, la plupart de cet article duplique notre Guide du débutant sur les extensions Office. Nous avons ajouté des ressources d’apprentissage pour aider les développeurs de compléments VSTO à tirer parti de leur expérience et à réutiliser leur code existant.

Étape 0 : Conditions requises

  • Les compléments web Office (également appelés compléments Office) sont essentiellement des applications web incorporées dans Office. Par conséquent, vous devez d’abord avoir une compréhension de base des applications web et de la façon dont elles sont hébergées sur le web. Il existe une quantité considérable d’informations à ce sujet sur Internet, dans les livres et dans les cours en ligne. Une bonne façon de commencer si vous n’avez aucune connaissance préalable des applications web consiste à rechercher « Qu’est-ce qu’une application web ? » dans votre moteur de recherche.
  • Le langage de programmation principal que vous utiliserez pour créer des compléments Office est JavaScript ou TypeScript. Si vous n’êtes pas familiarisé avec l’un de ces langages, mais que vous avez de l’expérience avec VBA, VB.NET, C#, vous trouverez probablement TypeScript plus facile à apprendre. Là encore, il existe une multitude d’informations relatives à ces langages sur Internet, dans les livres et dans les cours en ligne.

Étape 1 : Commencer par les notions de base

Nous savons que vous êtes impatient de commencer à coder, mais il convient de lire certains points concernant les compléments Office avant d’ouvrir votre IDE ou votre éditeur de code.

  • Vue d’ensemble de la plateforme des compléments Office : découvrez les compléments web Office et leurs différences par rapport aux anciennes méthodes d’extension d’Office, telles que les compléments VSTO.
  • Développement de compléments Office : obtenez une vue d’ensemble du développement et du cycle de vie des compléments Office, y compris les outils, la création d’une interface utilisateur de complément et l’utilisation des API JavaScript pour interagir avec le document Office.

Ces articles comportent un grand nombre de liens. Toutefois, si vous effectuez une transition vers les compléments web Office, nous vous recommandons de revenir ici lorsque vous les aurez lus et de passer à la section suivante.

Étape 2 : Installer les outils et créer votre premier complément

Vous avez maintenant une vue d’ensemble, alors lancez-vous avec l’un de nos guides de démarrage rapide. Pour découvrir la plateforme, nous vous recommandons d’utiliser le guide de démarrage rapide d’Excel. Il existe une version basée sur Visual Studio et une autre basée sur Node.js et Visual Studio Code. Si vous effectuez une transition à partir de compléments VSTO, vous trouverez probablement la version de Visual Studio la plus facile à utiliser.

Étape 3 : Code

Vous ne pouvez pas apprendre à conduire en lisant le manuel du propriétaire, alors commencez à coder à l’aide de ce didacticiel Excel. Vous utiliserez la bibliothèque JavaScript pour Office et du code XML dans le manifeste du complément. Il n’est pas nécessaire de mémoriser quoi que ce soit, car vous obtiendrez plus d’informations sur ces deux éléments plus tard.

Étape 4 : Comprendre la bibliothèque JavaScript

Obtenez une vue d’ensemble de la bibliothèque JavaScript Office avec le didacticiel Comprendre les API JavaScript Office de la formation Microsoft Learn.

Ensuite, explorez les API JavaScript Office avec l’outil Script Lab, un bac à sable pour l’exécution et l’exploration des API.

Ressources spéciales pour les développeurs de compléments VSTO

Il s’agit d’un bon point de départ pour jeter un coup d’œil à l’exemple de complément, Excel JavaScript SalesTracker. Il a été créé pour mettre en évidence les similitudes et les différences entre les compléments VSTO et les compléments web Office, et le fichier Lisez-moi de l’exemple indique les points importants de comparaison.

Étape 5 : Comprendre le manifeste

Découvrez les objectifs du manifeste de complément web et une présentation de son balisage XML ou JSON dans le manifeste des compléments Office.

Étape 6 (pour les développeurs VSTO uniquement) : réutiliser votre code VSTO

Vous pouvez réutiliser une partie de votre code de complément VSTO dans un complément web Office en le déplaçant vers le serveur principal de votre application web sur le serveur et en le rendant disponible pour votre code JavaScript ou votre dactylographié comme API web. Pour obtenir des instructions, consultez Didacticiel : partage de codes entre un complément VSTO et un complément Office à l’aide d’une bibliothèque de codes partagée.

Étapes suivantes

Félicitations pour avoir terminé le parcours d’apprentissage pour les développeurs des compléments VSTO pour les compléments web Office ! Voici quelques suggestions pour approfondir les informations contenues dans notre documentation :