Sdílet prostřednictvím

Vložení řídicího panelu

  • Článek

Tento článek popisuje kroky pro vložení řídicího panelu do aplikace. Přečtěte si další informace o řídicích panelech v Úvod k řídicím panelům pro návrháře Power BI.

Spropitné

Zkuste vložit řídicí panel nebo experimentovat s našimi klientskými rozhraními API v části Prozkoumat naše rozhraní API části Power BI Embedded Analytics Playground .

Jak vložit řídicí panel

Při vkládání obsahu Power BI do aplikace použijete objekt konfigurace k definování obsahu, který vkládáte, a k určení nastavení obsahu. Pak tento objekt předáte do rozhraní API.

Při vložení řídicího panelu použijte objekt konfigurace typu IDashboardLoadConfiguration:

interface IDashboardLoadConfiguration {
    accessToken: string;
    embedUrl?: string;
    id: string;
    pageView?: models.PageView 
    tokenType?: models.TokenType;
    type: string;
}

Toto rozhraní obsahuje následující vlastnosti:

  • accessToken – token, který umožňuje přístup k datům Power BI, která vkládáte. Další informace o přístupových tokenech najdete v tématu Vysvětlení různých řešení pro vkládání.

  • embedUrl – adresa URL řídicího panelu, který vkládáte. Tato adresa URL se stane zdrojem html iframe elementu, který obsahuje vložený řídicí panel. Konkrétně rozhraní API přiřadí adresu URL src atributu iframe. K získání této adresy URL můžete použít rozhraní API řídicích panelů . Mezi dva příklady patří:

  • id – ID řídicího panelu, který vkládáte. K získání tohoto ID použijte rozhraní API řídicích panelů . Například:

  • pageView – formát, který rozhraní API používá pro vložený řídicí panel. Mezi možnosti patří:

    • fitToWidth – Šířka vloženého řídicího panelu odpovídá šířce prvku div, který obsahuje řídicí panel.
    • oneColumn – vložený řídicí panel se zobrazí v jednom sloupci.
    • actualSize – Rozhraní API zobrazí vložený řídicí panel v plné velikosti.

  • tokenType – druh tokenu, který umožňuje přístup k datům Power BI, která vkládáte.

    • Použití models.TokenType.Aad k vložení pro vaši organizaci (uživatel vlastní data).
    • Použití models.TokenType.Embed k vložení pro vaše zákazníky (aplikace vlastní data).

    Další informace najdete v tématu Vysvětlení různých řešení pro vkládání.

  • type – druh obsahu, který vkládáte. Pro řídicí panel použijte 'dashboard'.

Příklad

Následující příklad ukazuje, jak vložit jeden řídicí panel:

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

Důležité informace a omezení

  • Vkládání řídicích panelů do skladových položek EM se nepodporuje.

  • Při vkládání obsahu aplikace zobrazí obsah v div elementu. Pokud při vkládání řídicího panelu použijete pageView hodnotu actualSize:

    • Pokud je řídicí panel širší než prvek div, použije rozhraní API šířku prvku div jako šířku vloženého řídicího panelu.
    • Pokud je řídicí panel užší než prvek div, rozhraní API vyplní nevyužité místo vloženým pozadím. Ve výchozím nastavení je toto pozadí bílé, ale můžete ho nakonfigurovat tak, aby byla průhledná. V takovém případě je styling prvku div viditelný v nevyužitém prostoru.

Související obsah