Incorporare un riquadro del dashboard
Suggerimento
Provare a incorporare un riquadro del dashboard o sperimentare con le API client nella sezione Esplora le API della Power BI Embedded Analytics Playground.
Questo articolo illustra i passaggi per l'incorporamento di un riquadro del dashboard nell'applicazione. Altre informazioni sui riquadri del dashboard in Introduzione ai riquadri del dashboard per le finestre di progettazione di Power BI.
Come incorporare un riquadro del dashboard
Quando si incorpora il contenuto di Power BI in un'app, si usa un oggetto di configurazione per definire il contenuto incorporato e per specificare le impostazioni del contenuto. Si passa quindi l'oggetto all'API.
Quando si incorpora un riquadro del dashboard, usare un oggetto di configurazione di tipo ITileLoadConfiguration:
interface ITileLoadConfiguration {
accessToken: string;
dashboardId: string;
embedUrl: string;
id: string;
tokenType?: models.TokenType;
type: string;
}
Questa interfaccia contiene le proprietà seguenti:
accessToken
- Token che consente di accedere ai dati di Power BI incorporati. Per altre informazioni sui token di accesso, vedere Informazioni sulle diverse soluzioni di incorporamento .dashboardId
- ID del dashboard che contiene il riquadro incorporato. È possibile usare un'API Dashboard per ottenere questo ID. Di seguito sono riportati due esempi:embedUrl
- URL del riquadro del dashboard in cui si sta incorporando. Questo URL diventa l'origine dell'elemento HTMLiframe
che contiene il riquadro del dashboard incorporato. In particolare, l'API assegna l'URL all'attributosrc
diiframe
. È possibile usare un'API Dashboard per ottenere questo URL. Di seguito sono riportati due esempi:id
- ID del riquadro del dashboard in cui si sta incorporando. È possibile usare un'API Dashboard per ottenere questo ID. Di seguito sono riportati due esempi:tokenType
- Tipo di token che consente di accedere ai dati di Power BI incorporati.- Usare
models.TokenType.Aad
se si sta incorporando per l'organizzazione (l'utente possiede i dati). - Usare
models.TokenType.Embed
se si sta incorporando per i clienti (l'app possiede i dati).
Per altre informazioni, vedere Informazioni sulle diverse soluzioni di incorporamento .
- Usare
type
- Tipo di contenuto incorporato. Usare'tile'
per un riquadro del dashboard.
Esempio
Nell'esempio seguente viene illustrato come incorporare un singolo riquadro del dashboard:
// Set up the configuration object that determines what to embed and how to embed it.
let embedConfiguration = {
accessToken: anAccessToken,
dashboardId: aDashboardId,
embedUrl: anEmbedUrl,
id: aTileId,
tokenType: aTokenType,
type: 'tile'
};
// Get a reference to the HTML element that contains the embedded dashboard tile.
let tileContainer = $('#tileContainer')[0];
// Embed the dashboard.
let tile = powerbi.embed(tileContainer, embedConfiguration);