İngilizce dilinde oku

Aracılığıyla paylaş

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.

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

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

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

Bootstrap API'si

powerbi.bootstrap(element, config) yöntemi, powerbi.embed(...)ile aynı ş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:

  • tür (gerekli): Eklemek istediğiniz varlık türü(örneğin, 'rapor', 'pano', 'kutucuk', 'qna' veya 'görsel'.
  • konak adı: Henüz bir embedURL 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, https://app.powerbi.com/varsayılan ana bilgisayar adı kullanılır.
  • embedUrl: Daha sonra powerbi.embed adresine sağlayacağınız ekleme URL'si. Konak adı veya embedUrl sağlanmazsa, https://app.powerbi.com/varsayılan ana bilgisayar adı 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 powerbi.embed çağırdığınızdan 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="
        }
    );

Raporu yalnızca konak adıyla 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
            }
        }
    );

Dikkat edilmesi gerekenler ve sınırlamalar

  • Aşağıdaki önyüklenmiş varlıklar powerbi.reset(element)çağrılmadan 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ış raporlar eklerken powerbi.bootstrap yöntemi desteklenmez.

İlgili içerik