Prise en main de la Boîte à outils Microsoft Graph

Vous pouvez facilement ajouter les composants de la Boîte à outils Microsoft Graph à votre application web, composant WebPart SharePoint ou aux onglets Microsoft Teams. Les composants sont basés sur des standards web et peuvent être utilisés dans des projets simples JavaScript ou avec des infrastructures web populaires telles que Reach, Angular, Vue.js et bien plus encore.

Vous pouvez visualiser cette petite vidéo pour découvrir la facilité et la simplicité de prise en main du Kit de ressources de Microsoft Graph.

Pour obtenir un didacticiel pas à pas, consultez le module De mise en Graph Shared Computer Toolkit Microsoft.

Configurer votre client Microsoft 365

Vous devez avoir accès à un client Microsoft 365 afin de pouvoir développer avec le Kit de ressources de Microsoft Graph. Si vous n’avez pas de compte, vous pouvez obtenir gratuitement un abonnement gratuit Microsoft 365 pour développeur en rejoignant le Programme pour les développeurs Microsoft 365. Pour obtenir des détails sur la façon de configurer votre abonnement, consultez Configurer un abonnement Microsoft 365 Développeur.

Configuration de votre environnement de développement

Pour développer avec le Kit de ressources de Microsoft Graph, vous devez utiliser un éditeur de texte ou un environnement de développement intégré (IDE). Vous pouvez utiliser l’éditeur ou l’environnement de développement intégré (IDE) de votre choix ou installer et utiliser Visual Studio Code gratuitement. Vous devez utiliser un navigateur web moderne, tel que Microsoft Edge, Google Chrome ou Firefox. Vous devez également disposer d’une version LTS de Node.js que vous pouvez installer à partir de nodejs.org.

Utilisation de la Boîte à outils Microsoft Graph

Vous pouvez utiliser la Boîte à outils Microsoft Graph dans votre application en faisant directement une référence au chargeur (via unpkg) ou en installant le package npm.

Pour utiliser le Kit de ressources Microsoft Graph via mgt-loader, ajouter la référence dans un script vers votre code :

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

<mgt-msal2-provider client-id="<YOUR_CLIENT_ID>"></mgt-msal2-provider>
<mgt-login></mgt-login>

Packages NPM

La Boîte à outils Microsoft Graph est composée de plusieurs packages NPM, ce qui vous permet d’inclure uniquement le code nécessaire pour vos applications.

@microsoft/mgt-element

@microsoft/mgt-element est le package principal contenant uniquement les classes de base utilisées pour la création de composants et les fournisseurs. Ce package expose toutes les interfaces et classes nécessaires pour créer vos propres composants et exporte l’interface IProvider et la classe SimpleProvider pour la création de fournisseurs personnalisés.

@microsoft/mgt-components

Le package @microsoft/mgt-components se compose de tous les composants web connectés de Microsoft Graph, tels que Person, PeoplePicker et bien plus encore.

Fournisseurs

Les fournisseurs sont disponibles via un seul package et peuvent être installés selon les besoins. Les packages de fournisseurs suivants sont disponibles :

  • @microsoft/mgt-msal-provider

    @microsoft/mgt-msal-provider contient les composants MsalProvider et mgt-msal-provider. Le fournisseur MSAL utilise msal.js pour l’authentification dans les applications web et les applications web progressives (P.A.S.).

  • @microsoft/mgt-msal2-provider

    @microsoft/mgt-msal2-provider contient les composants Msal2Provider et mgt-msal2-provider. Le fournisseur MSAL2 utilise msal-browser pour l’authentification dans les applications web et les applications P.A.S.

  • @microsoft/mgt-teams-provider

    @microsoft/mgt-teams-provider contient les composants TeamsProvider et mgt-teams-provider. Le fournisseur Microsoft Teams active l’authentification l’application d’onglet Microsoft Teams.

  • @microsoft/mgt-teams-msal2-provider

    @microsoft/mgt-teams-msal2-provider contient les composants TeamsMsal2Provider et mgt-teams-msal2-provider. Le fournisseur Microsoft Teams MSAL2 active l’authentification dans Microsoft Teams application d’onglet.

  • @microsoft/mgt-sharepoint-provider

    @microsoft/mgt-sharepoint-provider contient SharePointProvider pour l’authentification dans un environnement SharePoint.

  • @microsoft/mgt-proxy-provider

    @microsoft/mgt-proxy-provider contient ProxyProvider pour l’application que le proxy Graph appelle via un service de serveur principal.

@microsoft/mgt

@microsoft/mgt est le principal package qui inclut tous les packages mentionnés ci-dessus et les exporte à nouveau pour qu’ils soient disponibles via un seul package que vous pouvez installer.

@microsoft/mgt-react

Le package @microsoft/mgt-react contient tous les composants React générés automatiquement et prend la dépendance sur le package @microsoft/mgt.

@microsoft/mgt-spfx

Le @microsoft/mgt-spfx package contient une bibliothèque SharePoint Framework requise pour utiliser Microsoft Graph Shared Computer Toolkit dans SharePoint Framework solutions.

Étapes suivantes

Vous êtes désormais prêt à développer avec la Boîte à outils Microsoft Graph ! Les guides suivants sont disponibles pour vous aider à démarrer :