SharePoint-Anbieter

Verwenden Sie den SharePoint-Anbieter in Ihren SharePoint-Webparts, um die Komponenten mit Microsoft Graph-Zugriff zu nutzen.

Weitere Informationen zu Authentifizierungsanbietern finden Sie unter Anbieter.

Erste Schritte

Initialisieren Sie den Anbieter innerhalb der onInit() -Methode Ihres Webparts. In diesem Beispiel wird das @microsoft/mgt-spfx -Paket verwendet.

// 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);
}

Jetzt können Sie ihrer render() Methode eine beliebige Komponente hinzufügen, die den SharePoint-Kontext für den Zugriff auf Microsoft Graph verwendet.

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

Verwenden eines anderen Cloudendpunkts

Verwenden Sie diese Option, wenn Sie das Toolkit verwenden möchten, um Ihre Daten von einem anderen Microsoft 365-Endpunkt zu rendern.

// 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);
}

Verwenden Sie dann das Toolkit wie gewohnt.

Hinweis: Das Microsoft Graph-Toolkit erfordert Typescript 3.7 oder höher. Stellen Sie sicher, dass Sie eine unterstützte Version von Typescript verwenden, indem Sie den richtigen Compiler installieren.

Beispiel

Ausführliche Informationen zum Initialisieren des SharePoint-Anbieters finden Sie im Leitfaden zu den ersten Schritten zum Erstellen eines SharePoint-Webparts .

Testen in der Workbench

Wenn Sie gerade erst mit SharePoint-Webparts beginnen, können Sie die Anleitung erstellen Ihres ersten Webparts befolgen.

Nachdem Sie ein Webpart erstellt haben und bereit sind, die Komponenten zu verwenden, müssen Sie sicherstellen, dass Ihr Webpart über die richtigen Berechtigungen für den Zugriff auf Microsoft Graph verfügt. Weitere Informationen finden Sie unter Nutzen von Microsoft Graph im SharePoint-Framework.

Kurz gesagt, es ist wichtig, ihrer package-solution.jsondie richtige Berechtigung hinzuzufügen. Sie müssen ein Paket Ihres Webparts in SharePoint hochladen und die angeforderten Berechtigungen von einem Administrator genehmigen lassen.

Tipp

Der Leitfaden zu den ersten Schritten erstellen eines SharePoint-Webparts enthält schrittweise Anweisungen zum Konfigurieren und Genehmigen von Berechtigungen.

Hinweis: Wenn Sie nicht sicher sind, welche Berechtigungen Hinzugefügt werden sollen, enthält die Dokumentation für jede Komponente alle erforderlichen Berechtigungen.