Поэтапная загрузка внедренного содержимого в Power BI Embedded

Загрузка внедренного артефакта в Power BI Embedded выполняется через вызов функции embed, которая содержит внедренный объект конфигурации и элемент <div>, содержащий iframe. После вызова внедренного объекта он будет загружен на глазах у пользователя.

Чтобы улучшить взаимодействие с пользователем и предоставить дополнительные средства для разработчиков, мы расширили этот процесс и добавили дополнительные вызовы JavaScript, добавляющие этапы к процессу внедрения:

1. Предварительная загрузка. Перед отображением внедренного объекта в вызове функции powerbi.preload() используется кэш браузера и скрипты загрузки. Это пригодится для приложений, в которых размещается несколько внедренных отчетов. Событие ready выдается после предварительной загрузки.
2. Загрузка метаданных. При вызове функции powerbi.load() можно получить информацию о внедренном объекте и динамично изменить параметры или элемент <div> в фоновом режиме перед отображением объекта пользователю. Например, с помощью этой функции можно получить страницы и выбрать, какие из них будут показаны пользователю. Или можно использовать функцию get visuals, а потом выбрать отображаемые визуальные элементы. Для использования этой функции необходимо вызвать функцию render(), чтобы показать внедренный объект. После загрузки будет выдано событие loaded.
3. Преобразование объекта для просмотра. Если вы реализовали функцию powerbi.load(), последней вызывается функция render(). Вызов завершает последние действия, необходимые, чтобы преобразовать внедренный объект для просмотра и показать его пользователю. После преобразования для просмотра выдается событие rendered.

Функции load и render необходимо использовать вместе, а функция preload не зависит от них. С помощью функции embed можно отобразить внедренный объект после предварительной загрузки. Для вызова функций preload, load и render соответственно можно также использовать всю поэтапную процедуру.