Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Configurare Microsoft Fabric Incorpora prima di incorporare un elemento dashboard Real-Time in un'applicazione Web JavaScript o TypeScript. È necessario disporre di un'area di lavoro assegnata a una capacità Microsoft Fabric, all'accesso utente all'elemento dashboard Real-Time, a una registrazione Microsoft Entra ID dell'app con autorizzazioni delegate e agli strumenti di sviluppo locali.
Microsoft Fabric Embed è una funzionalità di anteprima pubblica per l'incorporamento di elementi Microsoft Fabric supportati.
Annotazioni
Microsoft Fabric Embed è disponibile in anteprima pubblica. Per informazioni sui tipi di elementi supportati, sull'autenticazione e sulle limitazioni del contratto di anteprima, vedere Limitazioni per Microsoft Fabric Embed.
Prerequisiti per la configurazione dell'incorporamento di Microsoft Fabric
Per un elenco dei prerequisiti, vedere Cosa è necessario usare Microsoft Fabric Embed?
Configurare l'area di lavoro Fabric
Microsoft Fabric Embed supporta l'accesso utente delegato. L'utente Microsoft Entra ID che ha effettuato l'accesso deve essere in grado di aprire l'elemento Dashboard in tempo reale in Microsoft Fabric prima che lo stesso elemento possa essere visualizzato in un'applicazione incorporata.
- Apri Microsoft Fabric.
- Aprire l'area di lavoro che contiene l'elemento dashboard Real-Time.
- Verificare che l'area di lavoro sia assegnata a una capacità Microsoft Fabric attiva.
- Assicurarsi che gli utenti che visualizzano l'elemento Dashboard in tempo reale incorporato abbiano un accesso di tipo Viewer o superiore all'area di lavoro e all'elemento Dashboard in tempo reale.
Verifica dell'esito positivo: l'area di lavoro mostra un'assegnazione di capacità attiva e l'utente può aprire l'elemento dashboard Real-Time direttamente nel portale di Microsoft Fabric.
Importante
Se un utente che ha effettuato l'accesso non ha accesso all'area di lavoro o all'elemento Dashboard in tempo reale in Microsoft Fabric, Microsoft Fabric Embed non visualizza l'elemento nell'applicazione incorporata.
Registrare un'app Microsoft Entra ID per l'accesso utente
La tua applicazione JavaScript o TypeScript richiede la registrazione di un'app Microsoft Entra ID per consentire agli utenti di eseguire l'accesso e richiedere token di accesso delegati per Microsoft Fabric Embed.
Accedi al portale di Azure.
Selezionare il tenant Microsoft Entra selezionando il proprio account nell'angolo in alto a destra della pagina.
Selezionare Registrazioni app. Se non vedi questa opzione, cercala.
In Registrazioni app selezionare Nuova registrazione.
Compilare i campi seguenti:
- Nome : assegnare un nome all'applicazione.
- Tipo di account supportato : selezionare chi può usare l'applicazione. Seleziona Solo account in questa directory organizzativa per le app a tenant singolo, o Account in qualsiasi directory organizzativa per scenari tra tenant.
(Facoltativo) Nella casella URI di reindirizzamento aggiungere un URL di reindirizzamento.
Selezionare Registrazione. Dopo aver registrato l'app, si viene indirizzati alla pagina di panoramica dell'app, in cui è possibile ottenere l'ID applicazione. Copiare e salvare l'ID applicazione e tutte le informazioni nella casella Riepilogo per un uso successivo. L'ambiente di incorporamento Microsoft Fabric è pronto per l'uso.
Verifica riuscita: la panoramica della registrazione dell'app mostra l'ID client e l'ID tenant usati dall'applicazione per l'autenticazione di Libreria di Autenticazione Microsoft (MSAL).
Annotazioni
Mantenere disponibili questi valori. Le si usano quando si configura l'autenticazione nell'applicazione.
Aggiungere autorizzazioni API delegate per Microsoft Fabric Embed
L'app deve richiedere autorizzazioni API delegate per l'incorporazione in Fabric, l'accesso in lettura agli elementi e il rilevamento facoltativo dell'area di lavoro. Usare le autorizzazioni utente delegate per Microsoft Fabric Embed.
Nella registrazione dell'app aprire le autorizzazioni api.
Seleziona Aggiungi autorizzazione.
Aggiungere le autorizzazioni delegate corrispondenti allo scenario.
Se l'organizzazione richiede il consenso dell'amministratore, chiedi a un amministratore del tenant di concederlo.
Annotazioni
Richiedere le autorizzazioni delegate con privilegi minimi per lo scenario:
| Autorizzazione | Quando usarlo | Purpose |
|---|---|---|
Fabric.Embed |
Obbligatorio per l'incorporamento di Microsoft Fabric. | Consente all'applicazione di incorporare elementi Microsoft Fabric supportati. |
KQLDashboard.Read.All |
Autorizzazione di lettura preferita per gli elementi del dashboard in tempo reale. | Consente all'applicazione di leggere gli elementi del Dashboard in tempo reale a cui l'utente che ha effettuato l'accesso può accedere. |
Item.Read.All |
Usare solo se lo scenario richiede un accesso in lettura più esteso agli elementi di Fabric. | Consente all'applicazione di leggere gli elementi di Fabric a cui l'utente che ha effettuato l'accesso può accedere. |
Workspace.Read.All |
Obbligatorio solo quando l'applicazione usa Microsoft Fabric API REST per individuare gli ID dell'area di lavoro o degli elementi. | Consente l'individuazione in sola lettura delle aree di lavoro per l'utente autenticato. |
Verifica riuscita: la registrazione dell'app include Fabric.Embed, un'autorizzazione di lettura di un elemento e Workspace.Read.All solo se l'applicazione usa api REST Microsoft Fabric per individuare gli ID.
Installare gli strumenti di sviluppo locali per l'app Web
Installare questi strumenti e librerie per l'applicazione JavaScript o TypeScript che ospita l'elemento dashboard Real-Time incorporato:
- Node.js e npm per l'installazione del pacchetto Fabric Embed SDK
- Un editor di codice, ad esempio Visual Studio Code
- Libreria di Autenticazione Microsoft (MSAL) per JavaScript per l'autenticazione con Microsoft Entra ID
Installare il pacchetto SDK di incorporamento Fabric nell'app Web
Installare il pacchetto Fabric Embed SDK in anteprima pubblica nell'applicazione web che ospita l'elemento Real-Time Dashboard incorporato. Il nome e la versione del pacchetto potrebbero cambiare durante l'anteprima. Usare il nome del pacchetto fornito dalla versione di anteprima.
npm install @microsoft/fabric-embed
Verifica riuscita: il pacchetto SDK Fabric Embed è presente nelle dipendenze package.json dell'applicazione.
Recupera gli ID dell'area di lavoro e della dashboard in tempo reale
È anche possibile recuperare programmaticamente l'ID dell'area di lavoro e l'ID dell'elemento del dashboard in tempo reale usando le API REST di Microsoft Fabric. Usare Microsoft Fabric API REST quando lo script di installazione o l'applicazione deve individuare gli ID anziché copiarli dal portale di Microsoft Fabric.
Ottenere l'ID dell'area di lavoro con l'API Elenca aree di lavoro:
GET https://api.fabric.microsoft.com/v1/workspacesTrovare l'area di lavoro in base al relativo
displayNamevalore e copiarne ilidvalore.Ottieni l'ID dell'elemento del dashboard in tempo reale con l'API List Items:
GET https://api.fabric.microsoft.com/v1/workspaces/<workspaceId>/items?type=KQLDashboardSostituire
<workspaceId>con l'ID dell'area di lavoro del passaggio precedente. Nella risposta trovare l'elemento Real-Time Dashboard in base al relativodisplayNamee copiarne ilidvalore. Usa tale valore come ID dell'elemento nella configurazione dell'incorporamento.
Annotazioni
Nell'API REST Microsoft Fabric il valore del tipo di elemento per un elemento Real-Time Dashboard è KQLDashboard.
Facoltativamente, convalidare l'ID elemento chiamando:
GET https://api.fabric.microsoft.com/v1/workspaces/<workspaceId>/items/<itemId>
Usa l'API Get Item per verificare che l'ID dell'area di lavoro e l'ID dell'elemento identifichino l'elemento Real-Time Dashboard previsto.
Verifica riuscita: la risposta di List Items include il dashboard previsto displayName, un valore id per l'ID dell'elemento e il valore del tipo di elemento KqlDashboard.