共用方式為

內嵌報表

  • 發行項

提示

請嘗試在 Power BI Embedded Analytics 遊樂場的 探索我們的 API 區段中，內嵌報表或實驗我們的用戶端 API。

本文涵蓋在應用程式中內嵌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指派給 iframe的 src 屬性。 您可以使用 報表 API 來取得此 URL。 兩個範例包括：

  • id - 您要內嵌的 Power BI 報表識別碼。

  • permissions - 您授與使用者內嵌報表的作業。 這些值可供使用：

    • Read - 使用者可以檢視報表。
    • ReadWrite - 使用者可以檢視、編輯及儲存報表。
    • Copy - 使用者可以使用另存新檔來儲存報表的複本。
    • Create - 使用者可以建立新的報表。
    • All - 使用者可以建立、檢視、編輯、儲存及儲存報表複本。

  • tokenType - 可讓您存取所內嵌之 Power BI 數據的令牌類型。

    • 如果您要內嵌組織（使用者擁有數據），請使用 models.TokenType.Aad。
    • 如果您要為客戶內嵌 models.TokenType.Embed （應用程式擁有資料）。

    如需詳細資訊，請參閱 瞭解不同的內嵌解決方案。

  • type - 您要內嵌的內容種類。 針對 Power BI 報表使用 'report'。

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指派給 iframe的 src 屬性。 您可以使用 資料集 API 來取得此 URL。 兩個範例包括：

如需編輯和建立報表的相關信息，請參閱 建立、編輯和儲存內嵌報表。

例

下列範例示範如何內嵌報表：

// 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);

相關內容