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.
Questo articolo descrive l'architettura di Microsoft Fabric Extensibility Toolkit e il modo in cui i carichi di lavoro personalizzati si integrano con la piattaforma Fabric. Vengono illustrati i componenti di runtime, i flussi tra il front-end di Fabric, i carichi di lavoro e i servizi di Fabric, e il modo in cui il modello del manifesto e dell'elemento rendono i carichi di lavoro nativi in Fabric.
Componenti dell'architettura
Front-end del Fabric (host)
Il front-end di Fabric è l'ambiente host. Esegue il rendering del carico di lavoro come iFrame ed espone un'API host sicura all'iFrame in modo che il carico di lavoro possa interagire con Fabric mentre rimane isolato. L'host è responsabile dell'avvio del carico di lavoro secondo il manifesto (punti di ingresso, percorsi e funzionalità), della gestione dei token di autenticazione tramite Microsoft Entra ID e della mediazione delle chiamate dal carico di lavoro alle API pubblici e ai servizi della piattaforma di Fabric.
Applicazione Web del carico di lavoro
Il carico di lavoro è un'applicazione Web , ad esempio React o Angular, ospitata nel cloud. Fabric lo carica in un iFrame e fornisce API host per l'integrazione con la piattaforma. L'app implementa le route e le superfici dell'interfaccia utente dichiarate nel relativo manifesto, usa i token ID di Microsoft Entra (forniti dall'host) per chiamare le API pubbliche di Fabric e, se necessario, i propri servizi back-end e segue le linee guida per l'esperienza utente di Fabric in modo che sembri e si comporti come un'esperienza nativa.
Servizio e API pubbliche di Fabric
Il servizio Fabric espone le API pubbliche per la lettura e la scrittura di metadati e contenuto, la gestione degli elementi e l'integrazione con le funzionalità della piattaforma. I carichi di lavoro chiamano queste API usando token con ambito emessi tramite Microsoft Entra ID, ad esempio per eseguire operazioni CRUD sugli elementi e azioni del ciclo di vita, accedere ai dati e al contenuto archiviati in OneLake e partecipare alle funzionalità dell'area di lavoro, ad esempio ricerca e individuazione. Per informazioni su endpoint, ambiti e linee guida sull'identità, vedere le API REST pubbliche di Fabric.
Microsoft Entra (autenticazione)
L'autenticazione e l'autorizzazione vengono gestite dall'ID Microsoft Entra. Il manifesto del carico di lavoro dichiara le autorizzazioni necessarie; L'host fabric ottiene i token appropriati e applica il consenso e l'accesso in base a tali dichiarazioni.
Modello del carico di lavoro e manifesto
I carichi di lavoro sono definiti da un manifesto che descrive l'identità, le funzionalità, le route, i punti di ingresso dell'interfaccia utente e le autorizzazioni necessarie. Il manifesto è il contratto tra l'app Web e Fabric. Per informazioni su schema, esempi e indicazioni sulla convalida, vedere Panoramica del manifesto.
Elementi e partecipazione nativa
I carichi di lavoro in genere contribuiscono con uno o più tipi di elementi. Gli elementi creati dal carico di lavoro vengono visualizzati nelle aree di lavoro e si comportano come elementi nativi di Fabric. Partecipano alla collaborazione e alla condivisione, sono individuabili nella ricerca, seguono le operazioni e la governance del ciclo di vita e archiviano i dati tramite OneLake usando le API pubbliche di Fabric per CRUD.
Flusso da un capo all'altro
- Un utente apre un'area di lavoro e passa a un elemento o a un punto di ingresso fornito dal carico di lavoro.
- Il Fabric frontend carica l'applicazione web in un iFrame in base al manifesto.
- L'host acquisisce i token di Microsoft Entra con gli ambiti richiesti dal carico di lavoro ed espone un'API host all'iFrame.
- Il carico di lavoro chiama le API pubbliche di Fabric (e, se applicabile, i propri servizi) usando questi token.
- I dati degli elementi vengono archiviati in OneLake e i metadati degli elementi vengono gestiti tramite le API di Infrastruttura in modo che si comportino come qualsiasi altro elemento di Fabric.
Passaggi successivi
Per sviluppare localmente e pubblicare il carico di lavoro, vedere Pubblicare il carico di lavoro. Per indicazioni sullo schema del manifesto e sullo sviluppo locale, vedere Panoramica del manifesto, DevServer e DevGateway. Per informazioni su endpoint API, ambiti e linee guida sull'identità, vedere le API REST pubbliche dell'infrastruttura.