A beágyazási élmény optimalizálása

  • 3 perc

A beágyazási élmény optimalizálásához két technikát használhat: a bootstrap és a fázisos beágyazást.

Bootstrap használata

A függvény használatával powerbi.bootstrap(embedContainer, config) gyorsabb beágyazási teljesítményt érhet el. Ez a függvény előkészíti és inicializálja az elemet az iframe összes szükséges konfigurációs paraméter beállítása előtt. A powerbi.embed(embedContainer, config) függvényt az összes konfigurációs paraméter beállítása után kell meghívni.

Az alábbi kód bemutatja, hogyan készítheti elő és inicializálhatja egy Power BI-jelentés elemét iframe .

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

Fontolja meg a bootstrap használatát, amikor az alkalmazás weblapja először betöltődik. Bár ez történik, a kiszolgálóoldali hívások lekérhetik a Power BI-tartalom részleteit és a hozzáférési jogkivonatot. Amikor a kiszolgálóoldali hívások befejeződnek, ágyazza be a Power BI-tartalmat.

Az előző bekezdésben leírt rendszerindítási folyamat ábrája.

Megjegyzés

Lapszámozott jelentések beágyazásakor nem használható a bootstrap függvény.

További információ: A bootstrap használata a jobb teljesítmény érdekében.

Szakaszos beágyazás használata

Ha a beágyazni kívánt Power BI-tartalom az alkalmazás egy másik oldalán található, van egy alternatív módszer a beágyazás felgyorsítására és a felhasználói élmény javítására.

Megjegyzés

Ha ugyanarra a lapra ágyaz be, javasoljuk a bootstrap technikát (amelyet korábban ismertettünk), mert gyorsabb.

powerbi.preload(config) A függvénnyel egy minimális konfigurációs objektumot adhat át, amely csak a és embedUrl a type tulajdonságot tartalmazza. Az embedUrl értéknek egy alap URL-címnek kell lennie, ami azt jelenti, hogy nincs szüksége egy adott összetevő-azonosítóra. Az előtöltés felgyorsítja a beágyazást, ha letölti a Power BI-tartalmak beágyazásához szükséges szkripteket, mielőtt a felhasználó a lapra lép.

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

let element = powerbi.preload(config);

Az preloaded esemény akkor aktiválódik, amikor az előre betöltés befejeződött

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

A függvény használatával powerbi.load(embedContainer, config) dinamikusan módosíthatja az elem beállításait a div tartalom megjelenítése előtt. Ezzel a függvénnyel például információkat kérhet le a jelentésoldalakról, majd meghatározhatja, hogy melyik oldal jelenjen meg a felhasználó számára. Ha ezt a függvényt használja, a függvényt is meg kell hívnia a powerbi.render() beágyazott tartalom megjelenítéséhez.

A és render függvények load együttesen ugyanazt az eredményt érik el, mint a embed függvény.

A beágyazási függvény diagramja fázisokban érhető el a terhelési és renderelési függvények használatával.

Bár a és render a load függvényt együtt kell használnia, preload független tőlük. A függvény használatával embed előre betöltés után megjelenítheti a beágyazott objektumot. A teljes fázisú eljárást is használhatja, ha meghívja preloada , loada és rendera parancsot ebben a sorrendben.

További információ: Szakaszos beágyazás használata.

További optimalizálási cikkekért lásd: Ajánlott eljárások a power BI embedded analytics gyorsabb teljesítményéhez.