Внедрение плитки панели мониторинга
Кончик
Попробуйте внедрить плитку панели мониторинга или поэкспериментировать с нашими клиентскими 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-адрес становится источником элемента HTMLiframe
, содержащего внедренную плитку панели мониторинга. В частности, 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);