Ekleme deneyimini iyileştirme

  • 3 dakika

Ekleme deneyimini iyileştirmek için iki teknik kullanabilirsiniz: Bootstrap ve Aşamalı ekleme.

Bootstrap kullanma

işlevini kullanarak daha hızlı ekleme performansı elde edin powerbi.bootstrap(embedContainer, config) . Bu işlev, gerekli tüm yapılandırma parametreleri ayarlanmadan iframe önce öğesini hazırlar ve başlatır. powerbi.embed(embedContainer, config) Tüm yapılandırma parametreleri ayarlandıktan sonra işlevi çağrılmalıdır.

Aşağıdaki kod, bir Power BI raporu için öğesinin nasıl hazırlanıp başlatılmış olduğunu iframe gösterir.

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

Uygulamanızın web sayfası ilk yüklendiğinde bootstrap kullanmayı göz önünde bulundurun. Bu durumda sunucu tarafı çağrıları Power BI içerik ayrıntılarını ve erişim belirtecini alabilir. Sunucu tarafı çağrıları tamamlandığında Power BI içeriğini ekleyin.

Önceki paragrafta açıklanan bootstrap akışının diyagramı.

Not

Sayfalandırılmış raporları eklerken bootstrap işlevini kullanmak mümkün değildir.

Daha fazla bilgi için bkz . Daha iyi performans için bootstrap kullanma.

Aşamalı ekleme kullanma

Eklemek istediğiniz Power BI içeriği uygulamanızın farklı bir sayfasına eklendiğinde, ekleme işlemini hızlandırmak ve kullanıcı deneyimini geliştirmek için alternatif bir teknik vardır.

Not

Aynı sayfaya eklerken daha hızlı olduğundan bootstrap tekniğini (daha önce açıklanmıştır) öneririz.

powerbi.preload(config) yalnızca type ve embedUrl özelliklerinden oluşan en düşük yapılandırma nesnesini geçirmek için işlevini kullanın. Değer embedUrl bir temel URL olmalıdır; başka bir deyişle belirli bir yapıt kimliğine ihtiyacı yoktur. Önceden yükleme, kullanıcı sayfaya gitmeden önce Power BI içeriğini eklemek için gereken betikleri indirerek ekleme işlemini hızlandırmaya yardımcı olur.

// Building the configuration object
let config = {
    type: 'report',
    embedUrl: 'https://app.powerbi.com/reportEmbed',
};

let element = powerbi.preload(config);

preloaded Ön yükleme tamamlandığında olay tetikleniyor

element.on('preloaded', function () {
    ...
});

powerbi.load(embedContainer, config) İçerik görüntülenmeden önce öğedeki div ayarları dinamik olarak değiştirmek için işlevini kullanın. Örneğin, rapor sayfaları hakkında bilgi almak ve kullanıcıya hangi sayfanın gösterileceğini belirlemek için bu işlevi kullanabilirsiniz. Bu işlevi kullanırsanız, eklenmiş içeriği göstermek için işlevini de çağırmanız powerbi.render() gerekir.

ve render işlevleri birlikte load işleviyle aynı sonucu elde edinembed.

Ekleme işlevinin diyagramı, yük ve işleme işlevleri kullanılarak aşamalar halinde gerçekleştirilebilir.

ve render işlevlerini birlikte kullanmanız load gerekse de, preload bunlardan bağımsızdır. Önceden yüklemeden embed sonra eklenmiş nesneyi göstermek için işlevini kullanabilirsiniz. Ayrıca, , loadve renderçağrılarını bu sırayla yaparak preloadtam aşamalı yordamı da kullanabilirsiniz.

Daha fazla bilgi için bkz. Aşamalı ekleme kullanma.

Diğer iyileştirme makaleleri için bkz. Power BI tümleşik analizlerinde daha hızlı performans için en iyi yöntemler.