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
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ří:- řídicí panely – získání řídicího panelu ve skupině
- řídicí panely – získání řídicích panelů ve skupině
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 URLsrc
atributuiframe
. K získání této adresy URL můžete použít rozhraní API řídicích panelů . Mezi dva příklady patří:- řídicí panely – získání dlaždice ve skupině
- řídicí panely – získání dlaždic ve skupinových
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ří:- řídicí panely – získání dlaždice ve skupině
- řídicí panely – získání dlaždic ve skupinových
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í.
- Použijte
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);