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

В этой статье рассматриваются действия по внедрению панели мониторинга в приложение. Дополнительные сведения о панелях мониторинга см. в разделе "Общие сведения о панелях мониторинга для конструкторов Power BI".

Совет

Попробуйте внедрить панель мониторинга или поэкспериментируйте с нашими клиентскими API в разделе "Изучение наших API" на тестовой площадке Power BI Embedded Analytics.

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

При внедрении содержимого Power BI в приложение используется объект конфигурации для определения внедренного содержимого и указания параметров содержимого. Затем вы передаете этот объект в API.

При внедрении панели мониторинга используйте объект конфигурации типа IDashboardLoadConfiguration:

interface IDashboardLoadConfiguration {
    accessToken: string;
    embedUrl?: string;
    id: string;
    pageView?: models.PageView 
    tokenType?: models.TokenType;
    type: string;
}

Этот интерфейс содержит следующие свойства:

• accessToken — маркер, предоставляющий доступ к внедренным данным Power BI. Дополнительные сведения о маркерах доступа см. в статье " Общие сведения о различных решениях внедрения ".

• embedUrl — URL-адрес внедренной панели мониторинга. Этот URL-адрес становится источником HTML-элемента iframe , содержащего внедренную панель мониторинга. В частности, API назначает URL-адрес src атрибуту iframe. Для получения этого URL-адреса можно использовать API панелей мониторинга . Ниже приведены два примера:

  • Панели мониторинга — получение панели мониторинга в группе
  • Панели мониторинга — получение панелей мониторинга в группе

• id — Идентификатор внедренной панели мониторинга. Используйте API панелей мониторинга для получения этого идентификатора. Например:

  • Панели мониторинга — получение панели мониторинга в группе
  • Панели мониторинга — получение панелей мониторинга в группе

• pageView — формат, который API использует для встроенной панели мониторинга. Помимо прочих, возможны следующие варианты:

  • fitToWidth — ширина внедряемой панели мониторинга будет соответствовать ширине элемента div, содержащего панель.
  • oneColumn — внедряемая панель мониторинга будет отображаться в одном столбце.
  • actualSize — API отображает встроенную панель мониторинга с полным размером.

• tokenType — Тип токена, который предоставляет доступ к внедренным данным Power BI.

  • Используется models.TokenType.Aad для внедрения для вашей организации (данные, принадлежащие пользователю).
  • Используется models.TokenType.Embed для внедрения для клиентов (данные, принадлежащие приложению).

  Дополнительные сведения см. в разделе "Общие сведения о различных решениях внедрения ".

• type — Тип содержимого, которое вы внедряете. Используется 'dashboard' для панели мониторинга.

Пример

В следующем примере показано, как внедрить одну панель мониторинга:

// Set up the configuration object that determines what to embed and how to embed it.
let embedConfiguration = {
    accessToken: anAccessToken,
    embedUrl: anEmbedUrl,
    id: aDashboardId,
    pageView: 'fitToWidth',
    tokenType: aTokenType,
    type: 'dashboard'
};
 
// Get a reference to the HTML element that contains the embedded dashboard.
let dashboardContainer = $('#dashboardContainer')[0];
 
// Embed the dashboard.
let dashboard = powerbi.embed(dashboardContainer, embedConfiguration);

Рекомендации и ограничения

• Внедрение панелей мониторинга на номераХ SKU EM не поддерживается

• При внедрении содержимого приложение отображает содержимое в элементе div . Если вы используете pageView значение при внедрении actualSize панели мониторинга:

  • Если панель мониторинга шире div элемента, API использует ширину div элемента в качестве ширины встроенной панели мониторинга.
  • Если панель мониторинга узче div элемента, API заполняет неиспользуемое пространство встроенным фоном. По умолчанию этот фон является белым, но его можно настроить так, чтобы он был прозрачным. В этом случае div стилизация элемента отображается в неиспользуемом пространстве.

Дальнейшие действия

Внедрение отчета в Power BI Embedded

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

Использование начальной загрузки для повышения производительности