Sdílet prostřednictvím


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

Spropitné

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

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

Jak vložit dlaždici řídicího panelu

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í dlaždice řídicího panelu použijte objekt konfigurace typu ITileLoadConfiguration:

interface ITileLoadConfiguration {
    accessToken: string;
    dashboardId: string;
    embedUrl: string;
    id: string;
    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í.

  • dashboardId – ID řídicího panelu, který obsahuje dlaždici, kterou vkládáte. K získání tohoto ID můžete použít rozhraní API řídicích panelů . Mezi dva příklady patří:

  • embedUrl – adresa URL dlaždice řídicího panelu, kterou vkládáte. Tato adresa URL se stane zdrojem elementu HTML iframe, který obsahuje vloženou dlaždici řídicího panelu. 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 dlaždice řídicího panelu, kterou vkládáte. K získání tohoto ID můžete použít rozhraní API řídicích panelů . Mezi dva příklady patří:

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

    • Použijte models.TokenType.Aad, pokud vkládáte do vaší organizace (uživatel vlastní data).
    • Použijte models.TokenType.Embed, pokud vkládáte data pro 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 dlaždici řídicího panelu použijte 'tile'.

Příklad

Následující příklad ukazuje, jak vložit jednu dlaždici řídicího panelu:

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