Daha iyi performans için bootstrap kullanma

  • Makale

powerbi.bootstrap , geliştiricilerin Power BI varlıklarını daha hızlı eklemesine ve daha iyi performans elde etmelerine yardımcı olmak için İstemci SDK'sı sürüm 2.9.0'da kullanıma sunulan bir yöntemdir.

kullanarak powerbi.embed rapor eklemek için , embedURLve accessTokengibi reportIdbirden çok parametre gerekir. Bu parametreler her zaman hemen kullanılamaz.

powerbi.bootstrap tüm gerekli parametreler kullanılabilir olmadan önce eklemeye başlamanızı sağlar. Önyükleme API’si, iframe’i hazırlar ve başlatır.

Gerekli parametreler alındıktan sonra aynı powerbi.embed(element, config) HTML öğesinde çağrılmalıdır.

Bootstrap API'si

yöntemi ile powerbi.bootstrap(element, config) aynı powerbi.embed(...)şekilde bir öğe ve yapılandırma alır.

/**
    * 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;

Bootstrap ekleme yapılandırması

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

Yapılandırma parametreleri:

  • type (gerekli): 'report', 'dashboard', 'tile', 'qna' veya 'visual' gibi eklemek istediğiniz varlık türü.
  • ana bilgisayar adı: Henüz bir embedURL ana bilgisayar adınız yoksa bir konak adı sağlayabilirsiniz. Ana bilgisayar adı, ekleme URL'sinin etki alanı adıdır. Örneğin, ekleme URL'si 'https://app.powerbi.com/reportEmbed' ise ana bilgisayar adı 'https://app.powerbi.com/' olur. Konak adı veya embedUrl sağlanmazsa, varsayılan ana bilgisayar adı https://app.powerbi.com/olan kullanılır.
  • embedUrl: Daha sonra powerbi.embed'e sağlayacağınız ekleme URL'si. Konak adı veya embedUrl sağlanmazsa, varsayılan ana bilgisayar adı https://app.powerbi.com/olan kullanılır.
  • ayarlar: Raporu mobil düzene eklemek veya yerel ayar (dil) sağlamak için bu parametreleri ilk ayarlara ekleyin.

Bootstrap örnekleri

Aşağıdaki örnekler, Power BI varlıklarını eklerken bootstrap yöntemi için bir başvuru sağlar.

Not

Ekleme parametrelerini aldıktan sonra çağırdığınızdan powerbi.embed emin olun.

Rapor eklemeye yönelik önyükleme yapmak için:

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

Pano eklemeye yönelik önyükleme yapmak için:

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

Yalnızca konak adıyla rapor eklemeye yönelik bootstrap yapmak için:

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

Mobil düzende rapor eklemeye yönelik önyükleme yapmak için:

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

Sınırlamalar

  • Aşağıdaki önyüklenmiş varlıklar çağrılmadan powerbi.reset(element)değiştirilemez.

    • Bileşen türü (rapor, pano): Örneğin, bir raporu önyüklerseniz, raporları yalnızca aynı HTML öğesine ekleyebilirsiniz.
    • Düzen (masaüstü/mobil)
    • Yerel Ayar (dil)

  • Sayfalandırılmış powerbi.bootstrap raporlar eklerken yöntemi desteklenmez.

Sonraki adımlar