Внедрение отчета

  • Статья

Кончик

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

В этой статье рассматриваются действия по внедрению отчета Power BI в приложение. Дополнительные сведения о отчетах в отчетах в Power BI.

Внедрение отчета

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

Внедрение существующего отчета

При внедрении отчета, который уже существует, используйте объект конфигурации типа IReportLoadConfiguration.

interface IReportLoadConfiguration {
    accessToken: string;
    bookmark?: models.IApplyBookmarkRequest;
    contrastMode?: models.ContrastMode;
    datasetBinding?: models.IDatasetBinding;
    embedUrl?: string;
    filters?: models.ReportLevelFilters[];
    id: string;
    pageName?: string;
    permissions?: models.Permissions;
    settings?: models.IEmbedSettings;
    slicers?: models.ISlicer[];
    theme?: models.IReportTheme;
    tokenType?: models.TokenType;
    type: string;
    viewMode?: models.ViewMode;
}

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

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

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

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

  • id — идентификатор внедренного отчета Power BI.

  • permissions — операции, предоставляемые пользователям для внедренного отчета. Эти значения доступны:

    • Read. Пользователи могут просматривать отчет.
    • ReadWrite. Пользователи могут просматривать, изменять и сохранять отчет.
    • Copy. Пользователи могут сохранить копию отчета с помощью сохранения как.
    • Create . Пользователи могут создать новый отчет.
    • All. Пользователи могут создавать, просматривать, изменять, сохранять и сохранять копию отчета.

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

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

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

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

Интерфейс IReportLoadConfiguration также содержит другие свойства. Дополнительные сведения об этих свойствах см. в настройке параметров отчета:

  • bookmark
  • contrastMode
  • filters
  • pageName
  • settings
  • slicers
  • theme
  • viewMode

Внедрение нового отчета

При внедрении нового отчета, создаваемого из набора данных, используйте объект конфигурации типа IReportCreateConfiguration.

interface IReportCreateConfiguration {
    accessToken: string;
    datasetId: string;
    embedUrl?: string;
    settings?: models.IEmbedSettings;
    theme?: IReportTheme;
    tokenType?: models.TokenType;
    type: string;
}

Свойства в этом интерфейсе похожи на свойства в интерфейсе IReportLoadConfiguration со следующими исключениями:

  • datasetId — идентификатор набора данных, который определяет схему данных, которую использует новый отчет.

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

Сведения о редактировании и создании отчетов см. в создания, изменения и сохранения внедренного отчета.

Пример

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

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

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