Che cos'è Microsoft Fabric Embed in Microsoft Fabric (anteprima)?

Microsoft Fabric Embed consente di aggiungere o incorporare elementi Microsoft Fabric supportati nelle applicazioni Web basate su browser. Usa Fabric Embed quando vuoi che gli utenti visualizzino e interagiscano con i contenuti di Fabric all'interno delle tue applicazioni invece di aprire il portale Fabric.

Questo articolo illustra come funziona Microsoft Fabric Embed, quali requisiti di anteprima si applicano e quali Fabric elementi che è possibile incorporare.

Cosa è necessario usare Microsoft Fabric Embed?

Prima di iniziare, verificare di avere:

  • Accesso a un tenant Microsoft Fabric e a un token di accesso delegato per l'utente Microsoft Entra connesso.
  • Autorizzazione per creare o aggiornare una registrazione dell'app Microsoft Entra ID
  • Una capacità Microsoft Fabric (SKU F) attiva
  • Un'area di lavoro Microsoft Fabric assegnata a tale capacità
  • Visualizzatore o accesso superiore all'area di lavoro che contiene l'elemento del dashboard Real-Time
  • Elemento del dashboard Real-Time a cui è possibile accedere nell'area di lavoro
  • Applicazione web JavaScript o TypeScript che usa l'accesso utente con Microsoft Entra ID
  • Node.js e npm installati nel computer di sviluppo
  • Fabric Embed Software Development Kit (SDK)

Quando è consigliabile usare Microsoft Fabric Embed in Microsoft Fabric?

Fabric Embed visualizza le analisi dei dashboard in tempo reale nelle applicazioni e nei flussi di lavoro che gli utenti già utilizzano, ad esempio applicazioni personalizzate, portali e flussi di lavoro aziendali. L'esperienza incorporata usa la governance di Fabric, le autorizzazioni dell'area di lavoro e l'identità utente di Microsoft Entra ID anziché un modello di accesso separato.

Usa Microsoft Fabric Embed quando devi:

  • Mostrare una dashboard in tempo reale all'interno della tua applicazione web JavaScript o TypeScript durante l'anteprima pubblica
  • Consentire agli utenti di rimanere nella tua applicazione mentre esplorano i contenuti di Fabric
  • Usa la governance di Microsoft Fabric, le autorizzazioni dell'area di lavoro di Fabric e Microsoft Entra ID per il controllo degli accessi
  • Creare esperienze integrate basate sull'utente per gli utenti che hanno già accesso all'elemento Fabric sottostante

Quali tipi di elementi supporta l'anteprima di incorporamento di Microsoft Fabric?

Durante l'anteprima pubblica, Microsoft Fabric Embed supporta solo i dashboard Real-Time.

Come funziona l'autenticazione e l'autorizzazione per l'anteprima di Microsoft Fabric Embed?

Microsoft Fabric Embed usa l'autenticazione utente delegata. Microsoft Entra ID rilascia un token delegato per l’utente che ha effettuato l’accesso: non si tratta di un token solo applicazione né di un token service principal. In questo modello di autenticazione basato sull'utente, il contenuto viene incorporato per conto dell'utente connesso e Fabric applica l'accesso in base alle autorizzazioni dell'utente.

Usare questi requisiti di autenticazione e autorizzazione quando si pianifica una soluzione di anteprima di incorporamento Microsoft Fabric:

Requisito di autenticazione Comportamento dell'anteprima di Microsoft Fabric Embed
Accesso utente L'applicazione consente agli utenti di accedere con Microsoft Entra ID.
Token delegato L'applicazione richiede autorizzazioni delegate per l'incorporamento in Fabric e l'accesso agli elementi.
Accesso all'area di lavoro e all'elemento L'utente connesso deve avere accesso all'area di lavoro e all'elemento del dashboard Real-Time e alle origini dati del dashboard in tempo reale.
URI di reindirizzamento La registrazione dell'app Microsoft Entra deve includere l'URI di reindirizzamento usato dall'applicazione.

Quale capacità di Fabric richiede Microsoft Fabric Embed?

Microsoft Fabric Embed richiede che l'area di lavoro che contiene il dashboard in tempo reale usi una capacità Fabric (SKU F). La capacità di Fabric fornisce risorse di calcolo per i carichi di lavoro e gli elementi di Fabric. Prima di creare un'esperienza incorporata, assegnare l'area di lavoro che contiene il dashboard a una capacità di Fabric.

Requisito di capacità Che cosa significa per Microsoft Fabric Embed
Capacità Fabric (F SKU) L'area di lavoro Dashboard in tempo reale deve utilizzare la capacità Fabric per l'esperienza incorporata.
Capacità di prova del fabric Microsoft Fabric Embed supporta le capacità di valutazione Fabric, soggette alle limitazioni descritte in Fabric capacità di valutazione.

Limitazioni per l'incorporamento di Microsoft Fabric

L'anteprima pubblica della funzionalità di incorporamento di Microsoft Fabric presenta le seguenti limitazioni:

  • Sono supportati solo Real-Time dashboard: non è possibile incorporare altri tipi di elementi Fabric con Microsoft Fabric Incorpora durante l'anteprima pubblica.
  • È supportata solo l'autenticazione utente delegata: gli utenti devono accedere con Microsoft Entra ID. L'autenticazione tramite service principal (solo app) non è supportata.
  • L'incorporamento app-owns-data non è supportato - L'anteprima di incorporamento di Microsoft Fabric non supporta i token solo-app né l'incorporamento di contenuti per utenti che non hanno accesso all'elemento Fabric. L'utente connesso deve essere in grado di aprire l'elemento in Fabric.
  • Gli elementi di Power BI usano l'analisi incorporata di Power BI - Usare l'analisi incorporata di Power BI per incorporare report, dashboard o riquadri di Power BI; l'anteprima di incorporamento di Microsoft Fabric non li incorpora come elementi di Fabric.
  • I contratti di anteprima possono cambiare : il nome del pacchetto SDK, la superficie API, gli eventi, i nomi dei tipi e i contratti di configurazione potrebbero cambiare prima della disponibilità generale. Controllare le note sulla versione di anteprima pubblica prima di aggiornare l'applicazione.

Passaggi successivi

Usare queste risorse per preparare l'identità, la capacità e il contesto del prodotto per una soluzione di anteprima di incorporamento Microsoft Fabric:

  • Last updated on