Fasindelad inläsning av inbäddat innehåll i Power BI Embedded

Inläsningen av en inbäddad artefakt i Power BI Embedded görs genom ett inbäddningsanrop som innehåller ett inbäddad konfigurationsobjekt och elementet <div> som innehåller iframe. När ett inbäddat objekt anropas läses det in så att användaren ser det.

Vi har utökat det här flödet med fler JavaScript-anrop som lägger till faser i inbäddningsprocessen för att förbättra användarupplevelsen och ge utvecklarna fler verktyg:

1. Läs in i förväg. Anropet powerbi.preload() använder webbläsarens cache-minne och laddar ned skript innan det inbäddade objektet visas. Detta kan vara bra för program som är värd för många inbäddade rapporter. En redo-händelse drar igång när förhandsinläsningen har slutförts.
2. Läs in metadata. Anropet powerbi.load() hjälper till att hämta information om det inbäddade objektet och ändrar inställningar eller elementet <div> dynamiskt i bakgrunden innan objektet visas för användaren. Du kan till exempel använda den här funktionen för att hämta sidor och sedan bestämma vilken sida som ska visas för användaren. Du kan även använda funktionen för att hämta visuella objekt och sedan välja vilka visuella objekt du vill visa eller dölja. Om du använder den här funktionen måste du anropa funktionen för att rendera() för att visa det inbäddade objektet. En inläst händelse drar igång när inläsningen har slutförts.
3. Rendera objekt. Om du implementerade funktionen powerbi.load() är det sista anropet rendera(). Då slutförs de sista åtgärderna som behövs för att rendera och visa det inbäddade objektet för användaren. En renderad händelse drar igång när renderingen har slutförts.

Även om funktionerna för att läsa in och rendera måste användas ihop är förhandsinläsningen oberoende av dem. Du kan använda funktionen för att bädda in om du vill visa det inbäddade objektet efter en förhandsinläsning. Du kan även använda den fullständigt fasindelade proceduren genom att anropa funktionerna för att läsa in i förväg, läsa in respektive rendera.