Überblick über 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. Im folgenden Beispiel werden ein angemeldeter Benutzer und seine Kalenderereignisse mit nur zwei Codezeilen mithilfe der Anmelde- und Agenda-Komponenten angezeigt.

Öffnen Sie dieses Beispiel in mgt.dev.

Was ist im Microsoft Graph-Toolkit enthalten?

Komponenten

Das Microsoft Graph-Toolkit enthält eine Sammlung von Webkomponenten für die am häufigsten erstellten Oberflächen, die von Microsoft Graph-APIs unterstützt werden.

Die Komponenten sind auch als React-Komponenten verfügbar.

Komponente Beschreibung
Benutzername Eine Schaltfläche und ein Flyout-Steuerelement, um einen Benutzer bei der Microsoft Identity-Plattform zu authentifizieren und die Profilinformationen des Benutzers anzuzeigen, wenn er sich anmeldet.
Person Zeigt eine Person oder einen Kontakt anhand ihres Fotos, Namens und/oder ihrer E-Mail-Adresse an.
Personen Zeigt eine Gruppe von Personen oder Kontakten anhand ihrer Fotos oder Initialen an.
Agenda Zeigt Ereignisse im Kalender eines Benutzers oder einer Gruppe an.
Personenauswahl Bietet die Möglichkeit, nach Personen zu suchen, und rendert die Liste der Ergebnisse.
Personenkarte Ein Flyout, das für die Personenkomponente verwendet wird, um weitere Profilinformationen zu einem Benutzer anzuzeigen.
Datei Stellt eine Datei oder einen Ordner mit einem Symbol, einem Dateinamen, einem Autor und mehr dar.
Dateiliste Zeigt eine Liste mit mehreren Dateien oder Ordnern an.
Abrufen Mit dieser Option können Sie eine GET-Abfrage an alle Microsoft Graph-API direkt in Ihrem HTML-Code senden.
Kanalauswahl Bietet die Möglichkeit, nach Microsoft Teams-Kanälen zu suchen, um einen Kanal aus einer gerenderten Ergebnisliste auszuwählen.
To Do Zeigt das Hinzufügen, Entfernen, Abschließen oder Bearbeiten von Aufgaben aus Microsoft To Do an und ermöglicht dies.
Aufgaben Zeigt das Hinzufügen, Entfernen, Abschließen oder Bearbeiten von Aufgaben aus Microsoft Planner oder Microsoft To Do an und ermöglicht sie.

Anbieter

Anbieter aktivieren die Authentifizierung, stellen die Implementierung für den Erwerb von Zugriffstoken auf verschiedenen Plattformen bereit und machen einen Microsoft Graph-Client zum Aufrufen der Microsoft Graph-APIs verfügbar. Die Komponenten funktionieren am besten, wenn sie mit einem Anbieter verwendet werden, aber die Anbieter können selbst verwendet werden.

Anbieter Beschreibung
MSAL Verwendet msal.js, um Benutzer anzumelden und Token für die Verwendung mit Microsoft Graph zu erwerben.
MSAL2 Verwendet msal-browser zum Anmelden von Benutzern und zum Abrufen von Token für die Verwendung mit Microsoft Graph.
Elektron Authentifiziert sich und bietet Microsoft Graph Zugriff auf Komponenten innerhalb von Electron-Apps.
SharePoint Authentifiziert und bietet Microsoft Graph Zugriff auf Komponenten innerhalb von SharePoint-Webparts.
Microsoft Teams Verwendet msal.js zum Anmelden von Benutzern und zum Abrufen von Token auf dem Client auf Microsoft Teams-Registerkarten.
Teams MSAL2 Verwendet msal-browser zum Anmelden von Benutzern und zum Abrufen von Token auf Microsoft Teams-Registerkarten. Unterstützt einmaliges Anmelden (Single Sign-On, SSO) mit einem benutzerdefinierten Back-End.
Proxy Ermöglicht die Verwendung der Back-End-Authentifizierung, indem alle Aufrufe an Microsoft Graph über Ihr Back-End geleitet werden.
Custom Erstellt einen benutzerdefinierten Anbieter, um die Authentifizierung und den Zugriff auf Microsoft Graph mithilfe des vorhandenen Authentifizierungscodes Ihrer Anwendung zu aktivieren.

Gründe für die Verwendung des Microsoft Graph-Toolkits

Mit dem Microsoft Graph-Toolkit können Sie häufig verwendete Erfahrungen, die von Microsoft Graph unterstützt werden, schnell und einfach in Ihre eigene Anwendung integrieren. Das Toolkit:

  • Verkürzt die Entwicklungszeit. Die Arbeit zum Herstellen einer Verbindung mit Microsoft Graph-APIs und zum Rendern der Daten in einer Benutzeroberfläche, die wie eine Microsoft 365-Benutzeroberfläche aussieht und sich anfühlt, ist für Sie erledigt, ohne dass Anpassungen erforderlich sind.

  • Funktioniert überall. Alle Komponenten basieren auf Webstandards und arbeiten nahtlos mit jedem modernen Browser und Webframework (z. B. React, Angular oder Vue).

  • Ist schön, aber flexibel. Die Komponenten sind so konzipiert, dass sie wie Microsoft 365-Oberflächen aussehen und sich anfühlen, können aber auch mithilfe von benutzerdefinierten CSS-Eigenschaften und Vorlagen angepasst werden.

Wer sollte es verwenden?

Das Microsoft Graph-Toolkit eignet sich hervorragend für Entwickler aller Erfahrungsebenen, die eine App entwickeln möchten, die eine Verbindung mit Daten aus Microsoft Graph herstellt und auf diese zugreift, z. B.:

  • Web-App
  • Registerkarte "Microsoft Teams"
  • Progressive Web App (PWA)
  • Electron-App
  • SharePoint-Webpart

Wo kann ich es verwenden?

Das Microsoft Graph-Toolkit wird in den folgenden Browsern unterstützt:

Microsoft Edge Firefox Chrome Safari Opera Samsung Internet
Microsoft Edge Firefox Chrome Safari Opera Samsung

Nächste Schritte

  • Testen Sie die Komponenten im Spielplatz aus.
  • Erste Schritte mit dem Microsoft Graph-Toolkit.
  • Sehen Sie sich das Microsoft Graph-Toolkit auf GitHub an.