Nota: Questo articolo si tuffa nei dettagli di Energy BI incorporato. È una continuazione del Energy BI BI Embedded Analytics – Parte 1 Articolo, che discute l’autorizzazione di Energy BI e un’introduzione all’analisi incorporata di Energy BI. Quindi, si consiglia di passare attraverso la discussione su quell’articolo.
Puoi anche trovare la parte 3, che presenta un’applicazione demo incorporata di Energy BI, Quibasato sui dettagli presentati in questo articolo.
Energy BI Panoramica incorporata
Sono disponibili due soluzioni:
- Incorporato per i clienti (l’app possiede dati): I clienti qui sono utenti della nostra applicazione e non devono accedere all’utilizzo delle credenziali di Energy BI o avere licenze per visualizzare il contenuto/analisi incorporato. Consente di costruire un’app che si autentica da Energy BI utilizzando il flusso di autenticazione non interattivo (cioè, senza alcuna richiesta all’utente, esegue l’autenticazione internamente e presenta il contenuto all’utente finale).
- Incorporato per l’organizzazione (l’utente possiede dati): Questo è destinato agli utenti interni della nostra organizzazione che potrebbero avere licenze di Energy BI. Richiede agli utenti di accedere a Energy BI utilizzando le proprie credenziali.
Per il nostro situation, useremmo la prima soluzione, incorpora per i clienti (l’app possiede dati).
Per incorporare e utilizzare Energy BI nella nostra app in produzione, è necessario acquistare/autorizzare la capacità. In termini più semplici, la capacità è le risorse di calcolo (macchine virtuali cloud) necessarie per elaborare carichi di lavoro, come il rendering dei report e l’aggiornamento dei dati.
Queste licenze consentono di incorporare contenuti per utenti esterni, ad es. Gli utenti non hanno alcuna licenza BI di alimentazione e possono accedere ai contenuti tramite la nostra app. Sono disponibili due tipi di licenze basate sulla capacità:
Incorporato
- Questa licenza consente di incorporare contenuti per utenti esterni. Gli utenti che non hanno una licenza Energy BI possono accedere al contenuto tramite la nostra app (anche se hanno le proprie credenziali/licenze, l’autenticazione/licenza dell’app funziona).
- Questa modalità di licenza è disponibile con Energy BI incorporato, che è una risorsa di Azure ed è disponibile per l’acquisto dal portale Azure.
- Il nodo (risorsa di calcolo) rientra in una categoria SKU. Gli skus vanno da A1 a A8 (1 essendo il più debole, 8 essendo il più potente). A4 a A8 sono equivalenti a P1 a P5 (vedi sotto) in termini di potere.
- Questa capacità può essere ridimensionata/giù o in pausa/ripresa.
- Questo viene fatturato su base oraria.
- La modalità di licenza per l’space di lavoro specifica deve essere impostata su incorporato per attivare questa licenza.
- Sarebbe richiesto l’abbonamento azure (l’abbonamento Pay-As-You-Go di Azure funzionerebbe nel nostro caso. Non vi è alcuna commissione per mantenere il conto gratuito di Azure; pagheremmo solo per la licenza/capacità incorporata che viene acquistata attraverso il portale Azure).
- La capacità può essere gestita attraverso il portale Azure.
- I creatori di contenuti hanno ancora bisogno di una licenza Energy BI Professional per l’autorizzazione del rapporto. È richiesta almeno una licenza Energy BI Professional per l’organizzazione di poter autore e pubblicare contenuti.
Premium per capacità
- Queste licenze consentono di incorporare contenuti per utenti esterni e utenti interni.
- Questa modalità di licenza è disponibile con Energy BI Premium, disponibile per l’acquisto dal Microsoft 365 Admin Middle.
- Il nodo (risorsa di calcolo) rientra nella categoria P SKU. P SKU va da P1 a P5 (1 è il più debole, 5 essendo il più potente).
- Questa capacità non può essere messa in pausa/ripresa. Può essere ridimensionato manualmente o tramite la funzione autoscala.
- Questo è fatturato su base mensile.
- La modalità di licenza per l’space di lavoro specifica dovrebbe essere impostata su Premium per attivare questa licenza.
- La capacità può essere gestita attraverso il portale di amministrazione di Energy BI e rinnovata attraverso il centro amministratore Microsoft 365.
- È necessario gestire un abbonamento Microsoft 365 per essere gestito tramite Microsoft 365.
- Sarebbe necessario un abbonamento azure per gestire il flusso di autenticazione richiesto per l’utilizzo di questo nello situation incorporato.
- I creatori di contenuti hanno ancora bisogno di una licenza Energy BI Professional per l’autorizzazione del rapporto. È richiesta almeno una licenza Energy BI Professional per l’organizzazione di autore e pubblicare contenuti.
- * (Non pertinente per il nostro caso) Ciò embody anche una licenza per il server di report BI Energy BA.
Per il nostro situation, andremmo con la prima soluzione, cioè la licenza incorporata (Energy BI incorporata), che dovrebbe essere più economica ed è raccomandata per il nostro caso.
Per il flusso di autenticazione nell’incorporamento, è richiesta un’identità di incorporamento. Insieme all’identità di incorporamento, un’app di Azure deve essere registrata e legata all’identità incorporata. Un’identità incorporata può essere:
- Servizio pRinchipal: La tua app può utilizzare un capitale di servizio per acquisire un token di annunci Azure. Il preside della sicurezza definisce la politica di accesso e le autorizzazioni per l’utente/applicazione nell’inquilino Azure AD. Ciò consente funzionalità core come l’autenticazione dell’utente/applicazione durante l’accesso e l’autorizzazione durante l’accesso alle risorse. Questo metodo utilizza segreti o certificati per l’auth. Quando l’identità di incorporamento della tua app è un capitale del servizio, un amministratore di Energy BI deve prima:
- Abilita l’uso dei principi del servizio attraverso il portale di amministrazione di Energy BI.
- Registra un gruppo di sicurezza che li contiene.
- Grasp utente: La tua app può utilizzare un account utente principale per acquisire un token pubblicitario. Un account utente principale è un normale utente di annunci di Azure. Deve inoltre avere una licenza Energy BI Professional o Energy BI Premium per utente (PPU) e quindi può accedere al servizio BI Energy, a differenza del capitale del servizio. In Energy BI, l’account deve appartenere all’amministratore dell’space di lavoro o al ruolo membro per incorporare il contenuto dell’space di lavoro. Un’altra considerazione è che gli account dell’utente principale non possono richiedere MFA.
Una volta che l’utente dell’app si autentica con l’app, l’app utilizza l’identità di incorporamento (capitale di servizio o l’utente grasp) per acquisire un token di annunci Azure utilizzando un flusso di autenticazione non interattivo.
Una volta che l’app acquisisce un token di annunci Azure (utilizzando la libreria di autenticazione Microsoft-MSAL), la cache e quindi la utilizza per generare un token incorporato (utilizzando un’operazione API di REST BI Energy, che richiede un Token di Azure Ad). Un token incorporato rappresenta fatti sul contenuto di Energy BI e su come accedervi, come:
- Richiede il contenuto BI di potere specifico.
- Livello di accesso, che hai impostato per visualizzare, creare o modificare.
- Token Lifetime, che determina quando il token scade. Questi token dovrebbero essere aggiornati prima che scadano usando le API POWER BI REST.
Per il nostro situation, andremmo con la prima soluzione, cioè il preside del servizio, poiché è più sicuro ed è il metodo raccomandato per la produzione.
Le API incorporate di Energy BI forniscono l’accesso programmatico alle capacità di Energy BI, consentendo agli sviluppatori di integrare il contenuto di Energy BI, come report e dashboard, in applicazioni personalizzate, siti Internet o portali.
Queste API ci consentono di creare, interagire e gestire il contenuto di Energy BI all’interno delle nostre applicazioni. Le seguenti API sono necessarie per ottenere una soluzione di analisi incorporata di Energy BI:
API POWER BI REST
Le API di Energy BI REST forniscono endpoint di servizio per l’incorporamento, l’amministrazione, la governance e le risorse dell’utente. Con Energy BI REST API, puoi fare quanto segue:
- Gestisci il contenuto di Energy Bi
- Eseguire operazioni amministrative
- Incorporare il contenuto di Energy BI
Gruppi di operazioni di riposo
- Amministratore: Operazioni per lavorare con compiti amministrativi
- App: Operazioni per lavorare con le app
- Caratteristiche disponibili: Operazioni che restituiscono funzionalità disponibili
- Capacità: Operazioni per lavorare con le capacità
- Dashboard: Operazioni per lavorare con i dashboard
- Account di archiviazione del flusso di dati: Operazioni per lavorare con gli account di archiviazione del flusso di dati
- Flussi di dati: Operazioni per lavorare con i flussi di dati
- Set di dati: Operazioni per lavorare con set di dati
- Incorporare token: Operazioni per lavorare con token incorporati
- Gateways: Operazioni per lavorare con i gateway
- Gruppi: Operazioni per lavorare con i gruppi
- Importazioni: Operazioni per lavorare con le importazioni
- Condutture: Operazioni per lavorare con condutture di distribuzione
- Spingere set di dati: Operazioni per lavorare con set di dati push
- Segnalazioni: Operazioni per lavorare con i rapporti
- App modello: Operazioni per lavorare con le app dei modelli
- Utenti: Operazioni per lavorare con gli utenti
Per ulteriori dettagli, fare riferimento a questo sito internet.
Energy BI Consumer API
L’API consumer Energy BI è una libreria lato consumer che consente di controllare a livello di programmazione il contenuto BI di Energy incorporato utilizzando JavaScript o TypeScript. Le API consumer comunicano tra energy BI (come rapporti e dashboard) e il codice dell’applicazione, offrendo la flessibilità di costruire un’esperienza dell’utente finale secondo il tuo design.
Le API consumer comunicano con un elemento BI di alimentazione incorporato, come un rapporto o una dashboard. L’iframe crea una separazione tra l’app di internet hosting e l’elemento BI Energy, assicurando che i dati siano garantiti.
Le API del cliente sono ulteriormente divise in queste categorie:
- powerbi-client: La biblioteca consumer Energy BI principale, che embody tutte le API consumer Energy BI ad eccezione di PowerBI-Report-Authoring. Questa libreria definisce le classi per i diversi elementi di Energy BI che possono essere incorporati. La libreria PowerBi-Consumer ti consente di controllare il contenuto che stai integrando.
- Mannequin Powerbi: Contiene i modelli oggetti per le API consumer Energy BI. Per ogni modello, esiste un’interfaccia dattiloscritto, una definizione dello schema JSON e una funzione di validazione per garantire che un dato oggetto sia un modello valido.
- Powerbi-Report-Autoring: Un’estensione della libreria consumer. Queste API aiutano a creare elementi visivi e alla creazione del rapporto dopo il carico. La libreria di autorizzazione PowerBI-Report ti consente di modificare a livello di programmazione i rapporti incorporati.
Il prossimo e ultimo articolo copre l’applicazione demo incorporata Powerbi che evidenzia soluzioni, passaggi di integrazione e caratteristiche chiave.