Was ist Microsoft Fabric Embed in Microsoft Fabric (Vorschau)?

mit Microsoft Fabric Embed können Sie unterstützte Microsoft Fabric Elemente in browserbasierte Webanwendungen hinzufügen oder einbetten. Verwenden Sie Fabric Embedded, wenn Benutzer Inhalte aus Fabric in Ihren Anwendungen anzeigen und mit ihnen interagieren sollen, anstatt das Fabric-Portal zu öffnen.

In diesem Artikel erfahren Sie, wie Microsoft Fabric Einbetten funktioniert, welche Vorschauanforderungen gelten und welche Fabric Elemente Sie einbetten können.

Was benötige ich, um Microsoft Fabric Embed zu verwenden?

Bevor Sie beginnen, vergewissern Sie sich, dass Sie folgendes haben:

  • Zugriff auf einen Microsoft Fabric Mandanten und ein delegiertes Zugriffstoken für den angemeldeten Microsoft Entra Benutzer.
  • Berechtigung zum Erstellen oder Aktualisieren einer Microsoft Entra ID App-Registrierung
  • Eine aktive Microsoft Fabric-Kapazität (F SKU)
  • Ein Microsoft Fabric Arbeitsbereich, der dieser Kapazität zugewiesen ist
  • Betrachterzugriff oder höher auf den Arbeitsbereich, der das Element „Real-Time Dashboard“ enthält
  • Ein Echtzeit-Dashboard-Element, auf das Sie im Arbeitsbereich zugreifen können
  • Eine JavaScript- oder TypeScript-Webanwendung, die Microsoft Entra ID Benutzeranmeldung verwendet
  • Node.js und npm auf Ihrem Entwicklungscomputer installiert
  • Fabric Embed Software Development Kit (SDK)

Wann sollten Sie Microsoft Fabric Embed in Microsoft Fabric verwenden?

Fabric Embed zeigt Real-Time Dashboardanalysen in den Anwendungen und Workflows an, die Benutzer bereits verwenden, z. B. benutzerdefinierte Anwendungen, Portale und Geschäftsworkflows. Die eingebettete Oberfläche verwendet Fabric Governance, Arbeitsbereichsberechtigungen und Microsoft Entra ID Benutzeridentität anstelle eines separaten Zugriffsmodells.

Verwenden Sie Microsoft Fabric Embed, wenn Sie Folgendes benötigen:

  • Anzeigen eines Real-Time Dashboards in Ihrer JavaScript- oder TypeScript-Webanwendung während der öffentlichen Vorschau
  • Zulassen, dass Benutzer in Ihrer Anwendung bleiben, während sie Fabric Inhalte erkunden
  • Verwenden Sie Microsoft Fabric Governance, Berechtigungen für Fabric-Arbeitsbereiche und Microsoft Entra ID für die Zugriffssteuerung
  • Erstellen von benutzerdefinierten eingebetteten Oberflächen für Benutzer, die bereits Zugriff auf das zugrunde liegende Fabric Element haben

Welche Elementtypen werden von der Microsoft Fabric-Einbettungsvorschau unterstützt?

Während der öffentlichen Vorschau unterstützt Microsoft Fabric Embed nur Real-Time Dashboards.

Wie funktioniert Authentifizierung und Autorisierung für Microsoft Fabric Einbettungsvorschau?

Microsoft Fabric Embed verwendet delegierte Benutzerauthentifizierung. Microsoft Entra ID stellt ein delegiertes Token für den angemeldeten Benutzer aus – dies ist kein reines App- oder Dienstprinzipal-Token. In diesem benutzerbasierten Authentifizierungsmodell werden Inhalte im Namen des angemeldeten Benutzers eingebettet, und Fabric erzwingt den Zugriff basierend auf den Berechtigungen dieses Benutzers.

Verwenden Sie diese Authentifizierungs- und Autorisierungsanforderungen, wenn Sie eine Microsoft Fabric Embed-Vorschaulösung planen:

Authentifizierungsanforderung Microsoft Fabric Einbettungsvorschauverhalten
Benutzeranmeldung Ihre Anwendung meldet benutzer mit Microsoft Entra ID an.
Delegiertes Token Ihre Anwendung fordert delegierte Berechtigungen für die Fabric-Einbettung und den Zugriff auf Elemente an.
Arbeitsbereich- und Elementzugriff Der angemeldete Benutzer muss Zugriff auf den Arbeitsbereich und das Real-Time Dashboardelement und die Datenquellen des Echtzeitdashboards haben.
Umleitungs-URI Ihre Microsoft Entra-App-Registrierung muss den umleitungs-URI enthalten, der von Ihrer Anwendung verwendet wird.

Welche Fabric Kapazität erfordert Microsoft Fabric Embed?

Microsoft Fabric Embed setzt voraus, dass der Arbeitsbereich, der das Echtzeitdashboard enthält, eine Fabric-Kapazität (F SKU) verwendet. Die Fabric-Kapazität stellt Rechenressourcen für Fabric-Workloads und Elemente bereit. Bevor Sie eine eingebettete Oberfläche erstellen, weisen Sie dem Arbeitsbereich, der das Dashboard enthält, einer Fabric Kapazität zu.

Kapazitätsanforderung Was dies für Microsoft Fabric Embed bedeutet
Fabric-Kapazität (F SKU) Der Real-Time-Dashboard-Arbeitsbereich muss für die eingebettete Nutzung die Fabric-Kapazität verwenden.
Fabric-Testkapazität Microsoft Fabric Embed unterstützt Fabric Testkapazitäten, vorbehaltlich der in Fabric Testkapazität beschriebenen Einschränkungen.

Einschränkungen für Microsoft Fabric Embed

Die öffentliche Vorschau von Microsoft Fabric Embed weist die folgenden Einschränkungen auf:

  • Nur Real-Time Dashboards werden unterstützt – Sie können andere Fabric Elementtypen nicht mit Microsoft Fabric Embed während der öffentlichen Vorschau einbetten.
  • Nur delegierte Benutzerauthentifizierung wird unterstützt – Benutzer müssen sich mit Microsoft Entra ID anmelden. Die Authentifizierung mit Dienstprinzipal (nur App) wird nicht unterstützt.
  • Einbetten mit App-eigenen Daten wird nicht unterstützt – Die Microsoft Fabric Embed-Vorschau unterstützt weder reine App-Token noch das Einbetten von Inhalten für Benutzer, die keinen Zugriff auf das Fabric-Element haben. Der angemeldete Benutzer muss das Element in Fabric öffnen können.
  • Power BI Elemente verwenden Power BI eingebettete Analysen – Verwenden Sie Power BI eingebetteten Analysen, um Power BI berichte, Dashboards oder Kacheln einzubetten; Microsoft Fabric Einbettungsvorschau bettet sie nicht als Fabric Elemente ein.
  • Vorschauverträge können sich ändern – Der SDK-Paketname, die API-Oberfläche, Ereignisse, Typnamen und Konfigurationsverträge können sich vor der allgemeinen Verfügbarkeit ändern. Überprüfen Sie die Anmerkungen zur öffentlichen Vorschauversion, bevor Sie Ihre Anwendung aktualisieren.

Nächste Schritte

Verwenden Sie diese Ressourcen, um den Identitäts-, Kapazitäts- und Produktkontext für eine Microsoft Fabric Embed Preview-Lösung vorzubereiten: