Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
In dit artikel wordt de architectuur van de Microsoft Fabric Extensibility Toolkit beschreven en wordt beschreven hoe aangepaste workloads worden geïntegreerd met het Fabric-platform. Hierin worden de runtimeonderdelen uitgelegd, stromen tussen de Fabric-frontend, uw workload en Fabric-services en hoe het manifest- en itemmodel ervoor zorgt dat workloads natuurlijk geïntegreerd zijn in Fabric.
Architectuuronderdelen
Fabric front-end (host)
De Fabric-frontend is de hostomgeving. Uw workload wordt weergegeven als een iFrame en maakt een beveiligde host-API beschikbaar voor het iFrame, zodat de workload kan communiceren met Fabric terwijl deze geïsoleerd blijft. De host is verantwoordelijk voor het opstarten van de workload op basis van het manifest (toegangspunten, routes en mogelijkheden), het beheren van verificatietokens via Microsoft Entra ID en het mediateren van aanroepen van de workload naar openbare Fabric-API's en platformservices.
Webtoepassing voor werkbelasting
Uw workload is een webtoepassing (bijvoorbeeld React of Angular) die u in uw cloud host. Fabric laadt het in een iFrame en biedt host-API's om te integreren met het platform. De app implementeert de routes en ui-oppervlakken die zijn gedeclareerd in het manifest, maakt gebruik van Microsoft Entra ID-tokens (geleverd door de host) om openbare Fabric-API's aan te roepen en, indien nodig, uw eigen back-endservices en volgt de UX-richtlijnen van Fabric, zodat deze eruitziet en zich gedraagt als een systeemeigen ervaring.
Fabric-service en openbare API's
De Fabric-service bevat openbare API's voor het lezen en schrijven van metagegevens en inhoud, het beheren van items en het integreren met platformmogelijkheden. Workloads roepen deze API's aan met behulp van scoped tokens die zijn uitgegeven via Microsoft Entra ID, bijvoorbeeld om CRUD-bewerkingen en levenscyclusacties voor items uit te voeren, toegang te krijgen tot gegevens en inhoud die zijn opgeslagen in OneLake, en deel te nemen aan functies van de werkruimte zoals zoeken en ontdekken. Zie voor eindpunten, scopes en identiteitsrichtlijnen de openbare REST API's van Fabric.
Microsoft Entra (verificatie)
Verificatie en autorisatie worden verwerkt door Microsoft Entra-id. Het manifest van de workload declareert de benodigde machtigingen; de Fabric-host verkrijgt de juiste tokens en dwingt toestemming en toegang af op basis van deze declaraties.
Workloadmodel en manifest
Workloads worden gedefinieerd door een manifest dat de identiteit, mogelijkheden, routes, toegangspunten van de gebruikersinterface en de vereiste machtigingen beschrijft. Het manifest is het contract tussen uw web-app en Fabric. Zie Manifestoverzicht voor het schema, voorbeelden en validatierichtlijnen.
Items en systeemeigen deelname
Workloads dragen doorgaans een of meer itemtypen bij. Items die door uw workload zijn gemaakt, worden weergegeven in werkomgevingen en gedragen zich als natuurlijke Fabric-items. Ze nemen deel aan samenwerking en delen, zijn detecteerbaar in zoekopdrachten, volgen levenscyclusbewerkingen en governance en slaan gegevens op via OneLake terwijl ze openbare Fabric-API's voor CRUD gebruiken.
End-to-endproces
- Een gebruiker opent een werkruimte en navigeert naar een item of toegangspunt dat door uw workload wordt geleverd.
- De front-end Fabric laadt uw webtoepassing in een iFrame op basis van het manifest.
- De host verkrijgt Microsoft Entra-tokens met de scopes die uw workload nodig heeft en stelt een host-API beschikbaar voor het iFrame.
- De workload roept openbare Fabric-API's (en, indien van toepassing, uw eigen services) aan met behulp van deze tokens.
- Itemgegevens worden opgeslagen in OneLake en metagegevens van items worden beheerd via Fabric-API's, zodat deze zich gedraagt als elk ander Fabric-item.
Volgende stappen
Zie Uw workload publiceren om uw workload lokaal te ontwikkelen en te publiceren. Zie Manifestoverzicht, DevServer en DevGateway voor richtlijnen voor manifestschema's en lokale ontwikkeling. Zie de openbare REST API's van Fabric voor API-eindpunten, bereiken en identiteitsrichtlijnen.