Sdílet prostřednictvím

Vložení stránkované sestavy

  • Článek

Spropitné

Zkuste vložit stránkovanou sestavu nebo experimentovat s našimi klientskými rozhraními API v Prozkoumat naše rozhraní API části Power BI Embedded Analytics Playground .

Tento článek popisuje kroky pro vložení stránkované sestavy do aplikace. Přečtěte si další informace o stránkovaných sestavách v Co jsou stránkované sestavy v Power BI Premium?.

Jak vložit stránkovanou sestavu

Při vkládání obsahu Power BI do aplikace definujete obsah a zadáte jeho nastavení v objektu konfigurace. Pak tento objekt předáte do rozhraní API.

Při vkládání stránkované sestavy použijte objekt konfigurace typu IPaginatedReportLoadConfiguration:

export interface IPaginatedReportLoadConfiguration {
    accessToken: string;
    id: string;
    embedUrl?: string;
    settings?: IPaginatedReportSettings;
    tokenType?: TokenType;
    type?: string;
    parameterValues?: IPaginatedReportParameter[];
}

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í.

  • embedUrl – adresa URL sestavy, kterou vkládáte. Tato adresa URL se stane zdrojem elementu iframe HTML, který obsahuje vloženou sestavu. Konkrétně rozhraní API přiřadí adresu URL src atributu prvku iframe. K získání této adresy URL můžete použít rozhraní API sestav . Mezi dva příklady patří:

    K předání parametrů sestavy do sestavy doporučujeme použít vlastnost parameterValues popsanou níže. Parametry ale můžete do sestavy předat také přidáním řetězce dotazu na konec adresy URL pro vložení. Přečtěte si další informace o předávání parametrů adresy URL ve stránkovaných sestavách. Podívejte se na příklady předávání parametrů doadresy URL .

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

  • název hostitele – výchozí hodnota hostname je app.powerbi.com. Pokud používáte suverénní cloud, zadejte zde adresu URL. Pokud jste zadali hodnotu pro embedURL, bude hostname ignorována.

  • nastavení – objekt konfigurace typu IPaginatedReportSettings. Tento objekt určuje informace o vzhledu panelu parametrů sestavy. Panel parametrů je panel pod panelem akcí, který lze rozbalit nebo skrýt.

    snímek obrazovky s vloženou stránkovanou sestavou Power BI Panel parametrů se nachází v horní části a je zvýrazněn červeně.

    • Panel parametrů můžete zobrazit nebo skrýt kliknutím na tlačítko Parametry na panelu akcí. Toto tlačítko je ve výchozím nastavení dostupné. Pokud ale nakonfigurujete vlastnost enabled panelu tak, aby byla false, tlačítko Parametry není dostupné.

    • Ve výchozím nastavení rozhraní API sbalí panel parametrů. Pokud nastavíte vlastnost expanded panelu na true, rozhraní API načte sestavu s rozbaleným panelem.

    • Tento kód ukazuje jeden způsob konfigurace vlastnosti settings:

      settings: {
    commands: {
        parameterPanel: {
            enabled: true,
            expanded: true
        }
    }
}

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

    • Pokud vkládáte data pro vaši organizaci (uživatel vlastní data), použijte models.TokenType.Aad.
    • Pokud vkládáte data pro zákazníky (aplikace vlastní data), použijte models.TokenType.Embed.

    Další informace najdete v tématu Vysvětlení různých řešení pro vkládání.

  • parameterValues – objekt konfigurace typu IPaginatedReportParameter. Nastavte parametry sestavy pomocí této vlastnosti. Tato metoda používá javascriptovou sadu SDK a je upřednostňovanou metodou předávání parametrů sestavy. Například:

    parameterValues: [
      {name: "State", value: "WA"},
      {name: "City", value: "Seattle"},
      {name: "City", value: "Bellevue"},
      {name: "City", value: "Redmond"}
]

    Tuto metodu lze použít pouze k předání parametrů sestavy (ty parametry, které mají předponu adresy URL rp:) a ne parametry rdl (s předponou adresy URL rdl:).

Příklad

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

// Set up the configuration object that determines what to embed and how to embed it.
let embedConfiguration = {
    accessToken: anAccessToken,
    embedUrl: anEmbedUrl,
    uniqueId: aReportId,
    tokenType: aTokenType,
    type: 'report',
    datasetBindings: [{
      sourceDatasetId: "originalDatasetId",
      targetDatasetId: "notOriginalDatasetId"
    }]
};
 
// 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);

Ujistěte se, že do tokenu pro vložení více prostředků zahrnete všechny id datové sady použité pro vazbu.

Důležité informace a omezení

  • Pokud chcete použít dynamickou vazbu, přečtěte si téma Vytvoření vazby datových sad dynamicky na stránkovanou sestavu.
  • Metoda bootstrapped není pro stránkované sestavy podporovaná.
  • parametry s více hodnotami se při vkládání stránkované sestavy nepodporují.
  • Vlastnost parameterValues lze použít pouze pro parametry sestavy. Nejde ho použít pro parametry rdl.
  • Vložení stránkované sestavy s datovou sadou v reálném čase (datová sada nabízených oznámení) se nepodporuje.

Související obsah