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

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

  • Статья

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

Связанное содержимое