Sdílet prostřednictvím

Použití metody bootstrap pro zajištění lepšího výkonu

  • Článek

powerbi.bootstrap je metoda zavedená v klientské sadě SDK verze 2.9.0, která vývojářům pomáhá rychleji vkládat entity Power BI a dosáhnout lepšího výkonu.

Vložení sestavy pomocí powerbi.embed vyžaduje více parametrů, například reportId, embedURLa accessToken. Tyto parametry nejsou vždy okamžitě dostupné.

powerbi.bootstrap vám umožní začít vkládat dřív, než budou k dispozici všechny požadované parametry. Rozhraní API bootstrap připraví a inicializuje prvek iframe.

Po přijetí požadovaných parametrů by powerbi.embed(element, config) měla být volána na stejném elementu HTML.

Bootstrap API

Metoda powerbi.bootstrap(element, config) přijímá element a konfiguraci, stejně jako powerbi.embed(...).

/**
    * Given an HTML element and entityType, creates a new component instance, and bootstrap the iframe for embedding.
    *
    * @param {HTMLElement} an HTML Element where you need to embed. must be the same div element you will use in powerbi.embed.
    * @param {IBootstrapEmbedConfiguration} config: a bootstrap config.
    */
bootstrap(element: HTMLElement, config: IBootstrapEmbedConfiguration): embed.Embed;

Konfigurace vložení bootstrap

interface IBootstrapEmbedConfiguration {
  type: string;
  hostname?: string;
  embedUrl?: string;
  settings?: ISettings;
}

Konfigurační parametry:

  • typ (povinné): Typ entity, kterou chcete vložit, například sestava, řídicí panel, dlaždice, qna nebo vizuál.
  • název hostitele: Pokud ještě nemáte embedURL, můžete zadat název hostitele. Název hostitele je název domény adresy URL pro vložení. Pokud je například adresa URL pro vloženíhttps://app.powerbi.com/reportEmbed, název hostitele jehttps://app.powerbi.com/. Pokud není zadaný žádný název hostitele nebo embedUrl, použije se výchozí název hostitele https://app.powerbi.com/.
  • embedUrl: Stejná adresa URL pro vložení, kterou zadáte později do powerbi.embed. Pokud není zadaný žádný název hostitele nebo embedUrl, použije se výchozí název hostitele https://app.powerbi.com/.
  • nastavení: Pokud chcete sestavu vložit do mobilního rozložení nebo poskytnout národní prostředí (jazyk), zahrňte tyto parametry do počátečního nastavení.

Ukázky bootstrap

Následující ukázky poskytují referenční informace pro metodu bootstrap při vkládání entit Power BI.

Poznámka

Po přijetí parametrů pro vložení se ujistěte, že voláte powerbi.embed.

Postup spuštění pro vložení sestavy:

powerbi.bootstrap(
        reportContainerDivElement,
        {
            type: 'report',
        }
    );

Postup spuštění pro vložení řídicího panelu:

powerbi.bootstrap(
        reportContainerDivElement,
        {
            type: 'dashboard',
            embedUrl: "https://app.powerbi.com/dashboardEmbed?dashboardId=06e3ba63-47ea-4579-b010-fdb5484b325a&config=eyJjbHVzdGVyVXJsIjoiaHR0cHM6mLndpbmRvd3MubmV0In0="
        }
    );

Pokud chcete spustit metodu bootstrap pro vložení sestavy pouze s názvem hostitele:

powerbi.bootstrap(
        reportContainerDivElement,
        {
            type: 'report',
            hostname: "https://app.powerbi.com"
        }
    );

Postup spuštění pro vložení sestavy s mobilním rozložením:

powerbi.bootstrap(
        reportContainerDivElement,
        {
            type: 'report',
            hostname: "https://app.powerbi.com",
            settings: {
	            layoutType: models.LayoutType.MobilePortrait
            }
        }
    );

Důležité informace a omezení

  • Následující spouštěcí entity nelze změnit bez volání powerbi.reset(element).

    • Typ komponenty (sestava, řídicí panel): Pokud například spustíte sestavu, můžete sestavy vložit pouze do stejného elementu HTML.
    • Rozložení (desktop/mobilní zařízení)
    • Národní prostředí (jazyk)

  • Metoda powerbi.bootstrap se při vkládání stránkovaných sestav nepodporuje.

Související obsah