Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
In diesem Artikel werden die Architektur des Microsoft Fabric Extensibility Toolkits und die Integration von benutzerdefinierten Workloads in die Fabric-Plattform beschrieben. Es erläutert die Laufzeitkomponenten, Flüsse zwischen dem Fabric-Frontend, Ihrer Workload und Fabric-Diensten und wie das Manifest- und Itemmodell Workloads in Fabric nativ wirken lassen.
Architekturkomponenten
Fabric-Frontend (Host)
Das Fabric-Frontend ist die Hostumgebung. Sie rendert Ihre Workload als iFrame und macht eine sichere Host-API für den iFrame verfügbar, damit die Workload mit Fabric interagieren kann, während sie isoliert bleibt. Der Host ist für das Bootstrapping der Workload gemäß seinem Manifest (Einstiegspunkte, Routen und Funktionen), der Verwaltung von Authentifizierungstoken über die Microsoft Entra-ID und der Vermittlung von Aufrufen von der Workload an öffentliche Fabric-APIs und Plattformdienste verantwortlich.
Workload-Webanwendung
Ihre Workload ist eine Webanwendung (z. B. React oder Angular), die Sie in Ihrer Cloud hosten. Fabric lädt sie in einem iFrame und stellt Host-APIs bereit, die in die Plattform integriert werden können. Die App implementiert die in ihrem Manifest deklarierten Routen und UI-Oberflächen, verwendet Microsoft Entra-ID-Token (bereitgestellt vom Host), um öffentliche Fabric-APIs aufzurufen und bei Bedarf Ihre eigenen Back-End-Dienste aufzurufen, und folgt fabric UX-Anleitungen, sodass sie wie eine systemeigene Oberfläche aussieht und verhält.
Fabric-Dienst und öffentliche APIs
Der Fabric-Dienst macht öffentliche APIs zum Lesen und Schreiben von Metadaten und Inhalten, zum Verwalten von Elementen und zur Integration mit Plattformfunktionen verfügbar. Workloads rufen diese APIs mithilfe von bereichsbezogenen Token auf, die über die Microsoft Entra-ID ausgestellt wurden, z. B. zum Ausführen von CRUD-Vorgängen und Lebenszyklusaktionen für Elemente, zugreifen auf Daten und Inhalte, die in OneLake gespeichert sind, und an Arbeitsbereichsfeatures wie Suche und Ermittlung teilnehmen. Informationen zu Endpunkten, Bereichen und Identitätsrichtlinien finden Sie in den Fabric Public REST-APIs.
Microsoft Entra (Authentifizierung)
Authentifizierung und Autorisierung werden von Microsoft Entra ID verarbeitet. Das Manifest der Workload deklariert die benötigten Berechtigungen; Der Fabric-Host erhält die entsprechenden Token und erzwingt die Zustimmung und den Zugriff gemäß diesen Deklarationen.
Workloadmodell und Manifest
Workloads werden durch ein Manifest definiert, das ihre Identität, Funktionen, Routen, Ui-Einstiegspunkte und erforderliche Berechtigungen beschreibt. Das Manifest ist der Vertrag zwischen Ihrer Web-App und Fabric. Informationen zu Schema, Beispielen und Validierungsanleitungen finden Sie in der Manifestübersicht.
Elemente und einheimische Beteiligung
In der Regel tragen Workloads zu einem oder mehreren Elementtypen bei. Von Ihrer Workload erstellte Elemente werden in Arbeitsbereichen angezeigt und verhalten sich wie systemeigene Fabric-Elemente. Sie nehmen an der Zusammenarbeit und dem Teilen teil, sind in der Suche auffindbar, folgen operativen Lebenszyklusvorgängen und Governance und speichern Daten über OneLake, während sie Fabric-öffentliche APIs für CRUD verwenden.
End-to-End Fluss
- Ein Benutzer öffnet einen Arbeitsbereich und navigiert zu einem Element oder Einstiegspunkt, der von Ihrer Workload bereitgestellt wird.
- Das Fabric-Frontend lädt Ihre Webanwendung in einem iFrame basierend auf dem Manifest.
- Der Host erwirbt Microsoft Entra-Token mit den von Ihrer Workload benötigten Gültigkeitsbereichen und stellt eine Host-API für das iFrame bereit.
- Die Workload ruft Fabric-öffentliche APIs (und gegebenenfalls Ihre eigenen Dienste) mithilfe dieser Token auf.
- Elementdaten werden in OneLake gespeichert, und Elementmetadaten werden über Fabric-APIs verwaltet, sodass sie sich wie jedes andere Fabric-Element verhält.
Nächste Schritte
Informationen zum lokalen Entwickeln und Veröffentlichen Ihrer Workload finden Sie unter "Veröffentlichen Ihrer Workload". Anleitungen für Manifestschemas und lokale Entwicklung finden Sie unter Manifestübersicht, DevServer und DevGateway. Informationen zu API-Endpunkten, Bereichen und Identitätsrichtlinien finden Sie in den Fabric Public REST-APIs.