Vložení dlaždice řídicího panelu
Tip
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 v Power BI Embedded Analytics Playground.
Tento článek popisuje postup vložení dlaždice řídicího panelu do aplikace. Přečtěte si další informace o dlaždicích řídicích panelů v úvodu 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 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í 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ý poskytuje 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í 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 HTMLiframe
, který obsahuje vloženou dlaždici řídicího panelu. Konkrétně rozhraní API přiřadí adresu URL atributusrc
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
– Typ tokenu, který umožňuje přístup k datům Power BI, která vkládáte.- Použijte
models.TokenType.Aad
, pokud vkládáte data 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í vkládání .
- Použijte
type
– Druh obsahu, který vkládáte. Slouží'tile'
pro dlaždici řídicího panelu.
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);