Power BI Embedded’de eklenen içeriği aşamalı olarak yükleme

Power BI Embedded’de eklenen bir yapıtın yüklemesi, eklenen bir yapılandırma nesnesini içeren ekleme çağrısı ve iframe içeren <div> öğesi aracılığıyla gerçekleştirilir. Eklenen nesne çağrıldıktan sonra kullanıcının karşısında yüklenir.

Kullanıcı deneyimini iyileştirmek ve geliştiricilere daha fazla araç sunmak için ekleme işlemine aşama ekleyen daha JavaScript çağırısı ile bu akışı genişlettik:

1. Önyükleme. powerbi.preload() çağrısı, tarayıcının önbelleğini kullanır ve eklenen nesnenin kendisini göstermeden önce betikleri indirir. Bu, birden çok eklenen raporu barındıran uygulamalar için faydalı olabilir. Önyükleme tamamlandıktan sonra hazır bir olay tetiklenir.
2. Meta veri yükleme. powerbi.load() çağrısı, eklenen nesne ile ilgili bilgi alınmasına yardımcı olur ve nesne kullanıcıya görüntülenmeden önce ayarları veya arka plandaki <div> öğesini dinamik olarak değiştirir. Örneğin, sayfaları almak ve sonra kullanıcıya hangi sayfanın gösterileceğini belirlemek için bu işlevi kullanabilirsiniz. Alternatif olarak, görselleri al işlevini kullanabilir ve hangi görsellerin gösterilip hangilerinin gizleneceğini belirleyebilirsiniz. Bu işlevi kullanırsanız eklenen nesnenin gösterilmesi için render() işlevini çağırmanız gerekir. Yükleme tamamlandıktan sonra yüklenen bir olay tetiklenir.
3. Nesne işleme. powerbi.load() işlevini uyguladıysanız son olarak render() çağrısını kullanın. Bu çağrı, eklenen nesneyi işlemek ve kullanıcıya göstermek için son eylemleri tamamlar. İşleme tamamlandıktan sonra işlenen bir olay tetiklenir.

Yükleme ve işleme işlevlerinin birlikte kullanılması gerekir ancak önyükleme bunlardan bağımsızdır. Önyüklemeden sonra, eklenen nesneyi göstermek için ekleme işlevini kullanabilirsiniz. Ayrıca önyükleme, yükleme ve oluşturma işlevlerini sırasıyla çağırarak tam aşamalı prosedürü de kullanabilirsiniz.