Vložení řídicího panelu

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

Tip

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

Postup vložení řídicího panelu

Při vkládání obsahu Power BI do aplikace použijete konfigurační objekt k definování obsahu, který vkládáte, a k určení nastavení obsahu. Pak tento objekt předáte 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ý vám dává přístup k datům Power BI, která vkládáte. Další informace o přístupovýchtokench

• embedUrl – Adresa URL řídicího panelu, který vkládáte. Tato adresa URL se stane zdrojem elementu HTML iframe , 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ů . Tady jsou dva příklady:

  • Řídicí panely – Získání řídicího panelu ve skupině
  • Řídicí panely – Získání řídicích panelů ve skupině

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

  • Řídicí panely – Získání řídicího panelu ve skupině
  • Řídicí panely – Získání řídicích panelů ve skupině

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

  • fitToWidth – Šířka vloženého řídicího div panelu odpovídá šířce prvku, 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ý vám dává přístup k datům Power BI, která vkládáte.

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

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

• type - Druh obsahu, který vkládáte. Používá se 'dashboard' pro řídicí panel.

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 elementu div . Pokud při vložení řídicího panelu actualSize použijete pageView hodnotu:

  • Pokud je řídicí panel širší než div prvek, rozhraní API používá šířku elementu jako šířku div vloženého řídicího panelu.
  • Pokud je řídicí panel užší než div prvek, 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 bylo transparentní. V takovém případě div je styl prvku viditelný v nepoužívaném prostoru.

Další kroky

Vložení sestavy

Vložení dlaždice řídicího panelu

Použití metody bootstrap pro lepší výkon