Fázované načítání vloženého obsahu v Power BI Embedded
Datum publikování: 15 března, 2018
Načtení vloženého artefaktu v Power BI Embedded se provádí voláním embed, které obsahuje vložený konfigurační objekt a element <div>, který obsahuje iframe. Jakmile se zavolá vložený objekt, načte se před uživatelem.
Abychom vylepšili uživatelské prostředí a poskytnuli vývojářům více nástrojů, rozšířili jsme tento tok o další volání JavaScriptu, která fázují proces vkládání:
- Přednačtení. Volání powerbi.preload() využívá mezipaměť prohlížeče a před zobrazením vlastního vloženého objektu stahuje skripty. Je užitečné pro aplikace, které hostují několik vložených sestav. Po dokončení přednačtení se aktivuje událost ready.
- Načtení metadat. Volání powerbi.load() pomáhá načíst informace o vloženém objektu a dynamicky mění nastavení nebo element <div> na pozadí, než se objekt zobrazí uživateli. Tuto funkci můžete využít k získání stránek a následnému rozhodnutí, kterou stránku uživateli zobrazit. Nebo můžete použít get visuals a potom se rozhodnout, které vizuály chcete zobrazit a které skrýt. Pokud použijete tuto funkci, musíte pro zobrazení vloženého objektu volat funkci render(). Po dokončení načtení se aktivuje událost loaded.
- Vykreslení objektu. Pokud jste implementovali funkci powerbi.load(), jako poslední se volá render(). Dokončí poslední akce potřebné k vykreslení a zobrazí vložený objekt uživateli. Po dokončení vykreslení se aktivuje událost rendered.
Přestože se funkce load a render musí používat dohromady, funkce preload je na nich nezávislá. K zobrazení vloženého objektu po přednačtení můžete použít funkci embed. Můžete také využít plně fázovaný postup voláním funkcí preload, load a render.