En quoi consiste le kit de ressources Microsoft Graph ?

  • 3 minutes

Lorsque vous créez une application web et que vous souhaitez la connecter à Microsoft 365, vous devez implémenter l’autorisation et appeler Microsoft Graph pour récupérer les données stockées dans Microsoft 365.

Pour simplifier ce processus, le kit de ressources Microsoft Graph fournit un ensemble de composants web et de fournisseurs d’authentification permettant de connecter des applications web à Microsoft 365.

Dans cette leçon, vous découvrirez le Kit de ressources Microsoft Graph et la raison pour laquelle vous voudriez l’utiliser. Vous découvrirez également les différents types d’applications qui peuvent utiliser le Kit de ressources.

Vue d’ensemble du Kit de ressources Microsoft Graph

Le Kit de ressources Microsoft Graph est un ensemble de composants web que vous pouvez utiliser avec n’importe quelle infrastructure JavaScript pour connecter votre application à Microsoft 365. Une fois le Kit de ressources chargé dans votre application, vous pouvez accéder à un ensemble de balises HTML personnalisées. Ces balises vous permettent de charger des données de Microsoft 365.

Par exemple, pour afficher la liste des réunions à venir pour l’utilisateur actuel, vous devez inclure dans votre application l’extrait de code suivant :

<mgt-agenda></mgt-agenda>

Votre application restituerait alors :

Capture d’écran de la liste des réunions à venir rendue par le composant Agenda du Kit de ressources Microsoft Graph.

Le Kit de ressources Microsoft Graph est mis à jour régulièrement avec de nouveaux composants et fonctionnalités.

Pourquoi utiliser le Kit de ressources Microsoft Graph ?

Avez-vous remarqué dans l’exemple précédent que vous n’aviez pas besoin d’émettre une seule demande web ? C’est précisément pourquoi vous devez envisager d’utiliser le Kit de ressources Microsoft Graph.

  • Concentrez-vous sur la création de votre propre application: Le kit de ressources Microsoft Graph dispense de l’autorisation et la connexion à Microsoft Graph. Vous n’avez pas à vous soucier des autorisations, de la création de demandes web, de la gestion des réponses et de la gestion des exceptions.
  • Personnalisez le rendu pour qu’il corresponde à votre application web : Tous les composants du Kit de ressources Microsoft Graph sont prêts à l’emploi. Par défaut, ils affichent les données à l’aide de l’interface utilisateur Fluent, langage de conception de Microsoft 365. Chaque composant expose également un modèle, ce qui vous permet de personnaliser les données rendues.

Quand utiliser le Kit de ressources Microsoft Graph ?

Vous pouvez utiliser le Kit de ressources Microsoft Graph lors de la création d’applications web et d’extensions pour Microsoft 365.

  • Utilisez le kit de ressources Microsoft Graph dans les applications web : Le kit de ressources Microsoft Graph le plus adapté pour l’utilisation dans les applications web. Avec une configuration minimale, il permet aux contacts de se connecter à votre application à l’aide de leur compte Microsoft 365. En utilisant les différents composants, vous pouvez charger les données directement à partir de Microsoft 365, ce qui augmente la valeur de votre application.
  • Créer des extensions Microsoft 365 à l’aide du kit de ressources Microsoft Graph : Vous pouvez également utiliser le kit de ressources Microsoft lors de la création d’extensions pour Microsoft 365, telles que des onglets Teams ou des composants WebPart de SharePoint Framework. Pour créer ces extensions, le Kit de ressources insérait des fournisseurs qui utilisent les informations d’authentification existantes exposées par Microsoft 365.
  • Utilisez le Kit de ressources Microsoft Graph dans n’importe quelle infrastructure JavaScript : Les composants web du Kit de ressources Microsoft Graph fonctionnent avec n’importe quelle infrastructure JavaScript. Si vous créez des applications Web à l'aide de React, il existe un kit de ressources spécifique pour React. Ce package englobe les composants du kit de ressources dans des composants React, ce qui permet de transmettre plus facilement des données complexes dans les composants, et de configurer les gestionnaires d'événements.

Charger le Kit de ressources Microsoft Graph dans votre application web

Si vous créez des applications web sans utiliser de bundler, vous pouvez charger le kit de ressources Microsoft Graph directement à partir du Content Delivery Network. Pour charger le Kit de ressources à partir du réseau content delivery network, ajoutez cet extrait de code à votre application web :

<script src="https://unpkg.com/@microsoft/mgt@3/dist/bundle/mgt-loader.js"></script>

Si vous travaillez sur des projets qui utilisent un gestionnaire de paquets comme npm, ajoutez Microsoft Graph Toolkit à votre application Web en installant le paquet @microsoft/mgt :

npm install @microsoft/mgt

Si vous construisez des applications React, installez plutôt le paquet @microsoft/mgt-react :

npm install @microsoft/mgt-react