Faseinddelt indlæsning af integreret indhold i Power BI Embedded

Indlæsningen af en integreret artefakt i Power BI Embedded udføres via et embed-kald, der indeholder et integreret konfigurationsobjekt og det <div>-element, som indeholder en iframe. Efter kaldet til det integrerede objekt indlæses det for brugeren.

Da vi gerne vil forbedre brugeroplevelsen og stille flere værktøjer til rådighed for udviklerne, har vi udvidet denne proces med flere JavaScript-kald, der føjer faser til integreringsprocessen:

1. Forudindlæsning. Kaldet powerbi.preload() bruger browserens cache og downloadscripts, før det integrerede objekt vises. Dette kan være praktisk til de apps, der indeholder flere integrerede rapporter. Hændelsen ready aktiveres, når preload er fuldført.
2. Indlæsning af metadata. Kaldet powerbi.load() hjælper med at hente oplysninger om det integrerede objekt, og det ændrer dynamisk indstillingerne eller <div>-elementet i baggrunden, før objektet vises til brugeren. Du kan for eksempel bruge denne funktion til at hente sider og derefter beslutte, hvilen side der skal vises til brugeren. Eller du kan bruge get visuals og derefter beslutte, hvilke visuelle elementer du vil vise eller skjule. Hvis du bruger denne funktion, skal du foretage et kald til funktionen render() for at vise det integrerede objekt. Når indlæsningen er fuldført, udløses hændelsen loaded.
3. Gengiv objekt. Det sidst kald, du skal udføre, hvis du implementerede funktionen powerbi.load(), er render(). Den fuldfører de sidste handlinger, der skal gengive og vise det integrerede objekt til brugeren. Hændelsen rendered udløses, når gengivelsen er fuldført.

Selvom funktionerne load og render skal bruges sammen, er preload uafhængig af disse. Du kan bruge funktionen embed til at vise det integrerede objekt efter forhåndsindlæsningen. Du kan også bruge den komplette faseinddelte procedure ved at foretage kald til preload, load og render.