Explorer l’API JavaScript Office à l’aide de Script Lab

  • Article

Script Lab est un outil gratuit permettant à quiconque d’apprendre à développer des compléments Office. Script Lab vous permet de coder et d’exécuter les API JavaScript Office en même temps que 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.

Obtenir Script Lab pour Excel, PowerPoint et Word

Obtenir un Script Lab pour Outlook

Découvrez Script Lab en action dans cette vidéo YouTube d’une minute. Aperçu vidéo montrant Script Lab en cours d’exécution dans Excel, Word et PowerPoint.

Qu’est-ce que script Lab ?

Script Lab est un complément pour le prototypage de compléments. Il utilise l’API JavaScript Office dans Excel, Outlook, PowerPoint Word et se trouve dans un volet Office à l’intérieur de votre document, feuille de calcul ou e-mail. Il dispose d’un éditeur de code compatible IntelliSense, basé sur le même framework que celui utilisé par Visual Studio Code. Via Script Lab, vous avez accès à une bibliothèque d’exemples. Essayez rapidement les 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 toujours en préversion.

Remarque

Script Lab n’est pas liée aux scripts Office. Les scripts Office sont un outil pour l’automatisation des utilisateurs finaux dans Excel. Utilisez des scripts Office si vous souhaitez des solutions rapides et réutilisables qui n’ont pas besoin d’intégrations avec des services web.

Principales fonctionnalités

Script Lab offre un certain nombre de fonctionnalités pour vous aider à prototyper la fonctionnalité 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 exemples pour découvrir le fonctionnement de l’API et utilisez même des exemples pour créer un prototype de votre propre complément.

Échantillons.

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 à mesure que vous prototypez la conception du volet Office pour votre propre complément.

API en préversion

Pour appeler des API d’aperçu dans un extrait de code, vous devez mettre à jour les bibliothèques de l’extrait de code pour utiliser le réseau de distribution de contenu (CDN) bêta (https://appsforoffice.microsoft.com/lib/beta/hosted/office.js) et les définitions @types/office-js-previewde type d’aperçu . En outre, certaines API en préversion ne sont accessibles que si vous vous êtes inscrit au programme Microsoft 365 Insider et que vous exécutez une build 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 définitivement un extrait de code, 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 les sites de la communauté, 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.

Clients pris en charge

Script Lab est pris en charge pour Excel, Word et PowerPoint sur les clients suivants.

  • Office sur Windows*
  • Office sur Mac
  • Office sur le web

Script Lab pour Outlook est disponible sur les clients suivants.

  • Outlook sur Windows*

  • Outlook sur Mac

  • Outlook sur le web avec des navigateurs Chrome, Microsoft Edge ou Safari

    Remarque

    À compter de la version 115 des navigateurs basés sur Chromium, tels que Chrome et Edge, le partitionnement du stockage est testé pour empêcher le suivi intersites par canal latéral spécifique (voir aussi stratégies de navigateur Microsoft Edge). Cette modification empêche Script Lab extraits de code de s’exécuter dans Outlook sur le web. Pour contourner ce problème, accédez à chrome://flags ou edge://flags dans votre navigateur, puis définissez l’indicateur Partitionnement de stockage tiers (#third-party-storage-partitioning) sur Désactivé.

Importante

* Script Lab ne fonctionne plus avec les combinaisons de plateforme et de version d’Office qui utilisent la vue web Trident (Internet Explorer) pour héberger des compléments. Cela inclut les versions perpétuelles d’Office à Office 2019. Pour plus d’informations, voir Navigateurs et contrôles d’affichage web utilisés par les compléments Office.

Étapes suivantes

Obtenir Script Lab pour Excel, PowerPoint et Word

Obtenir un Script Lab pour Outlook

Une fois que vous avez prototyper votre code dans Script Lab, transformez-le en complément réel en suivant les étapes décrites dans Créer un complément Office autonome à partir de votre code Script Lab.

Voir aussi