Udostępnij za pośrednictwem

Osadzanie kafelka pulpitu nawigacyjnego

  • Artykuł

Napiwek

Spróbuj osadzić kafelek pulpitu nawigacyjnego lub poeksperymentować z naszymi interfejsami API klienta w sekcji Eksploruj nasze interfejsy API sekcji Narzędzia do analizy osadzonej usługi Power BI.

W tym artykule opisano kroki osadzania kafelka pulpitu nawigacyjnego w aplikacji. Dowiedz się więcej o kafelkach pulpitu nawigacyjnego w Wprowadzenie do kafelków pulpitu nawigacyjnego dla projektantów usługi Power BI.

Jak osadzić kafelek pulpitu nawigacyjnego

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 kafelka pulpitu nawigacyjnego użyj obiektu konfiguracji typu ITileLoadConfiguration:

interface ITileLoadConfiguration {
    accessToken: string;
    dashboardId: string;
    embedUrl: string;
    id: string;
    tokenType?: models.TokenType;
    type: 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.

  • dashboardId — identyfikator pulpitu nawigacyjnego, który zawiera osadzony kafelek. Aby uzyskać ten identyfikator, możesz użyć interfejsu API pulpitów nawigacyjnych . Dwa przykłady to:

  • embedUrl — adres URL kafelka pulpitu nawigacyjnego, który osadzasz. Ten adres URL staje się źródłem elementu iframe HTML, który zawiera osadzony kafelek pulpitu nawigacyjnego. W szczególności interfejs API przypisuje adres URL do atrybutu srciframe. Aby uzyskać ten adres URL, możesz użyć interfejsu API pulpitów nawigacyjnych . Dwa przykłady to:

  • id — identyfikator kafelka pulpitu nawigacyjnego, który osadzasz. Aby uzyskać ten identyfikator, możesz użyć interfejsu API pulpitów nawigacyjnych . Dwa przykłady to:

  • 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 'tile' dla kafelka pulpitu nawigacyjnego.

Przykład

W poniższym przykładzie pokazano, jak osadzić pojedynczy kafelek pulpitu nawigacyjnego:

// 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);

Powiązana zawartość