Was ist das Microsoft Graph-Toolkit?

  • 3 Minuten

Wenn Sie eine Webanwendung erstellen und eine Verbindung zu Microsoft 365 herstellen möchten, müssen Sie die Autorisierung implementieren und Microsoft Graph aufrufen, um in Microsoft 365 gespeicherte Daten abzurufen.

Um diesen Prozess zu vereinfachen, bietet das Microsoft Graph-Toolkit eine Gruppe von Webkomponenten und Authentifizierungsanbietern zum Verbinden von Webanwendungen mit Microsoft 365.

In dieser Einheit werden Sie erfahren, was das Microsoft Graph-Toolkit ist und warum Sie es verwenden sollten. Sie werden ebenfalls erfahren, was für unterschiedliche Arten von Apps das Toolkit verwenden können.

Überblick über das Microsoft Graph-Toolkit

Das Microsoft Graph-Toolkit ist eine Gruppe von Webkomponenten, die Sie mit jedem JavaScript-Framework verwenden können, um Ihre App mit Microsoft 365 zu verbinden. Nachdem Sie das Toolkit in Ihre App geladen haben, erhalten Sie Zugriff auf eine Gruppe von benutzerdefinierten HTML-Tags. Mit diesen Tags können Sie Daten aus Microsoft 365 laden.

Um beispielsweise die Liste der bevorstehenden Besprechungen für den aktuellen Benutzer anzuzeigen, fügen Sie in Ihre App den folgenden Codeausschnitt ein:

<mgt-agenda></mgt-agenda>

Ihre App würde dann wie folgt rendern:

Screenshot der Liste der bevorstehenden Besprechungen, gerendert von der Microsoft Graph-Toolkit-Agendakomponente.

Das Microsoft Graph-Toolkit wird regelmäßig mit neuen Komponenten und Features aktualisiert.

Warum sollten Sie das Microsoft Graph-Toolkit verwenden?

Haben Sie im vorherigen Beispiel bemerkt, dass Sie keine einzige Webanforderung stellen mussten? Genau aus diesem Grund sollten Sie die Verwendung des Microsoft Graph-Toolkit in Betracht ziehen.

  • Fokussieren Sie auf das Erstellen Ihrer eigenen Webanwendung: Das Microsoft Graph-Toolkit abstrahiert das Autorisieren und Herstellen einer Verbindung zu Microsoft Graph. Sie müssen sich nicht um die Autorisierung, das Erstellen von Webanfragen, das Behandeln von Antworten und den Umgang mit Ausnahmen kümmern.
  • Anpassen des Rendering an Ihre Web-App: Alle Microsoft Graph-Toolkit-Komponenten sind einsatzbereit. Standardmäßig zeigen Sie Daten über die Fluent-Benutzererfahrung an – die Microsoft 365-Entwurfssprache. Jede Komponente macht auch eine Vorlage verfügbar, mit der Sie die gerenderten Daten anpassen können.

Wann sollten Sie das Microsoft Graph-Toolkit verwenden?

Sie können das Microsoft Graph-Toolkit beim Erstellen von Webanwendungen und -Erweiterungen für Microsoft 365 verwenden.

  • Verwendung des Microsoft Graph-Toolkit in Web-Apps: Das Microsoft Graph-Toolkit ist bestens für die Verwendung in Webanwendungen geeignet. Mit minimaler Konfiguration können sich Personen mit ihrem Microsoft 365-Konto in Ihre App anmelden. Mit den verschiedenen Komponenten können Sie Daten direkt aus Microsoft 365 laden und so den Wert Ihrer App erhöhen.
  • Erstellen von Microsoft 365-Erweiterungen mit dem Microsoft Graph-Toolkit: Sie können das Microsoft Graph-Toolkit auf für das Erstellen von Erweiterungen für Microsoft 365 verwenden, z. B. für Teams-Registerkarten oder SharePoint-Framework-Webparts. Zum Erstellen dieser Erweiterungen wird das Toolkit mit Anbietern geliefert, welche die vorhandenen Authentifizierungsinformationen verwenden, die von Microsoft 365 bereitgestellt werden.
  • Verwenden des Microsoft Graph-Toolkit in jedem JavaScript-Framework: Die Microsoft Graph-Toolkit-Webkomponenten funktionieren mit jedem JavaScript-Framework. Wenn Sie Web-Apps mit React erstellen, gibt es dafür ein spezielles Toolkit-Paket. Dieses Paket fasst die Komponenten des Toolkits in React-Komponenten zusammen, wodurch es einfacher wird, komplexe Daten an Komponenten zu übergeben und Ereignishandler zu konfigurieren.

Laden des Microsoft Graph-Toolkit in Ihre Webanwendung

Wenn Sie eine einfache Web-App erstellen und keinen Bundler verwenden, können Sie das Microsoft Graph-Toolkit direkt aus dem Netzwerk für die Inhaltsübermittlung (Content Delivery Network, CDN) laden. Um das Toolkit aus dem Netzwerk für die Inhaltsübermittlung zu laden, fügen Sie den folgenden Codeausschnitt in Ihre Web-App ein:

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

Wenn Sie an Projekten arbeiten, die einen Paketmanager wie NPM verwenden, fügen Sie Ihrer Webanwendung das Microsoft Graph-Toolkit hinzu, indem Sie das @microsoft/mgt-Paket installieren:

npm install @microsoft/mgt

Wenn Sie React-Apps erstellen, installieren Sie stattdessen das Paket @microsoft/mgt-react:

npm install @microsoft/mgt-react