Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Script Lab est un outil gratuit qui permet à tous d’apprendre à développer des compléments Office. Script Lab vous permet de coder et d’exécuter les API JavaScript Office avec votre document dans Excel, Outlook, PowerPoint et Word. Utilisez cet outil pratique pour prototyper et vérifier les fonctionnalités souhaitées dans votre propre complément.
Regardez Script Lab en action dans cette vidéo YouTube d’une minute.
Qu’est-ce que script Lab ?
Script Lab est un complément pour le prototypage de compléments. Il utilise l’API Office JavaScript dans Excel, Outlook, PowerPoint, Word et se trouve dans un volet des tâches à l’intérieur de votre document, feuille de calcul ou e-mail. Il dispose d’un éditeur de code compatible IntelliSense, construit sur la même infrastructure utilisée par Visual Studio Code. Grâce à Script Lab, vous avez accès à une bibliothèque d’exemples. Essayez rapidement des fonctionnalités ou utilisez ces exemples comme point de départ pour votre propre code. Vous pouvez même essayer les API à venir dans Script Lab qui sont encore en préversion.
Remarque
Script Lab n’est pas lié aux scripts Office. Office Scripts est un outil d’automatisation pour les utilisateurs finaux dans Excel. Utilisez les scripts Office si vous souhaitez des solutions rapides et réutilisables qui ne nécessitent pas d’intégration avec des services web.
Principales fonctionnalités
Script Lab offre un certain nombre de fonctionnalités pour vous aider à prototyper des fonctionnalités de complément et à explorer l’API JavaScript Office.
Explorer des exemples
Commencez rapidement avec une collection d’exemples d’extraits de code intégrés qui montrent comment effectuer des tâches avec l’API. Exécutez les exemples pour voir instantanément le résultat dans le volet Office ou le document, examinez-les pour découvrir le fonctionnement de l’API et utilisez même des exemples pour prototyper votre propre complément.
Code et style
En plus du code JavaScript ou TypeScript qui appelle l’API Office JS, chaque extrait de code contient également une balise HTML qui définit le contenu du volet des tâches et CSS qui définit l’apparence de ce dernier. Personnalisez le balisage HTML et le CSS pour expérimenter le placement et le style des éléments lorsque vous prototypez la conception du volet Office pour votre propre complément.
API en préversion
Pour appeler des API de préversion dans un extrait de code, vous devez mettre à jour les bibliothèques de l’extrait de code pour utiliser la version bêta du réseau de distribution de contenu (CDN) (https://officeapis.public.onecdn.static.microsoft/beta/office.js) et les définitions @types/office-js-previewde type de préversion. En outre, certaines API en préversion ne sont accessibles que si vous êtes inscrit au programme Microsoft 365 Insider et que vous exécutez une version Insider d’Office.
Enregistrer et partager des extraits de code
Par défaut, les extraits de code que vous ouvrez dans Script Lab sont enregistrés dans le cache de votre navigateur ou dans le stockage local. Pour enregistrer un extrait de code de façon définitive, sélectionnez Copier et coller le contenu du presse-papiers obtenu dans un nouveau fichier .yml. Utilisez-le pour partager des extraits de code avec des collègues ou fournir du code pour des sites communautaires, tels que Stack Overflow.
Pour importer un extrait de code dans Script Lab, sélectionnez Importer dans le menu et collez le YAML complet de l’extrait de code. Si vous avez enregistré le YAML en tant que gist GitHub, vous pouvez coller un lien vers l’essentiel à la place.
Clients pris en charge
Script Lab est pris en charge pour Excel, Word et PowerPoint sur les clients suivants.
- Office sur le web
- Office pour Windows
- Office sur Mac
Script Lab pour Outlook est disponible sur les clients suivants.
- Outlook sur le web avec des navigateurs Chrome, Microsoft Edge ou Safari
- Outlook sur Windows
- Outlook sur Mac
Limitations
Script Lab est conçu pour vous permettre de jouer avec de petits exemples de code. En règle générale, un extrait de code doit comporter au maximum quelques centaines de lignes et quelques milliers de caractères.
Votre extrait de code peut utiliser des données codées en dur. Une petite quantité de données (disons quelques centaines de caractères) est OK pour le codage en dur dans Script Lab. Toutefois, pour les données plus importantes, nous vous recommandons de les stocker en externe, puis de les charger au moment de l’exécution avec une commande comme fetch.
Veillez à ce que vos extraits de code et vos données codées en dur soient petits, car le stockage de plusieurs extraits de grande taille pourrait dépasser celui de Script Lab et provoquer des problèmes lors du chargement de Script Lab.
Étapes suivantes
Une fois que vous avez prototypé votre code dans Script Lab, transformez-le en véritable complément en suivant les étapes de Créer un complément Office autonome à partir de votre code Script Lab.
Problèmes
Si vous rencontrez un problème ou si vous avez des commentaires à nous faire, faites-le nous savoir !
- Problème dans cet article ? Consultez la section « Commentaires sur les compléments Office » à la fin de cet article.
- Vous rencontrez un problème avec un exemple de code Script Lab ? Ouvrez un nouveau problème dans le référentiel GitHub office-js-snippets.
- Des commentaires ou un problème avec l’outil Script Lab ? Ouvrez un nouveau problème dans le référentiel GitHub office-js.
Voir aussi
Collaborer avec nous sur GitHub
La source de ce contenu se trouve sur GitHub, où vous pouvez également créer et examiner les problèmes et les demandes de tirage. Pour plus d’informations, consultez notre guide du contributeur.