Внедрение плитки панели мониторинга
Совет
Попробуйте внедрить плитку панели мониторинга или поэкспериментировать с нашими клиентскими API в разделе "Обзор api"на тестовой площадке Power BI Embedded Analytics.
В этой статье рассматриваются действия по внедрению плитки панели мониторинга в приложение. Дополнительные сведения о плитках панели мониторинга см. в разделе " Введение в плитки панели мониторинга" для конструкторов Power BI.
Внедрение плитки панели мониторинга
При внедрении содержимого Power BI в приложение используется объект конфигурации для определения содержимого, которое вы внедряете, и для указания параметров содержимого. Затем этот объект передается в API.
При внедрении плитки панели мониторинга используйте объект конфигурации типа ITileLoadConfiguration:
interface ITileLoadConfiguration {
accessToken: string;
dashboardId: string;
embedUrl: string;
id: string;
tokenType?: models.TokenType;
type: string;
}
Этот интерфейс содержит следующие свойства:
accessToken— маркер, который предоставляет доступ к внедренным данным Power BI. Ознакомьтесь с различными решениями внедрения, чтобы узнать больше о маркерах доступа.dashboardId— Идентификатор панели мониторинга, содержащей внедренную плитку. Для получения этого идентификатора можно использовать API панелей мониторинга . Ниже приведены два примера:embedUrl— URL-адрес плитки панели мониторинга, которую вы внедряете. Этот URL-адрес становится источником HTML-элементаiframe, содержащего внедренную плитку панели мониторинга. В частности, API назначает URL-адрес атрибутуsrc.iframeДля получения этого URL-адреса можно использовать API панелей мониторинга . Ниже приведены два примера:id— Идентификатор плитки панели мониторинга, которую вы внедряете. Для получения этого идентификатора можно использовать API панелей мониторинга . Ниже приведены два примера:tokenType— тип токена, который предоставляет доступ к внедренным данным Power BI.- Используйте
models.TokenType.Aad, если вы внедряете данные в организацию (пользователь владеет данными). - Используйте
models.TokenType.Embed, если вы внедряете данные для клиентов (приложение владеет данными).
Дополнительные сведения см. в разделе "Общие сведения о различных решениях внедрения ".
- Используйте
type— Тип содержимого, которое вы внедряете. Используется'tile'для плитки панели мониторинга.
Пример
В следующем примере показано, как внедрить одну плитку панели мониторинга:
// Set up the configuration object that determines what to embed and how to embed it.
let embedConfiguration = {
accessToken: anAccessToken,
dashboardId: aDashboardId,
embedUrl: anEmbedUrl,
id: aTileId,
tokenType: aTokenType,
type: 'tile'
};
// Get a reference to the HTML element that contains the embedded dashboard tile.
let tileContainer = $('#tileContainer')[0];
// Embed the dashboard.
let tile = powerbi.embed(tileContainer, embedConfiguration);