Vložení sestavy

Tip

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

Jak vložit sestavu

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. Další informace najdete v tématu Konfigurace nastavení sestavy .

Vložení existující sestavy

Při vložení sestavy, která již existuje, použijte objekt konfigurace typu IReportLoadConfiguration.

interface IReportLoadConfiguration {
    accessToken: string;
    bookmark?: models.IApplyBookmarkRequest;
    contrastMode?: models.ContrastMode;
    datasetBinding?: models.IDatasetBinding;
    embedUrl?: string;
    filters?: models.ReportLevelFilters[];
    id: string;
    pageName?: string;
    permissions?: models.Permissions;
    settings?: models.IEmbedSettings;
    slicers?: models.ISlicer[];
    theme?: models.IReportTheme;
    tokenType?: models.TokenType;
    type: string;
    viewMode?: models.ViewMode;
}

Toto rozhraní zahrnuje tyto vlastnosti:

• accessToken – Token, který vám dává přístup k datům Power BI, která vkládáte. Další informace o přístupovýchtokench

• datasetBinding – Datová sada, která definuje schéma dat, které vložená sestava používá. Další informace o datových sadách najdete v tématu Dynamické vytvoření vazby datových sad k sestavě .

• embedUrl – Adresa URL sestavy, kterou vkládáte. Tato adresa URL se stane zdrojem elementu HTML iframe , který obsahuje vloženou sestavu. 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 . Tady jsou dva příklady:

  • Sestavy – Získání sestavy ve skupině
  • Sestavy – Získání sestav ve skupině

• id – ID sestavy Power BI, kterou vkládáte.

• permissions – Operace, které udělíte uživatelům pro vloženou sestavu. K dispozici jsou tyto hodnoty:

  • Read – Uživatelé můžou sestavu zobrazit.
  • ReadWrite – Uživatelé mohou sestavu zobrazit, upravit a uložit.
  • Copy – Uživatelé mohou uložit kopii sestavy pomocí možnosti Uložit jako.
  • Create – Uživatelé mohou vytvořit novou sestavu.
  • All – Uživatelé mohou vytvářet, zobrazovat, upravovat, ukládat a ukládat kopii sestavy.

• tokenType – Druh tokenu, který vám dává přístup k datům Power BI, která vkládáte.

  • Použijte models.TokenType.Aad , pokud vkládáte data pro vaši organizaci (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í .

• type - Druh obsahu, který vkládáte. Používá se 'report' pro sestavu Power BI.

Rozhraní IReportLoadConfiguration také obsahuje další vlastnosti. Informace o těchto vlastnostech najdete v tématu Konfigurace nastavení sestavy :

• bookmark
• contrastMode
• filters
• pageName
• settings
• slicers
• theme
• viewMode

Vložení nové sestavy

Když vložíte novou sestavu, kterou vytvoříte z datové sady, použijte objekt konfigurace typu IReportCreateConfiguration.

interface IReportCreateConfiguration {
    accessToken: string;
    datasetId: string;
    embedUrl?: string;
    settings?: models.IEmbedSettings;
    theme?: IReportTheme;
    tokenType?: models.TokenType;
    type: string;
}

Vlastnosti v tomto rozhraní jsou podobné vlastnostem v IReportLoadConfiguration rozhraní s následujícími výjimkami:

• datasetId – ID datové sady, která definuje schéma dat, které nová sestava používá.

• embedUrl – Adresa URL datové sady, která definuje schéma dat, které nová sestava používá. Tato adresa URL se stane zdrojem elementu HTML iframe , který obsahuje vloženou sestavu. 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 datových sad . Tady jsou dva příklady:

  • Datové sady – Získání datové sady ve skupině
  • Datové sady – Získání datových sad ve skupině

Informace o úpravách a vytváření sestav najdete v tématu Vytvoření, úprava a uložení vložené sestavy .

Příklad

Následující příklad ukazuje, jak vložit sestavu:

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

Další kroky

Vložení vizuálu sestavy

Vložení stránkované sestavy

Konfigurace nastavení sestavy

Vytvoření, úprava a uložení sestavy

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