Informazioni sulle diverse soluzioni di incorporamento
L'incorporamento di elementi di Power BI (ad esempio report, dashboard e Q&A) nell'applicazione consente di integrare analisi straordinarie e completamente interattive senza dover creare visualizzazioni e controlli dei dati personalizzati da zero. L'analisi di Power BI incorporata può presentare i dati di proprietà dell'app tramite il proprio account Power BI o i dati di proprietà dell'utente tramite gli account Power BI personali.
Scenari di applicazione
Esistono due scenari diversi per l'incorporamento di un report di Power BI in un'applicazione.
- Incorporare per l'organizzazione (noto anche come utente è proprietario dei dati): l'applicazione consente di integrare dati, report, dashboard e riquadri accessibili agli utenti dell'organizzazione quando accedono usando i propri account Power BI. In questo tipo di applicazione gli utenti possiedono i dati incorporati.
- Incorporare per i clienti (noto anche come app possiede dati): l'applicazione presenta i dati, i report, i dashboard o i riquadri caricati nel proprio account Power BI. In questo tipo di applicazione si usa il proprio account, quindi l'applicazione è proprietaria dei dati per i clienti. I clienti non hanno bisogno del proprio account Power BI.
Lo scenario dell'applicazione usato determina come recuperare un token di accesso che consente di accedere ai dati e incorporare contenuto nell'applicazione.
Il tipo di contenuto incorporato viene specificato dal valore del parametroembedUrl
. Per recuperare un URL di incorporamento per un particolare tipo di contenuto, chiamare l'API REST di Power BI corrispondente. Ad esempio, chiamare Ottenere report per recuperare l'URL di incorporamento per incorporare un report.
Le sezioni seguenti illustrano come recuperare un token di accesso e incorporare un report per ognuno di questi scenari dell'applicazione.
Incorporamento per l'organizzazione
In questo scenario, gli utenti dell'applicazione accedono usando gli account Power BI personali. In questo modo è possibile ottenere il token di accesso per l'accesso ai dati e l'incorporamento di report, dashboard e riquadri.
Nel embedConfiguration
impostare tokenType
su TokenType.Aad
.
// Get models so you can use the TokenType enum.
let models = window['powerbi-client'].models;
let embedConfiguration = {
type: 'report',
id: '5dac7a4a-4452-46b3-99f6-a25915e0fe55',
embedUrl: 'https://app.powerbi.com/reportEmbed',
tokenType: models.TokenType.Aad,
accessToken: 'e4...rf'
};
let reportContainer = $('#reportContainer')[0];
let report = powerbi.embed(reportContainer, embedConfiguration);
Incorporare per i clienti
In questo scenario si crea un'identità dedicata che ha accesso a tutti gli elementi di Power BI. Si genera quindi un token di incorporamento per i report, i dashboard o i riquadri da incorporare chiamando l'API REST di Power BI Token di incorporamento. Dopo aver ottenuto un token di incorporamento , usare il codice seguente per incorporare il report:
Nel embedConfiguration
impostare tokenType
su TokenType.Embed
.
// Get models so you can use the TokenType enum.
let models = window['powerbi-client'].models;
let embedConfiguration = {
type: 'report',
id: '5dac7a4a-4452-46b3-99f6-a25915e0fe55',
embedUrl: 'https://app.powerbi.com/reportEmbed',
tokenType: models.TokenType.Embed,
accessToken: 'h4...rf'
};
let reportContainer = $('#reportContainer')[0];
let report = powerbi.embed(reportContainer, embedConfiguration);