De insluitingservaring optimaliseren

Voltooid

U kunt twee technieken gebruiken om de insluitingservaring te optimaliseren: Bootstrap en Gefaseerd insluiten.

Bootstrap gebruiken

Bewerk snellere insluitingsprestaties met behulp van de powerbi.bootstrap(embedContainer, config) functie. Met deze functie wordt het iframe element voorbereid en geïnitialiseerd voordat alle vereiste configuratieparameters zijn ingesteld. De powerbi.embed(embedContainer, config) functie moet worden aangeroepen zodra alle configuratieparameters zijn ingesteld.

De volgende code laat zien hoe u het iframe element voor een Power BI-rapport voorbereidt en initialiseert.

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

Overweeg bootstrap te gebruiken wanneer de webpagina van uw app voor het eerst wordt geladen. Terwijl dat gebeurt, kunnen aanroepen aan de serverzijde de details van de Power BI-inhoud en het toegangstoken ophalen. Wanneer de aanroepen aan de serverzijde zijn voltooid, sluit u de Power BI-inhoud in.

Diagram van de bootstrapstroom die in de vorige alinea wordt beschreven.

Notitie

Het is niet mogelijk om de bootstrap-functie te gebruiken bij het insluiten van gepagineerde rapporten.

Zie Bootstrap gebruiken voor betere prestaties voor meer informatie.

Gefaseerd insluiten gebruiken

Wanneer de Power BI-inhoud die u wilt insluiten zich op een andere pagina van uw app bevindt, is er een alternatieve techniek om het insluiten te versnellen en de gebruikerservaring te verbeteren.

Notitie

Wanneer u op dezelfde pagina insluit, raden we de bootstrap-techniek (eerder beschreven) aan omdat deze sneller is.

Gebruik de powerbi.preload(config) functie om een minimaal configuratieobject door te geven dat alleen de type eigenschappen en embedUrl bevat. De embedUrl waarde moet een basis-URL zijn, wat betekent dat er geen specifieke artefact-id nodig is. Vooraf laden helpt het insluiten te versnellen door de scripts te downloaden die nodig zijn om Power BI-inhoud in te sluiten voordat de gebruiker naar de pagina navigeert.

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

let element = powerbi.preload(config);

De preloaded gebeurtenis wordt geactiveerd wanneer de preload is voltooid

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

Gebruik de powerbi.load(embedContainer, config) functie om de instellingen in het div element dynamisch te wijzigen voordat de inhoud wordt weergegeven. U kunt deze functie bijvoorbeeld gebruiken om informatie op te halen over de rapportpagina's en vervolgens te bepalen welke pagina aan de gebruiker moet worden weergegeven. Als u deze functie gebruikt, moet u ook de powerbi.render() functie aanroepen om de ingesloten inhoud weer te geven.

Samen bereiken de load functies en render hetzelfde resultaat als de embed functie.

Diagram van de insluitfunctie kan in fasen worden bereikt met behulp van de functies load en render.

Hoewel u de load functies en render samen moet gebruiken, preload is het onafhankelijk van hen. U kunt de embed functie gebruiken om het ingesloten object weer te geven na het vooraf laden. U kunt ook de volledig gefaseerde procedure gebruiken door , loaden renderaan te roepen preloadin die volgorde.

Zie Gefaseerd insluiten gebruiken voor meer informatie.

Zie Best practices voor snellere prestaties in ingesloten analyses in Power BI voor andere optimalisatieonderwerpen.