嵌入其他 Power BI 内容类型
可以嵌入其他类型的 Power BI 内容,包括 Power BI 报表视觉对象、分页报表、仪表板、仪表板磁贴和问答体验。 与 Power BI 报表不同,无法编辑或创建这些其他内容类型。
嵌入 Power BI 报表视觉对象
可以嵌入源自 Power BI 报表的单个报表视觉对象。 使用类型为 IVisualLoadConfiguration
的配置对象。 除了必需属性(如第 1 单元所述;type
属性设置为“visual”),还必须设置以下属性。
-
pageName
- 必需。包含要嵌入的视觉对象的页面的名称。 可以使用 Report getPages 函数获取报表中的页面。 -
visualName
- 必需。 要嵌入的视觉对象的名称。 可以使用 Page getVisuals 函数获取页面中的视觉对象。
应用可以通过使用 updateFilters 函数将筛选器应用于视觉对象。
提示
请勿嵌入源自同一页面的太多视觉对象,因为性能可能不佳。 此外,如果在嵌入来自同一报表的多个视觉对象时需要更多控制,可以使用自定义布局来更高效地实现该目的。 有关自定义布局的详细信息,请参阅个性化报表布局。
有关嵌入 Power BI 报表视觉对象的完整说明,请参阅嵌入报表视觉对象。
嵌入分页报表
可以使用类型为 IEmbedConfigurationBase
的配置对象嵌入分页报表。 除了必需属性(如第 1 单元所述),type
属性设置为“report”,还必须设置以下属性。
-
id
- 必需。 包含分页报表的工作区 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
- 必需。 仪表板磁贴的 ID。 可以使用 Power BI REST API 获取仪表板磁贴及其属性。
有关嵌入仪表板磁贴的完整说明,请参阅嵌入仪表板磁贴。
嵌入问答体验
可以使用类型为 ILoadQnaConfiguration
的配置对象嵌入问答体验。 除了必需属性(如第 1 单元所述;type
属性设置为“qna”),还应该设置以下属性。
-
datasetIds
- 必需。 DatasetID 数组。 但是,目前仅支持一个 DatasetID。 -
viewMode
- 可选项。 可以是QnaMode.Interactive
(允许用户输入问题)或QnaMode.ResultOnly
(需要提供的问题)。 -
question
- 可选项。 应用提供的问题。viewMode
属性必须设置为QnaMode.ResultOnly
。
提示
鼓励使用问答功能,有助于减少需要开发的报表和仪表板的数量。 此外,可以从 Power BI 报表嵌入问答视觉对象。 此方法提供设置视觉对象格式的功能,并且应用可以向其应用筛选器。
有关嵌入问答体验的完整说明,请参阅嵌入独立的问答视觉对象。