Udostępnij za pośrednictwem

Osadzanie pulpitu nawigacyjnego

  • Artykuł

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

Napiwek

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

Jak osadzić pulpit nawigacyjny

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

interface IDashboardLoadConfiguration {
    accessToken: string;
    embedUrl?: string;
    id: string;
    pageView?: models.PageView 
    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.

  • embedUrl — adres URL osadzonego pulpitu nawigacyjnego. Ten adres URL staje się źródłem elementu iframe HTML, który zawiera osadzony pulpit nawigacyjny. 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 osadzonego pulpitu nawigacyjnego. Użyj interfejsu API pulpitów nawigacyjnych, aby uzyskać ten identyfikator. Na przykład:

  • pageView — format używany przez interfejs API dla osadzonego pulpitu nawigacyjnego. Możliwości obejmują:

    • fitToWidth — szerokość osadzonego pulpitu nawigacyjnego odpowiada szerokości elementu div zawierającego pulpit nawigacyjny.
    • oneColumn — osadzony pulpit nawigacyjny jest wyświetlany w jednej kolumnie.
    • actualSize — interfejs API wyświetla osadzony pulpit nawigacyjny w pełnym rozmiarze.

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

    • Użyj models.TokenType.Aad, aby osadzić w organizacji ( użytkownikjest właścicielem danych).
    • Użyj models.TokenType.Embed, aby osadzić klientów (aplikacjajest właścicielem danych).

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

  • type — rodzaj osadzonej zawartości. Użyj 'dashboard' dla pulpitu nawigacyjnego.

Przykład

W poniższym przykładzie pokazano, jak osadzić pojedynczy pulpit nawigacyjny:

// Set up the configuration object that determines what to embed and how to embed it.
let embedConfiguration = {
    accessToken: anAccessToken,
    embedUrl: anEmbedUrl,
    id: aDashboardId,
    pageView: 'fitToWidth',
    tokenType: aTokenType,
    type: 'dashboard'
};
 
// Get a reference to the HTML element that contains the embedded dashboard.
let dashboardContainer = $('#dashboardContainer')[0];
 
// Embed the dashboard.
let dashboard = powerbi.embed(dashboardContainer, embedConfiguration);

Zagadnienia i ograniczenia

  • Osadzanie pulpitów nawigacyjnych na jednostkach SKU EM nie jest obsługiwane

  • Podczas osadzania zawartości aplikacja wyświetla zawartość w elemecie div. Jeśli używasz wartości pageViewactualSize podczas osadzania pulpitu nawigacyjnego:

    • Jeśli pulpit nawigacyjny jest szerszy niż element div, interfejs API używa szerokości elementu div jako szerokości osadzonego pulpitu nawigacyjnego.
    • Jeśli pulpit nawigacyjny jest węższy niż element div, interfejs API wypełnia nieużywane miejsce z osadzonym tłem. Domyślnie to tło jest białe, ale można je skonfigurować tak, aby było przezroczyste. W takim przypadku styl elementu div jest widoczny w nieużywanym miejscu.

Powiązana zawartość