Aseta Microsoft Fabric Embed Real-Time Dashboardin kohteille

Aseta Microsoft Fabric Embed ennen kuin upotat Real-Time Dashboardin kohteen JavaScript- tai TypeScript-verkkosovellukseen. Sinulla tulisi olla työtila, joka on määritetty Microsoft Fabric-kapasiteetille, käyttäjän pääsy Real-Time Dashboard-kohteeseen, Microsoft Entra ID-sovelluksen rekisteröinti delegoiduilla käyttöoikeuksilla sekä paikalliset kehitystyökalut.

Microsoft Fabric Embed on julkinen esikatseluominaisuus tuettujen Microsoft Fabric -kohteiden upottamiseen.

Microsoft Fabric Embed -asennuksen edellytykset

Ennakkovaatimusten listan löydät kohdasta Mitä tarvitsen käyttääkseni Microsoft Fabric Embediä?

Määritä Fabric-työtilasi

Microsoft Fabric Embed tukee delegoitua käyttäjäoikeutta. Kirjautuneen Microsoft Entra ID käyttäjän täytyy pystyä avaamaan Real-Time Dashboardin kohde Microsoft Fabric ennen kuin sama kohde voidaan renderöidä sulautetussa sovelluksessa.

1. Avaa Microsoft Fabric.
2. Avaa työtila, joka sisältää Real-Time Dashboardin kohteen.
3. Vahvista, että työtila on määritetty aktiiviseen Microsoft Fabric -kapasiteettiin.
4. Varmista, että käyttäjät, jotka näkevät upotetun Real-Time Dashboard-kohteen, saavat Viewerin tai laajemman pääsyn työtilaan ja Real-Time Dashboard-kohteeseen.

Onnistumisen tarkistus: työtila näyttää aktiivisen kapasiteettimäärityksen, ja käyttäjä voi avata Real-Time Dashboardin kohteen suoraan Microsoft Fabric-portaalissa.

Rekisteröi Microsoft Entra ID -sovellus käyttäjän kirjautumista varten

JavaScript- tai TypeScript-sovelluksesi tarvitsee Microsoft Entra ID -sovelluksen rekisteröinnin kirjautuakseen sisään ja pyytääkseen delegoituja pääsytunnuksia Microsoft Fabric Embedille.

1. Kirjaudu sisään Azure-portaaliin.

2. Valitse Microsoft Entra -vuokralainen valitsemalla tilisi sivun oikeasta yläkulmasta.

3. Valitse App registrations. Jos et näe tätä vaihtoehtoa, etsi se.

4. App registrations-osiossa valitse Uusi rekisteröinti.

5. Täytä kentät seuraavasti:

   • Nimi – Anna hakemuksellesi nimi.
   • Tuettu tilityyppi – Valitse, kuka voi käyttää sovellusta. Valitse Tilit tästä organisaatiohakemistosta vain yksittäisille vuokralaisille tarkoitetuille sovelluksille tai Tilit mistä tahansa organisaatiohakemistosta eri vuokralaisille skenaarioille.

6. (Valinnainen) Lisää Redirect URI -kenttään uudelleenohjaus-URL.

7. Valitse Rekisteröi. Kun hakemuksesi on rekisteröity, sinut ohjataan sovelluksesi yleiskatsaussivulle, josta voit saada sovellustunnuksen. Kopioi ja tallenna sovellustunnus sekä kaikki tiedot Yhteenveto-kenttään myöhempää käyttöä varten. Microsoft Fabric Embed -ympäristösi on käyttövalmis.

Onnistumistarkistus: sovelluksen rekisteröinnin yleiskatsaus näyttää asiakastunnuksen ja tenant-ID:n, joita sovelluksesi käyttää Microsoft Authentication Library (MSAL) -tunnistautumiseen.

Lisää delegoidut API-oikeudet Microsoft Fabric Embedille

Sovelluksesi on pyydettävä delegoituja API-oikeuksia Fabric-upotukseen, esineiden lukukäyttöön ja valinnaiseen työtilan löytämiseen. Käytä delegoituja käyttöoikeuksia Microsoft Fabric Embediin.

1. Sovelluksen rekisteröinnissä avaa API-oikeudet.

2. Valitse Lisää käyttöoikeus.

3. Lisää delegoidut oikeudet, jotka vastaavat tilanteeseesi.

4. Jos organisaatiosi vaatii ylläpitäjän suostumuksen, pyydä vuokralaisen ylläpitäjää myöntämään suostumus.

   

Onnistumisen tarkistus: sovelluksen rekisteröinti sisältää Fabric.Embed, yhden kohteen lukuoikeudet, ja Workspace.Read.All vain, jos sovelluksesi käyttää Microsoft Fabric REST -rajapintoja tunnisteiden löytämiseen.

Asenna paikalliset kehitystyökalut verkkosovelluksellesi

Asenna nämä työkalut ja kirjastot JavaScript- tai TypeScript-sovellukselle, joka isännöi upotettua Real-Time Dashboard-elementtiä:

• Node.js ja npm Fabric Embed SDK -paketin asentamiseen
• Koodieditori, kuten Visual Studio Code
• The Microsoft Authentication Library (MSAL) for JavaScript for Microsoft Entra ID -autentikointi

Asenna Fabric Embed SDK -paketti verkkosovellukseesi

Asenna julkinen esikatselu Fabric Embed SDK -paketti web-sovellukseen, joka isännöi upotettua Real-Time Dashboard-laitetta. Paketin nimi ja versio saattavat muuttua esikatselun aikana. Käytä esikatseluversion tarjoamaa paketin nimeä.

npm install @microsoft/fabric-embed

Onnistumisen tarkistus: Fabric Embed SDK -paketti näkyy sovelluksesi package.json riippuvuuksissa.

Kerää työtila ja Real-Time hallintapaneelin tunnisteet

Voit myös kerätä työtilan ID:n ja Real-Time Dashboardin kohde-ID:n ohjelmallisesti käyttämällä Microsoft Fabric REST-rajapintoja. Käytä Microsoft Fabric REST -rajapintoja, kun asennusskriptisi tai sovelluksesi tarvitsee löytää ID:t sen sijaan, että kopioisit ne Microsoft Fabric -portaalista.

1. Hanki työtilan ID List Workspaces API:n avulla:

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

   Etsi työtila sen displayName perusteella ja kopioi sen id arvo.

2. Hanki Real-Time Dashboard item ID List Items API:lla:

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

   Korvaa <workspaceId> edellisen vaiheen työtilan ID:llä. Vastauksessa etsi Real-Time Dashboardin kohde sen displayNameperusteella ja kopioi sen id arvo. Käytä tuota arvoa kohteen ID:nä upotuksen konfiguraatiossa.

Halutessasi voit validoida tuotteen tunnisteen kutsumalla:

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

Käytä Get Item API:ta varmistaaksesi, että työtilan ID ja item ID tunnistavat odotetun Real-Time Dashboardin kohteen.

Onnistumistarkistus: Lista Items -vastaus sisältää odotetun hallintapaneelin displayName, id arvon tuotetunnisteelle ja kohdetyypin arvon KqlDashboard.

Seuraavat vaiheet

• Mikä on Microsoft Fabric Embed?
• Pikakäynnistys: Upota Fabric-kohde Microsoft Fabric Embedillä
• Sovelluksen rekisteröiminen Microsoft Entra -tunnukseen
• Mikä on Real-Time tiedustelu Microsoft Fabric?