Hvad er Microsoft Fabric Embed i Microsoft Fabric (forhåndsvisning)?

Microsoft Fabric Embed gør det muligt for dig at tilføje eller indlejre understøttede Microsoft Fabric-elementer i dine browserbaserede webapplikationer. Brug Fabric Embed, når du vil have brugere til at se og interagere med Fabric-indhold i dine applikationer i stedet for at åbne Fabric-portalen.

I denne artikel lærer du, hvordan Microsoft Fabric Embed fungerer, hvilke forhåndsvisningskrav der gælder, og hvilke Fabric-elementer du kan indlejre.

Hvad skal jeg bruge for at bruge Microsoft Fabric Embed?

Før du starter, bekræft at du har:

  • Adgang til en Microsoft Fabric-lejer og en delegeret adgangstoken for den indloggede Microsoft Entra-bruger.
  • Tilladelse til at oprette eller opdatere en Microsoft Entra ID-appregistrering
  • En aktiv Microsoft Fabric-kapacitet (F SKU)
  • Et Microsoft Fabric-arbejdsområde tildelt den kapacitet
  • Viewer eller højere adgang til arbejdsområdet, der indeholder Real-Time Dashboard-elementet
  • Et Real-Time dashboard-element, som du kan tilgå i arbejdsområdet
  • En JavaScript- eller TypeScript-webapplikation, der bruger Microsoft Entra ID-brugerlogin.
  • Node.js og npm installeret på din udviklingscomputer
  • Fabric Embed softwareudviklingskit (SDK)

Hvornår bør du bruge Microsoft Fabric Embed i Microsoft Fabric?

Fabric Embed viser Real-Time dashboard-analyser i de applikationer og arbejdsgange, som brugerne allerede bruger, såsom brugerdefinerede applikationer, portaler og forretningsarbejdsgange. Den indlejrede oplevelse bruger Fabric-styring, arbejdsområde-tilladelser og Microsoft Entra ID-brugeridentitet i stedet for en separat adgangsmodel.

Brug Microsoft Fabric Embed, når du har brug for:

  • Vis et Real-Time Dashboard inde i din JavaScript- eller TypeScript-webapplikation under offentlig forhåndsvisning
  • Lad brugerne blive i din applikation, mens de udforsker Fabric-indhold
  • Brug Microsoft Fabric-styring, Fabric-arbejdsområde-tilladelser og Microsoft Entra ID til adgangskontrol
  • Byg brugerbaserede indlejrede oplevelser for brugere, der allerede har adgang til det underliggende Fabric-element

Hvilke itemtyper understøtter Microsoft Fabric Embed preview?

Under offentlig forhåndsvisning understøtter Microsoft Fabric Embed kun Real-Time dashboards.

Hvordan fungerer autentificering og autorisation for Microsoft Fabric Embed-forhåndsvisning?

Microsoft Fabric Embed bruger delegeret brugerautentificering. Microsoft Entra ID udsteder et delegeret token til den indloggede bruger—dette er ikke et kun app- eller serviceprincipal-token. I denne brugerbaserede autentificeringsmodel indlejres indholdet på vegne af den indloggede bruger, og Fabric håndhæver adgang baseret på brugerens tilladelser.

Brug disse autentificerings- og autorisationskrav, når du planlægger en Microsoft Fabric Embed-forhåndsvisningsløsning:

Autentificeringskrav Microsoft Fabric Embed-forhåndsvisningsadfærd
Bruger-login Din applikation logger brugere ind med Microsoft Entra ID.
Delegeret token Din applikation anmoder om delegerede tilladelser til Fabric-embedding og adgang til genstande.
Arbejdsområde og adgang til genstande Den indloggede bruger skal have adgang til arbejdsområdet og Real-Time Dashboard-elementet samt realtidsdatakilderne fra dashboardet.
Omdiriger URI Din Microsoft Entra-appregistrering skal inkludere den omdirigerings-URI, som din applikation bruger.

Hvilken Fabric-kapacitet kræver Microsoft Fabric Embed?

Microsoft Fabric Embed kræver, at arbejdsområdet, der indeholder Real-Time Dashboard, bruger en Fabric kapacitet (F SKU). Fabric-kapacitet leverer beregningsressourcer til Fabric-arbejdsbelastninger og -elementer. Før du bygger en indlejret oplevelse, skal du tildele det arbejdsområde, der indeholder dashboardet, til en Fabric-kapacitet.

Kapacitetskrav Hvad det betyder for Microsoft Fabric Embed
Fabric kapacitet (F SKU) Real-Time Dashboard-arbejdsområdet skal bruge Fabric kapacitet til den indlejrede oplevelse.
Prøveversionskapacitet for stof Microsoft Fabric Embed understøtter Fabric-prøvekapaciteter, underlagt de begrænsninger, der er beskrevet i Fabric prøvekapacitet.

Begrænsninger for Microsoft Fabric Embed

Microsoft Fabric Embed offentlig forhåndsvisning har følgende begrænsninger:

  • Kun Real-Time dashboards understøttes – Du kan ikke indlejre andre Fabric varetyper med Microsoft Fabric Embed under offentlig forhåndsvisning.
  • Kun delegeret brugergodkendelse understøttes – brugere skal logge ind med Microsoft Entra ID. Service-principal (kun app) autentificering understøttes ikke.
  • App-owns-data embedding understøttes ikke – Microsoft Fabric Embed preview understøtter ikke app-only tokens eller embedding af indhold for brugere, der ikke har adgang til Fabric-elementet. Den indloggede bruger skal kunne åbne varen i Fabric.
  • Power BI-elementer bruger Power BI embedded analytics - Brug Power BI embedded analytics til at indlejre Power BI-rapporter, dashboards eller fliser; Microsoft Fabric Embed-forhåndsvisning indlejrer dem ikke som Fabric-elementer.
  • Forhåndsvisningskontrakter kan ændre sig – SDK-pakkenavnet, API-overfladen, begivenheder, typenavne og konfigurationskontrakter kan ændre sig før generel tilgængelighed. Tjek public-preview-udgivelsesnoterne, før du opdaterer din ansøgning.

Næste trin

Brug disse ressourcer til at forberede identitet, kapacitet og produktkontekst for en Microsoft Fabric Embed preview-løsning: