Поделиться через


Внедрение плитки панели мониторинга

Кончик

Попробуйте внедрить плитку панели мониторинга или поэкспериментировать с нашими клиентскими 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-адрес атрибуту srciframe. Для получения этого 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);