Freigeben über

Verwenden von Microsoft Graph-Toolkit, um Ihre Lösung mit Microsoft Graph zu verbinden

Wenn Sie SharePoint-Framework-Lösungen erstellen, ist die Verwendung des Microsoft Graph-Toolkit die einfachste Möglichkeit, um Daten aus Microsoft 365 anzuzeigen.

Was ist das Microsoft Graph-Toolkit

Microsoft Graph-Toolkit ist eine Sammlung von wiederverwendbaren, vom Framework unabhängigen Komponenten und Authentifizierungsanbietern für den Zugriff auf und die Arbeit mit Microsoft Graph. Die Komponenten werden voll funktionsfähig geliefert, mit eingebauten Anbietern, die sich mit Microsoft Graph authentifizieren und Daten daraus abrufen.

Das Microsoft Graph-Toolkit erleichtert die Verwendung von Microsoft Graph in Ihrer Anwendung. Das folgende Beispiel zeigt Kalenderereignisse des angemeldeten Benutzers, mit nur einer Zeile Code, mittels der Agenda-Komponente.

Öffnen dieses Beispiels in mgt.dev

Warum sollten Sie das Microsoft Graph-Toolkit im SharePoint-Framework verwenden?

Wenn Sie Lösungen mit SharePoint-Framework erstellen, stellen Sie die Verbindung zu Microsoft Graph über den MSGraphClient her, der vom SharePoint-Framework bereitgestellt wird. Der MSGraphClient übernimmt für Sie die Authentifizierung mit Microsoft Graph, damit Sie sich auf das Erstellen Ihrer App konzentrieren können. Sie müssen trotzdem die notwendigen API-Anforderungen erstellen, sie ausführen, deren Antworten verarbeiten, und die Daten in Ihrer App anzeigen.

Das Microsoft Graph-Toolkit vereinfacht die Arbeit mit Microsoft Graph sogar noch mehr. Es kümmert sich nicht nur um die Authentifizierung, sondern kommuniziert auch für Sie mit Microsoft Graph, und es zeigt die abgerufenen Daten automatisch in Ihrer App an, wodurch Sie wertvolle Zeit sparen.

Das folgende Beispiel zeigt, wie man die Agenda-Komponente des Toolkits in einem einfachen JavaScript SharePoint-Framework-Webpart verwendet, um die Kalenderereignisse des aktuellen Benutzers anzuzeigen:

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>`;
  }

  // ...
}

Beachten Sie, wie das Microsoft Graph-Toolkit den aktuellen Kontext aus dem SharePoint-Framework nutzt, und das Abrufen von Kalenderereignissen aus Microsoft Graph und deren Anzeige in Ihrer App auf eine einzige Codezeile abstrahiert: <mgt-agenda></mgt-agenda>.

Verwendung des Microsoft Graph-Toolkit im SharePoint-Framework

Das Microsoft Graph-Toolkit verbindet zu Microsoft Graph, um in Microsoft 365 gespeicherte Daten abzurufen. Um auf die Daten zuzugreifen, benötigt der Dienstprinzipal, der die Kommunikation mit APIs ermöglicht, die notwendigen API-Berechtigungen für Microsoft Graph. Sie notwendigen Berechtigungen für Ihr Projekt sind davon abhängig, welche Toolkit-Komponenten Sie verwenden. Weitere Informationen zu den von den Komponenten benötigten Microsoft Graph-Berechtigungen finden Sie in deren Dokumentation.

Nachdem Sie die Liste der für Ihr SharePoint-Framework-Projekt benötigten API-Berechtigungen ermittelt haben, fügen Sie diese zur Konfiguration des Projekts hinzu.

Als nächsten Schritt fügen Sie das Microsoft Graph-Toolkit zu Ihrem Projekt hinzu. Die genauen Schritte finden Sie in der Dokumentation SharePoint-Framework-Bibliothek für das Microsoft Graph-Toolkit.

Wichtig

Wenn Sie in Ihrem SharePoint-Framework-Projekt React verwenden, müssen Sie sowohl das @microsoft/mgt-spfx- wie das @microsoft/mgt-react-Paket in Ihrem Projekt installieren. Sie müssen auch die Importe für die Typen anpassen, die Sie aus dem Toolkit laden. Weitere Informationen finden Sie im React-Abschnitt der Dokumentation für die SharePoint-Framework-Bibliothek für das Microsoft Graph-Toolkit.

Wenn Sie die Konfigurationsschritte beendet haben, sind Sie bereit, das Microsoft Graph-Toolkit in Ihrem Projekt zu verwenden.

Bekannte Probleme

Webparts und Erweiterungen zeigen Fehler an

Die SharePoint-Framework-Webparts und -Erweiterungen, welche das Microsoft Graph-Toolkit verwenden, zeigen eine Fehler an ähnlich wie:

Fehler beim Ausführen von „define“ auf „CustomElementRegistry“: der Name „mgt-xyz“ wurde bereits mit diesem Register verwendet.

Dieser Fehler wird verursacht, wenn mehrere SharePoint-Framework-Komponenten versuchen, ihre eigene Kopie des Microsoft Graph-Toolkit zu instanziieren. Um dieses Problem zu vermeiden, sollten Sie das mgt-spfx.sppkg-Paket im SharePoint-App-Katalog in Ihrem Mandanten bereitstellen, und alle Lösungen aktualisieren, die das Microsoft Graph-Toolkit verwenden, um das @microsoft/mgt-spfx-SharePoint-Paket zu verwenden. Weitere Informationen finden Sie in der Dokumentation für die SharePoint-Framework-Bibliothek für das Microsoft Graph-Toolkit.

AADSTS65001-Fehler in der Entwickler-Konsole protokolliert

Die SharePoint-Framework-Webparts und -Erweiterungen, welche das Microsoft Graph-Toolkit verwenden, funktionieren nicht wie erwartet. In der Entwickler-Konsole sehen Sie einen Fehler ähnlich wie:

AADSTS65001: Der Benutzer oder Administrator hat der Verwendung der Anwendung mit der ID „f96cafc5-5fa8-4594-9815-aa169a8c6d09“ und dem Namen „SharePoint Online Client Extensibility Web Application Principal“ nicht zugestimmt. Senden Sie eine interaktive Autorisierungsanforderung für diesen Benutzer und diese Ressource.

Dieser Fehler wird häufig dadurch verursacht, dass dem SharePoint-Framework-Dienstprinzipal nicht die erforderlichen Microsoft Graph-API-Berechtigungen gewährt wurden. Stellen Sie in Ihrem SharePoint Admin Center sicher, dass die notwendigen Berechtigungen gewährt wurden und auf der API-Zugriffsseite aufgeführt sind. Weitere Informationen finden Sie in der SharePoint-API-Verwaltungsdokumentation.

Siehe auch

  • Last updated on