Optymalizowanie środowiska osadzania

  • 3 min

Za pomocą dwóch technik można zoptymalizować środowisko osadzania: Bootstrap i Phased embedd.

Korzystanie z bootstrap

Uzyskaj szybszą wydajność osadzania przy użyciu powerbi.bootstrap(embedContainer, config) funkcji. Ta funkcja przygotowuje i inicjuje iframe element przed ustawieniem wszystkich wymaganych parametrów konfiguracji. Funkcja powinna być wywoływana powerbi.embed(embedContainer, config) po ustawieniu wszystkich parametrów konfiguracji.

Poniższy kod pokazuje, jak przygotować i zainicjować iframe element raportu usługi Power BI.

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

Rozważ użycie metody bootstrap, gdy strona internetowa aplikacji najpierw ładuje się. Mimo to wywołania po stronie serwera mogą pobierać szczegóły zawartości usługi Power BI i token dostępu. Po zakończeniu wywołań po stronie serwera osadź zawartość usługi Power BI.

Diagram przepływu bootstrap opisanego w poprzednim akapicie.

Uwaga

Nie można użyć funkcji bootstrap podczas osadzania raportów podzielonych na strony.

Aby uzyskać więcej informacji, zobacz Use bootstrap for better performance (Używanie narzędzia bootstrap w celu uzyskania lepszej wydajności).

Używanie osadzania etapowego

Gdy zawartość usługi Power BI do osadzenia znajduje się na innej stronie aplikacji, istnieje alternatywna technika przyspieszania osadzania i ulepszania środowiska użytkownika.

Uwaga

Podczas osadzania na tej samej stronie zalecamy technikę bootstrap (opisaną wcześniej), ponieważ jest szybsza.

powerbi.preload(config) Użyj funkcji, aby przekazać minimalny obiekt konfiguracji składający się tylko z type właściwości iembedUrl. Wartość embedUrl powinna być podstawowym adresem URL, co oznacza, że nie wymaga określonego identyfikatora artefaktu. Wstępne ładowanie pomaga przyspieszyć osadzanie, pobierając skrypty wymagane do osadzania zawartości usługi Power BI, zanim użytkownik przejdzie do strony.

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

let element = powerbi.preload(config);

Zdarzenie preloaded jest uruchamiane po zakończeniu ładowania wstępnego

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

powerbi.load(embedContainer, config) Użyj funkcji, aby dynamicznie zmienić ustawienia elementu div przed wyświetleniem zawartości. Można na przykład użyć tej funkcji, aby uzyskać informacje o stronach raportu, a następnie określić, która strona ma być wyświetlana użytkownikowi. Jeśli używasz tej funkcji, należy również wywołać powerbi.render() funkcję w celu wyświetlenia osadzonej zawartości.

load Razem funkcje i render osiągają ten sam wynik co embed funkcja.

Diagram funkcji osadzania można osiągnąć w fazach przy użyciu funkcji ładowania i renderowania.

Chociaż należy używać funkcji load i render razem, preload jest niezależna od nich. Możesz użyć funkcji , embed aby wyświetlić obiekt osadzony po wstępnym załadowaniu. Można również użyć pełnej procedury etapowej, wywołując metodę preload, loadi render, w tej kolejności.

Aby uzyskać więcej informacji, zobacz Use phased embedding (Używanie osadzania etapowego).

Aby zapoznać się z innymi artykułami dotyczącymi optymalizacji, zobacz Najlepsze rozwiązania dotyczące szybszej wydajności w osadzonej analizie usługi Power BI.