Sdílet prostřednictvím

Vložení vizuálu sestavy

  • Článek

Spropitné

Zkuste vložit vizuál sestavy 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í vizuálu do aplikace. Přečtěte si další informace o vizuálech ve vizuálech v Power BI.

Jak vložit vizuál

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í vizuálu použijte objekt konfigurace typu IVisualLoadConfiguration:

interface IVisualLoadConfiguration {
    accessToken?: string;
    embedUrl?: string;
    id?: string;
    pageName: string;
    tokenType?: models.TokenType;
    type: string;
    visualName: string;
}

Toto rozhraní zahrnuje tyto 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 sestavy, která obsahuje vizuál, který vkládáte. Tato adresa URL se stane zdrojem elementu HTML iframe, který obsahuje vložený vizuál. 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 sestav . Mezi dva příklady patří:

  • id – ID sestavy Power BI, která obsahuje vizuál, který vkládáte.

  • pageName – název stránky, která obsahuje vizuál, který vkládáte. K získání stránek v sestavě můžete použít metodu Report getPages.

  • 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 vizuál použijte 'visual'.

  • visualName – název vizuálu, který vkládáte. K získání vizuálů na stránce můžete použít metodu Page getVisuals.

Příklad

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

// Set up the configuration object that determines what to embed and how to embed it.
let embedConfiguration = {
    accessToken: anAccessToken,
    embedUrl: anEmbedUrl,
    id: aReportId,
    pageName: aPageName,
    tokenType: aTokenType,
    type: 'visual',
    visualName: aVisualName
};
 
// Get a reference to the HTML element that contains the embedded report.
let embedContainer = $('#embedContainer')[0];
 
// Embed the visual.
let visual = powerbi.embed(embedContainer, embedConfiguration);

Filtruje

Ve výchozím nastavení rozhraní API updateFilters použije filtry na úrovni vizuálů při vkládání jednoho vizuálu sestavy. To může způsobit konflikt s filtry použitými v objektu konfigurace vložení, protože se použijí na úrovni sestavy. Pokud chcete tento problém vyřešit, můžete nastavit úroveň filtrů pomocí rozhraní API:

await visual.updateFilters(FiltersOperations.Add, filters, FiltersLevel.Report);

Další informace ofiltrchch

Související obsah