Freigeben über


Verwenden des Vorladens zum Reduzieren der Ladezeit

Die powerbi.preload-API wird verwendet, um die Ladezeit des eingebetteten Inhalts in Power BI zu reduzieren, wenn sich ihr eingebetteter Inhalt auf einer anderen Seite befindet. Preload verwendet eine minimale Konfiguration (nur type und embedURL), um die skripts herunterzuladen, die zum Einbetten von Power BI-Inhalten erforderlich sind, bevor Ihre Benutzer zu dieser Seite navigieren. Dies bietet eine schnellere Erfahrung beim Anzeigen eingebetteter Berichte und Dashboards. Preload sollte nur verwendet werden, wenn sich der Power BI-Inhalt auf einer anderen Seite der Webanwendungbefindet.

Anmerkung

Als bewährte Methode für die Leistung empfehlen wir die Verwendung der Bootstrap-Methode anstelle des Vorabladens.

Verwenden des Vorabladens

powerbi.preload() wird verwendet, um die erforderlichen Skripts herunterzuladen, bevor Sie Ihre Inhalte einbetten. Der Browser speichert diese Skripts im Cache, wodurch der anfängliche Aufruf von powerbi.embed() schneller erfolgt. Um das Vorabladen zu verwenden, müssen Sie den Typ der eingebetteten Entität und eine Basis-URL für Power BI angeben (Einbetten von URLs ohne bestimmte URL-Parameter wie reportId oder groupId).

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

let element = powerbi.preload(config);

Das preload-Ereignis wird ausgelöst, wenn das Vorabladen abgeschlossen ist.

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