Sdílet prostřednictvím

Vložení sestavy

  • Článek

Spropitné

Zkuste vložit sestavu 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í sestavy Power BI do vaší 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 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. 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ý 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í.

  • 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é vazby datových sad k sestavě.

  • embedUrl – adresa URL sestavy, kterou vkládáte. Tato adresa URL se stane zdrojem html iframe elementu, 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 . Mezi dva příklady patří:

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

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

    • Read – Uživatelé můžou sestavu zobrazit.
    • ReadWrite – Uživatelé můžou sestavu zobrazit, upravit a uložit.
    • Copy – Uživatelé můžou uložit kopii sestavy pomocí funkce Uložit jako.
    • Create – Uživatelé můžou vytvořit novou sestavu.
    • All – uživatelé můžou vytvořit, zobrazit, upravit, uložit a uložit kopii sestavy.

  • 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 sestavu Power BI použijte 'report'.

Rozhraní IReportLoadConfiguration obsahuje také 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 rozhraní IReportLoadConfiguration 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 html iframe elementu, 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. Mezi dva příklady patří:

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

Související obsah