內嵌其他 Power BI 內容類型
您可以內嵌其他類型的 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 視覺效果。