Beágyazott tartalom többfázisú betöltése a Power BI Embeddedben

A beágyazott összetevők betöltése a Power BI Embeddedben az embed híváson keresztül történik, amely tartalmaz egy beágyazott konfigurációs objektumot és az iframe-et tartalmazó <div> elemet. A beágyazott objektum a meghívása után betöltődik a felhasználó számára.

A felhasználói élmény javítása érdekében, és hogy több eszközt adjunk a fejlesztők kezébe, ezt a folyamatot most a beágyazási folyamathoz fázisokat adó további JavaScript-hívásokkal bővítettük ki:

1. Előzetes betöltés (Preload). A powerbi.preload() hívás a böngésző gyorsítótárát használja a szkriptek letöltésére, mielőtt megjelenítené magát a beágyazott objektumot. Ez több beágyazott jelentést tartalmazó alkalmazások esetén lehet hasznos. Az előzetes betöltés végén egy ready (kész) esemény lesz elindítva.
2. Metaadatok betöltése. A powerbi.load() hívás segít információt betölteni a beágyazott objektumba, és a háttérben dinamikusan változtatja a beállításokat vagy a <div> elemet, mielőtt az objektum megjelenik a felhasználó számára. Ez a függvény felhasználható például oldalak betöltésére, hogy aztán eldöntse, mely oldalakat mutat meg a felhasználónak. Használható még vizualizációk betöltésére, melyekről aztán eldönthető, hogy melyik jelenjen meg és melyik legyen elrejtve. Ennek a függvénynek a használatakor a render() függvényt is meg kell hívni a beágyazott objektum megjelenítéséhez. A betöltés végén egy loaded (betöltve) esemény lesz elindítva.
3. Objektum leképezése. A powerbi.load() függvény használata esetén az utolsó függvényhívás a render(). Ez fejezi be a beágyazott objektum leképezésének és megjelenítésének utolsó műveleteit. A leképezés végén egy rendered esemény lesz elindítva.

A load és a render függvényt együtt kell használni, a preload viszont ezektől független. Az előzetes betöltés után a beágyazott objektum az embed (beágyazás) függvény használatával jeleníthető meg. A teljes többfázisú eljárás is használható a preload, load illetve render függvény meghívásával.