В этой статье рассматриваются действия по внедрению плитки панели мониторинга в приложение. Дополнительные сведения о плитках панели мониторинга в введение в плитки панели мониторинга для конструкторов 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);