Sdílet prostřednictvím

Vložení vizuálu sestavy

  • Článek

Tip

Zkuste vložit vizuál sestavy nebo experimentovat s našimi klientskými rozhraními API v části Prozkoumejte naše rozhraní APIna Power BI Embedded Analytics Playground.

Tento článek popisuje postup 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

Když vkládáte obsah 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 vkládání 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í obsahuje tyto vlastnosti:

  • accessToken – Token, který vám poskytne 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 atributu srciframe. K získání této adresy URL můžete použít rozhraní API sestav . Jsou to dva příklady:

  • 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ý vám umožní přístup k datům Power BI, která vkládáte.

    • Použijte models.TokenType.Aad , pokud vkládáte pro vaši organizaci (uživatel vlastní data).
    • Použijte models.TokenType.Embed , pokud vkládáte 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žijte 'visual' pro vizuál.

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

Filtry

Ve výchozím nastavení updateFilters použije rozhraní API při vkládání jednoho vizuálu sestavy filtry na úrovni vizuálů. 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 o filtrech najdete v tématu Řízení filtrů sestav.

Další kroky

Vložení sestavy

Vložení stránkované sestavy

Vložení samostatného vizuálu Q&A

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