Udostępnij za pośrednictwem

Omówienie różnych rozwiązań osadzania

  • Artykuł

Osadzanie elementów usługi Power BI (takich jak raporty, pulpity nawigacyjne i Q&A) w aplikacji umożliwia integrację wspaniałych, w pełni interaktywnych analiz bez konieczności tworzenia własnych wizualizacji danych i kontrolek od podstaw. Osadzona analiza usługi Power BI może przedstawiać dane, które aplikacja jest właścicielem za pomocą własnego konta usługi Power BI, lub danych, które użytkownik jest właścicielem za pośrednictwem kont usługi Power BI.

Scenariusze aplikacji

Istnieją dwa różne scenariusze osadzania raportu usługi Power BI w aplikacji.

  • Osadzanie dla organizacji (znanej również jako użytkownik jest właścicielem danych): aplikacja umożliwia integrację danych, raportów, pulpitów nawigacyjnych i kafelków dostępnych dla użytkowników w organizacji podczas logowania się przy użyciu własnych kont usługi Power BI. W tej aplikacji użytkownicy są właścicielami osadzanych danych.
  • Osadź dla klientów (znana również jako aplikacja jest właścicielem danych): aplikacja przedstawia dane, raporty, pulpity nawigacyjne lub kafelki przekazane do własnego konta usługi Power BI. W tej aplikacji używasz własnego konta, więc aplikacja jest właścicielem danych dla klientów. Klienci nie potrzebują własnego konta usługi Power BI.

Używany scenariusz aplikacji określa sposób pobierania tokenu dostępu, który umożliwia dostęp do danych i osadzanie zawartości w aplikacji.

Typ osadzanej zawartości jest określany przez wartość parametruembedUrl. Aby pobrać adres URL osadzania dla określonego typu zawartości, wywołaj odpowiedni interfejs API REST usługi Power BI. Na przykład wywołaj metodę Pobierz raporty, aby pobrać adres URL osadzania na potrzeby osadzania raportu.

W poniższych sekcjach pokazano, jak pobrać token dostępu i osadzić raport dla każdego z tych scenariuszy aplikacji.

Osadzanie dla organizacji

W tym scenariuszu użytkownicy aplikacji logują się przy użyciu kont usługi Power BI. Zapewnia to token dostępu do uzyskiwania dostępu do danych i osadzania raportów, pulpitów nawigacyjnych i kafelków.

W embedConfigurationustaw tokenType wartość 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);

Osadzanie dla klientów

W tym scenariuszu utworzysz dedykowaną tożsamość, która ma dostęp do wszystkich elementów usługi Power BI. Następnie wygenerujesz token osadzania dla raportów, pulpitów nawigacyjnych lub kafelków, które chcesz osadzić, wywołując interfejs API REST usługi Power BI token osadzania. Po utworzeniu tokenu osadzania użyj następującego kodu, aby osadzić raport:

W embedConfigurationustaw tokenType wartość 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);

Powiązana zawartość