Udostępnij za pośrednictwem

Osadzanie wizualizacji raportu

  • Artykuł

Napiwek

Spróbuj osadzić wizualizację raportu lub poeksperymentować z interfejsami API klienta w sekcji Eksploruj nasze interfejsy API sekcji narzędzia do analizy osadzonej usługi Power BI Embedded Analytics.

W tym artykule opisano kroki osadzania wizualizacji w aplikacji. Dowiedz się więcej o wizualizacjach w wizualizacjach w usłudze Power BI.

Jak osadzić wizualizację

Podczas osadzania zawartości usługi Power BI w aplikacji należy użyć obiektu konfiguracji, aby zdefiniować osadzaną zawartość i określić ustawienia zawartości. Następnie przekazujesz ten obiekt do interfejsu API.

Podczas osadzania wizualizacji użyj obiektu konfiguracji typu IVisualLoadConfiguration:

interface IVisualLoadConfiguration {
    accessToken?: string;
    embedUrl?: string;
    id?: string;
    pageName: string;
    tokenType?: models.TokenType;
    type: string;
    visualName: string;
}

Ten interfejs zawiera następujące właściwości:

  • accessToken — token, który zapewnia dostęp do osadzonych danych usługi Power BI. Zobacz Omówienie różnych rozwiązań osadzania, aby dowiedzieć się więcej na temat tokenów dostępu.

  • embedUrl — adres URL raportu, który zawiera osadzaną wizualizację. Ten adres URL staje się źródłem elementu iframe HTML, który zawiera osadzoną wizualizację. W szczególności interfejs API przypisuje adres URL do atrybutu srciframe. Aby uzyskać ten adres URL, możesz użyć interfejsu API raportów . Dwa przykłady to:

  • id — identyfikator raportu usługi Power BI, który zawiera osadzaną wizualizację.

  • pageName — nazwa strony zawierającej osadzaną wizualizację. Aby uzyskać strony w raporcie, możesz użyć metody getPages getPages.

  • tokenType — rodzaj tokenu, który zapewnia dostęp do osadzonych danych usługi Power BI.

    • Użyj models.TokenType.Aad, jeśli osadzasz dla organizacji (użytkownik jest właścicielem danych).
    • Użyj models.TokenType.Embed, jeśli osadzasz dla swoich klientów (aplikacja jest właścicielem danych).

    Aby uzyskać więcej informacji, zobacz Omówienie różnych rozwiązań osadzania.

  • type — rodzaj osadzonej zawartości. Użyj 'visual' dla wizualizacji.

  • visualName — nazwa osadzonej wizualizacji. Aby uzyskać wizualizacje na stronie, możesz użyć metody getVisuals getVisuals.

Przykład

W poniższym przykładzie pokazano, jak osadzić pojedynczą wizualizację:

// Set up the configuration object that determines what to embed and how to embed it.
let embedConfiguration = {
    accessToken: anAccessToken,
    embedUrl: anEmbedUrl,
    id: aReportId,
    pageName: aPageName,
    tokenType: aTokenType,
    type: 'visual',
    visualName: aVisualName
};
 
// Get a reference to the HTML element that contains the embedded report.
let embedContainer = $('#embedContainer')[0];
 
// Embed the visual.
let visual = powerbi.embed(embedContainer, embedConfiguration);

Filtry

Domyślnie interfejs API updateFilters będzie stosować filtry na poziomie wizualizacji podczas osadzania pojedynczej wizualizacji raportu. Może to spowodować konflikt z filtrami zastosowanymi w obiekcie konfiguracji osadzania, ponieważ są one stosowane na poziomie raportu. Aby rozwiązać ten problem, możesz ustawić poziom filtrów za pomocą interfejsu API:

await visual.updateFilters(FiltersOperations.Add, filters, FiltersLevel.Report);

Dowiedz się więcej o filtrach w filtrach raportów kontroli .

Powiązana zawartość