嵌入其他 Power BI 内容类型

  • 5 分钟

可以嵌入其他类型的 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 报表嵌入问答视觉对象。 此方法提供设置视觉对象格式的功能，并且应用可以向其应用筛选器。

有关嵌入问答体验的完整说明，请参阅嵌入独立的问答视觉对象。