Bemærk
Adgang til denne side kræver godkendelse. Du kan prøve at logge på eller ændre mapper.
Adgang til denne side kræver godkendelse. Du kan prøve at ændre mapper.
I denne artikel beskrives arkitekturen i Microsoft Fabric Extensibility Toolkit, og hvordan brugerdefinerede arbejdsbelastninger integreres med Fabric-platformen. Den forklarer kørselskomponenterne, flowsene mellem Fabric-frontend, din arbejdsbelastning og Fabric-tjenester, og hvordan manifest- og elementmodellen får arbejdsbelastninger til at føles oprindelige i Fabric.
Arkitektoniske komponenter
Stof frontend (vært)
Fabric-frontend er værtsmiljøet. Den gengiver din arbejdsbelastning som en iFrame og eksponerer en sikker værts-API for iFrame, så arbejdsbelastningen kan interagere med Fabric, mens den forbliver isoleret. Værten er ansvarlig for at starte arbejdsbelastningen i henhold til dens manifest (indgangspunkter, ruter og funktioner), administrere godkendelsestokens via Microsoft Entra ID og formidle opkald fra arbejdsbelastningen til offentlige Fabric-API'er og platformstjenester.
Webprogram til arbejdsbelastning
Din arbejdsbelastning er en webapplikation (f.eks. React eller Angular), som du hoster i din cloud. Fabric indlæser det i en iFrame og leverer værts-API'er til integration med platformen. Appen implementerer de ruter og brugergrænsefladeoverflader, der er angivet i manifestet, bruger Microsoft Entra ID-tokens (leveret af værten) til at kalde offentlige Fabric-API'er og, hvis det er nødvendigt, dine egne backend-tjenester og følger Fabric UX-vejledningen, så den ser ud og fungerer som en oprindelig oplevelse.
Fabric-tjeneste og offentlige API'er
Fabric-tjenesten viser offentlige API'er til læsning og skrivning af metadata og indhold, administration af elementer og integration med platformsfunktioner. Arbejdsbelastninger kalder disse API'er ved hjælp af afgrænsede tokens, der er udstedt via Microsoft Entra ID – f.eks. for at udføre CRUD-handlinger og livscyklushandlinger for elementer, få adgang til data og indhold, der er gemt i OneLake, og deltage i arbejdsområdefunktioner som f.eks. søgning og registrering. Du kan finde slutpunkter, områder og identitetsvejledning under Fabric Public REST API'er.
Microsoft Entra (godkendelse)
Godkendelse og godkendelse håndteres af Microsoft Entra ID. Arbejdsbelastningens manifest angiver de tilladelser, den har brug for. Fabric-værten indhenter de relevante tokens og håndhæver samtykke og adgang i henhold til disse erklæringer.
Arbejdsbelastningsmodel og manifest
Arbejdsbelastninger defineres af et manifest, der beskriver deres identitet, egenskaber, ruter, indgangspunkter for brugergrænsefladen og påkrævede tilladelser. Manifestet er kontrakten mellem din webapp og Fabric. Du kan finde skemaet, eksemplerne og valideringsvejledningen under Manifestoversigt.
Genstande og indfødt deltagelse
Arbejdsbelastninger bidrager typisk med en eller flere varetyper. Elementer, der er oprettet af din arbejdsbelastning, vises i arbejdsområder og fungerer som oprindelige Fabric-elementer. De deltager i samarbejde og deling, kan findes i søgninger, følger livscyklushandlinger og styring og gemmer data via OneLake, mens de bruger offentlige Fabric-API'er til CRUD.
End-to-end-flow
- En bruger åbner et arbejdsområde og navigerer til et element eller indgangspunkt, der leveres af din arbejdsbelastning.
- Fabric-frontend indlæser dit webprogram i en iFrame baseret på manifestet.
- Værten henter Microsoft Entra-tokens med de områder, som din arbejdsbelastning kræver, og viser en værts-API for iFrame.
- Arbejdsbelastningen kalder offentlige Fabric-API'er (og, hvis det er relevant, dine egne tjenester) ved hjælp af disse tokens.
- Elementdata gemmes i OneLake, og elementmetadata administreres via Fabric API'er, så de opfører sig som enhver anden Fabric-vare.
Næste trin
Hvis du vil udvikle lokalt og publicere din arbejdsbelastning, skal du se Publicer din arbejdsbelastning. Du kan finde vejledning til manifestskema og lokal udvikling under Manifestoversigt, DevServer og DevGateway. Du kan finde API-slutpunkter, områder og identitetsvejledning under Offentlige REST-API'er til struktur.