Udostępnij za pośrednictwem

Korzystanie z bootstrap w celu uzyskania lepszej wydajności

  • Artykuł

powerbi.bootstrap to metoda wprowadzona w zestawie SDK klienta w wersji 2.9.0, która ułatwia deweloperom szybsze osadzanie jednostek usługi Power BI i uzyskiwanie lepszej wydajności.

Osadzanie raportu przy użyciu powerbi.embed wymaga wielu parametrów, takich jak reportId, embedURLi accessToken. Te parametry nie zawsze są natychmiast dostępne.

powerbi.bootstrap umożliwia rozpoczęcie osadzania przed udostępnieniem wszystkich wymaganych parametrów. Interfejs API uruchamiania przygotowuje i inicjuje element iframe.

Po odebraniu wymaganych parametrów należy wywołać powerbi.embed(element, config) dla tego samego elementu HTML.

Interfejs API uruchamiania

Metoda powerbi.bootstrap(element, config) odbiera element i konfigurację, tak samo jak 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;

Konfiguracja osadzania bootstrap

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

Parametry konfiguracji:

  • typ (wymagane): typ jednostki, którą chcesz osadzić, na przykład "raport", "pulpit nawigacyjny", "kafelek", "qna" lub "wizualizacja".
  • nazwa hosta: jeśli nie masz jeszcze embedURL, możesz podać nazwę hosta. Nazwa hosta to nazwa domeny adresu URL osadzania. Jeśli na przykład adres URL osadzania to "https://app.powerbi.com/reportEmbed", nazwa hosta to "https://app.powerbi.com/". Jeśli nie podano nazwy hosta lub adresu embedUrl, zostanie użyta domyślna nazwa hosta https://app.powerbi.com/.
  • embedUrl: ten sam adres URL osadzania, który później udostępnisz w pliku powerbi.embed. Jeśli nie podano nazwy hosta lub adresu embedUrl, zostanie użyta domyślna nazwa hosta https://app.powerbi.com/.
  • ustawienia: aby osadzić raport w układzie mobilnym lub udostępnić ustawienia regionalne (język), uwzględnij te parametry w ustawieniach początkowych.

Przykłady uruchamiania

Poniższe przykłady zawierają odwołanie do metody bootstrap podczas osadzania jednostek usługi Power BI.

Nuta

Upewnij się, że wywołasz powerbi.embed po otrzymaniu parametrów osadzania.

Aby uruchomić program na potrzeby osadzania raportu:

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

Aby uruchomić program na potrzeby osadzania pulpitu nawigacyjnego:

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

Aby uruchomić program na potrzeby osadzania raportu tylko z nazwą hosta:

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

Aby uruchomić program na potrzeby osadzania raportu z układem mobilnym:

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

Zagadnienia i ograniczenia

  • Nie można zmienić następujących bootstrapped jednostek bez wywoływania powerbi.reset(element).

    • Typ składnika (raport, pulpit nawigacyjny): na przykład w przypadku uruchamiania raportu można osadzać raporty tylko w tym samym elemencie HTML.
    • Układ (desktop/mobile)
    • Ustawienia regionalne (język)

  • Metoda powerbi.bootstrap nie jest obsługiwana podczas osadzania raportów podzielonych na strony.

Powiązana zawartość