Sett opp Microsoft Fabric Embed for Real-Time Dashboard-elementer

Sett opp Microsoft Fabric Embed før du legger inn et Real-Time Dashboard-element i en JavaScript- eller TypeScript-webapplikasjon. Du bør ha et arbeidsområde tildelt en Microsoft Fabric kapasitet, brukertilgang til Real-Time Dashboard-elementet, en Microsoft Entra ID appregistrering med delegerte tillatelser, og lokale utviklingsverktøy.

Microsoft Fabric Embed er en offentlig forhåndsvisningsfunksjon for å integrere støttede Microsoft Fabric-elementer.

Forutsetninger for oppsett av Microsoft Fabric Embed

For en liste over forutsetninger, se Hva trenger jeg for å bruke Microsoft Fabric Embed?

Konfigurer ditt Fabric-arbeidsområde

Microsoft Fabric Embed støtter delegert brukertilgang. Den innloggede Microsoft Entra ID brukeren må kunne åpne det Real-Time dashbord-elementet i Microsoft Fabric før det samme elementet kan vises i en innebygd applikasjon.

1. Åpne Microsoft Fabric.
2. Åpne arbeidsområdet som inneholder Real-Time Dashboard-elementet.
3. Bekreft at arbeidsområdet er tildelt en aktiv Microsoft Fabric-kapasitet.
4. Bekreft at brukere som ser det innebygde Real-Time dashboard-elementet har Viewer eller høyere tilgang til arbeidsområdet og Real-Time dashboard-elementet.

Suksesssjekk: arbeidsområdet viser en aktiv kapasitetstildeling, og brukeren kan åpne Real-Time Dashbord-elementet direkte i Microsoft Fabric-portalen.

Registrer en Microsoft Entra ID-app for brukerinnlogging

Din JavaScript- eller TypeScript-applikasjon trenger en Microsoft Entra ID-appregistrering for å logge inn brukere og be om delegerte tilgangstokler for Microsoft Fabric Embed.

1. Logg på Azure-portalen.

2. Velg din Microsoft Entra-leietaker ved å velge kontoen din øverst til høyre på siden.

3. Velg App registrations. Hvis du ikke ser dette alternativet, søk etter det.

4. I App registrations, velg Ny registrering.

5. Fyll ut følgende felter:

   • Navn – Gi søknaden ditt et navn.
   • Støttet kontotype – Velg hvem som kan bruke applikasjonen. Velg kontoer i denne organisasjonskatalogen kun for enkeltleietakerapper, eller kontoer i en hvilken som helst organisasjonskatalog for scenarier med flere leietakere.

6. (Valgfritt) I omlednings-URI-boksen , legg til en omdirigerings-URL.

7. Velg Registrer. Etter at appen din er registrert, blir du sendt til appens oversiktsside, hvor du kan hente applikasjons-ID-en. Kopier og lagre applikasjons-ID-en og all informasjon i Sammendragsboksen for senere bruk. Ditt Microsoft Fabric Embed-miljø er klart til bruk.

Suksesssjekk: Oversikt over app-registrering viser klient-ID og leietaker-ID som applikasjonen din bruker for Microsoft Authentication Library (MSAL)-autentisering.

Legg til delegerte API-tillatelser for Microsoft Fabric Embed

Appen din må be om delegerte API-tillatelser for Fabric-embedding, tilgang til gjenstandslesing og valgfri oppdagelse av arbeidsområdet. Bruk delegerte brukertillatelser for Microsoft Fabric Embed.

1. I appregistreringen din, åpne API-tillatelser.

2. Velg Legg til en tillatelse.

3. Legg til de delegerte tillatelsene som passer til ditt scenario.

4. Hvis organisasjonen din krever administratorsamtykke, be en leietakeradministrator om å gi samtykke.

   

Suksesssjekk: appregistreringen inkluderer Fabric.Embed, én lesetillatelse for elementer, og Workspace.Read.All kun hvis applikasjonen din bruker Microsoft Fabric REST API-er for å oppdage ID-er.

Installer lokale utviklingsverktøy for webappen din

Installer disse verktøyene og bibliotekene for JavaScript- eller TypeScript-applikasjonen som hoster det innebygde Real-Time Dashboard-elementet:

• Node.js og npm for installasjon av Fabric Embed SDK-pakken
• En kodeeditor, som Visual Studio Code
• The Microsoft Authentication Library (MSAL) for JavaScript for Microsoft Entra ID-autentisering

Installer Fabric Embed SDK-pakken i webappen din

Installer den offentlige forhåndsvisningen Fabric Embed SDK-pakken i nettapplikasjonen som hoster det innebygde Real-Time Dashboard-elementet. Pakkenavn og versjon kan endres under forhåndsvisningen. Bruk pakkenavnet som forhåndsvisningen din gir.

npm install @microsoft/fabric-embed

Suksesssjekk: Fabric Embed SDK-pakken vises i applikasjonens package.json avhengigheter.

Samle arbeidsområde og Real-Time dashbord-ID-er

Du kan også samle inn arbeidsområde-ID og Real-Time dashboard-item-ID programmatisk ved å bruke Microsoft Fabric REST-API-er. Bruk Microsoft Fabric REST API-er når oppsettsskriptet eller applikasjonen din trenger å oppdage ID-er i stedet for å kopiere dem fra Microsoft Fabric-portalen.

1. Få arbeidsområdets ID med List Workspaces API:

   GET https://api.fabric.microsoft.com/v1/workspaces
   

   Finn arbeidsområdet etter dets displayName og kopier verdien dens id .

2. Få Real-Time Dashboard-item-ID med List Items API:

   GET https://api.fabric.microsoft.com/v1/workspaces/<workspaceId>/items?type=KQLDashboard
   

   Bytt ut <workspaceId> med arbeidsområdets ID fra forrige steg. I svaret, finn Real-Time Dashboard-elementet ved dens displayName, og kopier verdien dens id . Bruk den verdien som vare-ID i din embed-konfigurasjon.

Eventuelt kan du validere vare-ID-en ved å ringe:

GET https://api.fabric.microsoft.com/v1/workspaces/<workspaceId>/items/<itemId>

Bruk Get Item API for å bekrefte at arbeidsområde-ID og item-ID identifiserer det forventede Real-Time dashbord-elementet.

Suksesssjekk: Listen over elementer-svaret inkluderer forventet dashbord displayName, en id verdi for vare-ID-en og varetype-verdien KqlDashboard.

Neste trinn

• Hva er Microsoft Fabric Embed?
• Quickstart: Embed et Fabric-element med Microsoft Fabric Embed
• Registrer et program i Microsoft Entra ID
• Hva er Real-Time intelligens i Microsoft Fabric?