內嵌其他 Power BI 內容類型

  • 5 分鐘

您可以內嵌其他類型的 Power BI 內容，包括 Power BI 報表視覺效果、編頁報表、儀表板、儀表板磚和 Q&A 體驗。 不同於 Power BI 報表，您無法編輯或建立這些其他內容類型。

內嵌 Power BI 報表視覺效果

您可以內嵌源自 Power BI 報表的單一報表視覺化。 使用類型 IVisualLoadConfiguration 的組態物件。 除了必要的屬性 (單元 1 中所述；type 屬性會設定為 visual)，您必須也設定下列屬性。

  • pageName - 需要包含您內嵌視覺效果的頁面名稱。 您可以使用報表 getPages 函式來取得報表中的頁面。
  • visualName - 必要。 您內嵌視覺效果的名稱。 您可以使用頁面 getVisuals 函式來取得頁面中的視覺效果。

您的應用程式可以使用 updateFilters 函式將篩選套用至視覺效果。

提示

請勿內嵌來自相同頁面的太多視覺效果，因為它可能無法正常執行。 此外，如果在內嵌相同報表中的數個視覺效果時需要更多控制權，您可以使用自訂版面配置更有效率達到此目的。 如需自訂版面配置的詳細資訊，請參閱個人化報表版面配置。

如需內嵌 Power BI 報表視覺效果的完整說明，請參閱內嵌報表視覺效果。

內嵌編頁報表

您可以使用類型 IEmbedConfigurationBase 的組態物件來內嵌編頁報表。 除了必要的屬性 (單元 1 中所述；type 屬性會設定為 report)，您必須也設定下列屬性。

  • id - 必要。 包含編頁報表的工作區識別碼 (GroupID)。
  • uniqueId - 必要。 編頁報表的 ReportID。

另外還有 settings 屬性，這是選擇性項目。 您可以傳遞 IPaginatedReportSettings 類型的物件，以指定報表參數面板外觀的相關資訊。 您的應用程式可以啟用並展開開啟面板。

若要設定編頁報表參數，請以內嵌 URL 加以傳送。 不過，您無法設定多參數值。 如需詳細資訊，請參閱針對 Power BI 中的編頁報表以 URL 傳遞報表參數。

如需內嵌編頁報表的完整說明，請參閱內嵌編頁報表。

內嵌儀表板

您可以使用類型 IDashboardLoadConfiguration 的組態物件來內嵌儀表板。 除了必要的屬性 (單元 1 中所述；type 屬性會設定為 dashboard)，您也可以設定 pageView 屬性。 這些選項包括：

  • fitToWidth - 內嵌儀表板的寬度符合包含儀表板的 div 元素寬度。
  • oneColumn - 內嵌儀表板會顯示在一個資料行中。 此選項適用於小型規格裝置，例如行動電話。
  • actualSize - 內嵌儀表板會以完整大小顯示。

如需內嵌儀表板的完整說明，請參閱內嵌儀表板。

內嵌儀表板磚

您可以使用類型 ITileLoadConfiguration 的組態物件來內嵌儀表磚。 除了必要的屬性 (單元 1 中所述；type 屬性會設定為 tile)，您必須也設定下列屬性。

  • dashboardId - 必要。 包含磚的儀表板 DashboardID。
  • id - 必要。 儀表板磚的識別碼。 您可以使用 Power BI REST API 來取得儀表板磚及其屬性。

如需內嵌儀表板磚的完整說明，請參閱內嵌儀表板磚。

內嵌 Q&A 體驗

您可以使用類型 ILoadQnaConfiguration 的組態物件來內嵌 Q&A 體驗。 除了必要的屬性 (單元 1 中所述；type 屬性會設定為 qna)，您應也設定下列屬性。

  • datasetIds - 必要。 DatasetID 的陣列。 不過，目前僅支援一個 DatasetID。
  • viewMode - 選擇性。 QnaMode.Interactive 可讓使用者輸入問題，或 QnaMode.ResultOnly 需要提供的問題。
  • question - 選擇性。 您應用程式提供的問題。 viewMode 屬性必須設定為 QnaMode.ResultOnly。

提示

鼓勵使用 Q&A 有助於減少您必須開發的報表和儀表板數目。 此外，您也可以從 Power BI 報表內嵌 Q&A 視覺效果。 此方法提供格式化視覺效果的功能，且應用程式可以將篩選套用至視覺效果。

如需內嵌 Q&A 體驗的完整說明，請參閱內嵌獨立 Q&A 視覺效果。