Utilisation du Kit de ressources Microsoft Graph pour connecter votre solution à Microsoft Graph

Lors de la création de solutions SharePoint Framework, l’utilisation du Kit de ressources Microsoft Graph est le moyen le plus simple d’afficher des données Microsoft 365.

Qu’est-ce que le Kit de ressources Microsoft Graph

Le Kit de ressources Microsoft Graph est un ensemble de composants réutilisables et indépendants de l’infrastructure et de fournisseurs d’authentification qui vous permet d’accéder et d’utiliser Microsoft Graph. Les composants sont complètement et rapidement fonctionnels avec des fournisseurs intégrés qui authentifient et récupèrent des données à partir de Microsoft Graph.

Le Kit de ressources Microsoft Graph simplifie l’utilisation de Microsoft Graph dans votre application. L’exemple suivant affiche des événements de calendrier d’un utilisateur connecté avec une seule ligne de code en utilisant le composant Agenda.

Ouvrir cet exemple dans mgt.dev

Pourquoi utiliser le Kit de ressources Microsoft Graph dans SharePoint Framework?

Lorsque vous créez des solutions à l’aide de SharePoint Framework, vous vous connectez à Microsoft Graph en utilisant MSGraphClient exposé par SharePoint Framework. MSGraphClient traite l’authentification avec Microsoft Graph à votre place pour vous permettre de vous concentrer sur la création de votre application. Néanmoins, vous devez générer les requêtes API nécessaires, les exécuter et traiter leurs réponses, et afficher les données dans votre application.

Microsoft Graph Toolkit simplifie encore davantage l’utilisation de Microsoft Graph. Non seulement il gère l’authentification, mais il communique également avec Microsoft Graph pour vous et affiche automatiquement les données récupérées dans votre application, ce qui vous permet de gagner du temps.

L’exemple suivant présente comment utiliser le composant Agenda du kit de ressources dans un composant WebPart standard JavaScript SharePoint Framework pour afficher des événements de calendrier de l’utilisateur actuel :

import { Providers, SharePointProvider } from '@microsoft/mgt-spfx';

// ...

export default class CalendarWebPart extends BaseClientSideWebPart<ICalendarWebPartProps> {
  protected async onInit() {
    if (!Providers.globalProvider) {
      Providers.globalProvider = new SharePointProvider(this.context);
    }
  }

  public render(): void {
    this.domElement.innerHTML = `
      <div class="${ styles.calendar }">
        <mgt-agenda></mgt-agenda>
      </div>`;
  }

  // ...
}

Notez la façon dont le Kit de ressources Microsoft Graph utilise le contexte actuel de SharePoint Framework et fait abstraction de la récupération des événements de calendrier dans Microsoft Graph pour les afficher dans votre application sous la forme d’une seule ligne de code : <mgt-agenda></mgt-agenda>.

Utiliser le Kit de ressources Microsoft Graph dans SharePoint Framework

Le Kit de ressources Microsoft Graph se connecte à Microsoft Graph pour récupérer les données stockées dans Microsoft 365. Pour accéder aux données, le principal du service, qui facilite la communication avec les API, a besoin des autorisations d’API nécessaires pour Microsoft Graph. Les autorisations nécessaires pour votre projet dépendent des composants du kit de ressources que vous utilisez. Pour obtenir plus d’informations sur les autorisations Microsoft Graph exigées par les composants, consultez leur documentation.

Une fois que vous déterminez la liste des autorisations d’API nécessaires pour votre projet SharePoint Framework, ajoutez-les à la configuration du projet.

L’étape suivante est d’ajouter le Kit de ressources Microsoft Graph à votre projet. Pour connaître la procédure exacte, voir la documentation Bibliothèque SharePoint Framework pour le Kit de ressources Microsoft Graph.

Important

Si vous utilisez React dans votre projet SharePoint Framework, vous devrez installer les packages @microsoft/mgt-spfx et @microsoft/mgt-react dans votre projet. Vous devrez également régler les importations sur les types que vous chargez à partir du kit de ressources. Pour obtenir plus d’informations, voir la section React de la documentation de la bibliothèque SharePoint Framework pour le Kit de ressources Microsoft Graph.

Une fois les étapes de configuration effectuées, vous êtes prêt à utiliser le Kit de ressources Microsoft Graph dans votre projet.

Problèmes connus

Les composants WebPart et les extensions affichent une erreur

Les composants WebPart et extensions SharePoint Framework qui utilisent le Kit de ressources Microsoft Graph affichent une erreur semblable à :

Échec de l’exécution « définir » sur « CustomElementRegistry » : le nom « mgt-xyz » est déjà utilisé avec ce registre.

Cette erreur est due à plusieurs composants SharePoint Framework tentant d’instancier leur propre copie du Kit de ressources Microsoft Graph. Pour éviter cette erreur, vous devez déployer le package mgt-spfx.sppkg vers le catalogue d’applications SharePoint dans votre client et mettre à jour toutes les solutions utilisées par le Kit de ressources Microsoft Graph pour faire usage du package SharePoint @microsoft/mgt-spfx. Pour obtenir plus d’informations, voir la documentation de la bibliothèque SharePoint Framework pour le Kit de ressources Microsoft Graph.

Erreur AADSTS65001 consignée dans la console du développeur

Les composants WebPart et extensions SharePoint Framework qui utilisent le Kit de ressources Microsoft Graph ne fonctionnement pas comme prévu. Dans la console du développeur, vous voyez une erreur semblable à :

AADSTS65001: l’utilisateur ou l’administrateur n’a pas accepté d’utiliser l’application avec l’ID « f96cafc5-5fa8-4594-9815-aa169a8c6d09 » nommé « Principal de l’application web d’extensibilité du client SharePoint Online ». Envoyez une demande d’autorisation interactive pour cet utilisateur et cette ressource.

Cette erreur est souvent due aux autorisations nécessaires d’API Microsoft Graph non accordées au principal du service SharePoint Framework. Dans votre Centre d’administration SharePoint, vérifiez que les autorisations nécessaires sont accordées et répertoriées sur la page d’accès à l’API. Pour plus d’informations, consultez la documentation sur la gestion des API SharePoint.

Voir aussi