內嵌報告

提示

請嘗試在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 指派給 src 的 iframe 屬性。 您可以使用 報表 API 來取得此 URL。 以下為兩個範例：

  • 報表 - 在群組中取得報表
  • 報表 - 在群組中取得報表

• 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 指派給 src 的 iframe 屬性。 您可以使用 資料集 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);

下一步

內嵌報表視覺效果

內嵌編頁報告

進行報告設定

建立、編輯及儲存報表

使用啟動程式以提升效能