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 completamente interattive e completamente interattive senza dover creare visualizzazioni e controlli di dati personalizzati da zero. L'analisi di Power BI incorporato può presentare i dati proprietari dell'app tramite un proprio account Power BI o i dati proprietari dell'utente tramite gli account Power BI personali.
Scenari applicativi
Esistono due scenari diversi per l'incorporamento di un report di Power BI in un'applicazione.
- Incorporamento per l'organizzazione (noto anche come dati proprietari degli utenti): 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 hanno i dati incorporati.
- Incorporamento per i clienti (noto anche come dati di proprietà dell'app): 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 possiede i 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 il contenuto nell'applicazione.
Il tipo di contenuto incorporato viene specificato dal valore delembedUrl parametro. Per recuperare un URL di incorporamento per un particolare tipo di contenuto, chiamare l'API REST di Power BI corrispondente. Ad esempio, chiamare Recupera 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'accesso dell'applicazione usano gli account Power BI personali. In questo modo viene fornito il token di accesso per l'accesso ai dati e l'incorporamento dei report, dei dashboard e dei riquadri.
embedConfigurationIn , 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);
Incorporamento per i clienti
In questo scenario si crea un'identità dedicata che ha accesso a tutti gli elementi di Power BI. Viene quindi generato un token di incorporamento per i report, i dashboard o i riquadri che si desidera incorporare chiamando il token di incorporamento dell'API REST di Power BI. Dopo avere un token di incorporamento, usare il codice seguente per incorporare il report:
embedConfigurationIn , 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);