Fournisseur SharePoint

Utilisez le fournisseur SharePoint provider dans votre composants WebPart pour démarrer les composants avec l’accès Microsoft Graph.

Pour en savoir plus sur les fournisseurs d’authentification, voir Fournisseurs.

Prise en main

Initialisez le fournisseur dans la méthode onInit() de votre composant WebPart. Cet exemple utilise le @microsoft/mgt-spfx package .

// import the providers at the top of the page
import {Providers, SharePointProvider} from '@microsoft/mgt-spfx';

// add the onInit() method if not already there in your web part class
protected async onInit() {
  Providers.globalProvider = new SharePointProvider(this.context);
}

Vous pouvez désormais ajouter des composants dans votre méthode render() qui utiliseront le contexte SharePoint pour accéder à Microsoft Graph.

public render(): void {
  this.domElement.innerHTML = `
    <mgt-agenda></mgt-agenda>
    `;
}

Utiliser un autre point de terminaison cloud

Utilisez cette option lorsque vous souhaitez utiliser le kit de ressources pour afficher vos données à partir d’un autre point de terminaison Microsoft 365.

// import the providers at the top of the page
import {Providers, SharePointProvider} from '@microsoft/mgt-spfx';
import {GraphEndpoint} from '@microsoft/mgt-element';

const baseUrl: GraphEndpoint = 'https://graph.microsoft.us';

// add the onInit() method if not already there in your web part class
protected async onInit() {
  Providers.globalProvider = new SharePointProvider(this.context, baseUrl=baseUrl);
}

Ensuite, utilisez le kit de ressources comme d’habitude.

Note: Le Kit de ressources Microsoft Graph nécessite Typescript 3.7 ou version ultérieure. Vérifiez que vous utilisez une version prise en charge de Typescript en installant le compilateur approprié.

Échantillon

Pour plus d’informations sur l’initialisation du fournisseur SharePoint, consultez le guide de prise en main de créer un composant WebPart SharePoint .

Tester dans le workbench

Si vous débutez avec les composants WebPart SharePoint, vous pouvez suivre le guide Créez votre premier composant WebPart.

Une fois votre composant WebPart créé et que vous êtes prêt à utiliser les composants, vous devez vérifier que votre composant WebPart dispose des autorisations appropriées pour accéder à Microsoft Graph. Pour plus de détails, voir Consommer Microsoft Graph dans SharePoint Framework.

En bref, il est important d’ajouter l’autorisation appropriée à votre package-solution.json. Vous devez charger un package de votre composant WebPart sur SharePoint et obtenir l’approbation d’un administrateur pour les autorisations demandées.

Conseil

Le guide de prise en main Créer un composant WebPart SharePoint fournit des instructions détaillées pour configurer et approuver des autorisations.

Remarque : Si vous n’êtes pas sûr des autorisations à ajouter, la documentation de chaque composant inclut toutes les autorisations dont il a besoin.