准备要嵌入的 Power BI 内容

已完成

可以使用 Power BI Desktop 和 Power BI 服务以常规方式创建和管理 Power BI 内容。 无需专门创建用于嵌入的内容。 但在准备嵌入时,可以实现更直观的最佳结果。

准备工作区

Power BI 工作区是 Power BI 服务中的逻辑容器,用于存储语义模型和报表等相关项。 它还形成安全边界。

在应用中创建嵌入内容时,最好将其与和应用无关的其他内容分开存储。 可以将其存储在一个或多个工作区中。 当存在多个项,尤其是当不同的团队共同处理内容时,请考虑使用多个工作区。 例如使用一个工作区存储财务报表,而另一个工作区可以存储生产制造报表。 当应用支持创建新报表时,也请考虑为这些报表创建工作区。

用于嵌入工作区内容的嵌入标识必须具有特定权限。

注意

若要了解内部和外部用户的工作区权限,请完成设置嵌入 Power BI 内容的权限模块。

设计多租户解决方案时,可以通过为每个租户创建一个工作区来实现租户分离。 此设计模式被称为“工作区分离”。

注意

若要了解工作区分离,请完成将 Power BI 解决方案管理自动化模块。

每个 Power BI 工作区都按自己的 GroupID 得到唯一标识。 通常,应用配置文件包括对工作区 GroupID 的硬编码引用。 Power BI REST API 的操作用于枚举工作区项,以检索用于嵌入的特定属性。

准备语义模型

Power BI 语义模型是表示数据源的项。 它通常表示包含表、列、层次结构、关系和度量值的数据模型。 Power BI 报表和其他项连接到语义模型。

当应用必须限制特定用户的数据访问时,语义模型可以实现行级安全性 (RLS)。 例如,在嵌入式报表中,销售代表应用的用户只能查看自己分配到的客户。 但是,查看相同报表的销售经理应用的用户可以查看所有客户。

注意

若要了解如何通过 RLS 限制数据访问,请完成为 Power BI 嵌入式分析强制实施数据权限模块。

如果应用嵌入问答体验,最好针对问答优化数据集。 此过程可能涉及:

  • 设置列分类或排序顺序。
  • 定义同义词或常见短语。
  • 添加推荐问题。

有关详细信息,请参阅优化 Power BI 中的问答的最佳做法

每个 Power BI 语义模型都按自己的 DatasetID 得到唯一标识。 强制实施数据访问权限或嵌入问答时,需要使用 DatasetID。 Power BI REST API 具有用于查找 DatasetID 值的操作。

准备 Power BI 报表

Power BI 报表页大小是固定的。 因此,在创建报表时,请务必将页面大小设置为适合应用的尺寸。 应用会将内容嵌入 div 元素中,因此请确保报表页纵横比(宽度与高度比)与 div 元素大小匹配。 在匹配的情况下,嵌入的报表周围就不会有空白。

为了让结果在视觉上有吸引力,请妥善设置报表格式以补充或增强嵌入应用。 请考虑设置背景色、字体属性和其他属性。

提示

若要了解设计和交付优秀的 Power BI 报表的过程,请参阅在 Power BI 中设计有效报表学习路径。

请考虑添加可增强应用体验的报表元素:

  • 应用能以编程方式设置切片器和筛选器。
  • 选择按钮,可以触发与应用交互的客户端代码。
  • 应用可以应用书签,用于捕获特定报表状态。

如果 Power BI 报表设置了移动视图,则可以在该视图中嵌入报表。

每个 Power BI 报表都按自己的 ReportID 得到唯一标识。 嵌入报表时需要使用 ReportID。 Power BI REST API 具有用于查找 ReportID 值的操作。

准备 Power BI 视觉对象

嵌入以 Power BI 报表为数据源的单个视觉对象时,请确保视觉对象维度与 div 元素的大小匹配。 在匹配的情况下,嵌入的视觉对象周围就不会有空白。

每个 Power BI 报表都按 ReportID 和视觉对象名称得到唯一标识。 嵌入视觉对象时,需要使用 ReportID 和视觉对象名称。 Power BI REST API 具有用于查找 ReportID 值的操作。 使用客户端 API 查找视觉对象名称。

准备分页报表

遵循为 Power BI 报表提供的准备指南。 具体而言,请遵循与页面大小和设计具有视觉吸引力的结果相关的指南。

每个分页报表都按自己的 ReportID 得到唯一标识。 嵌入分页报表需要 ReportID。 Power BI REST API 具有用于查找 ReportID 值的操作。

准备仪表板

使用 Power BI 仪表板,可仅在单个窗格中完成多个磁贴的布局。 页面和仪表板大小属性不可用。 嵌入仪表板时,可以缩放仪表板以适应 div元素(即“适应宽度”),也可以将仪表板呈现为一套垂直排列的磁贴(即单列排布)。

如果仪表板设置了移动视图,则可以在该视图中嵌入仪表板。

每个仪表板都按自己的 DashboardID 得到唯一标识。 嵌入仪表板时,需要使用 DashboardID。 Power BI REST API 具有用于查找 DashboardID 值的操作。

准备问答

如数据集文章中所述,要准备要嵌入问答,涉及针对问答优化数据集。

请考虑应用预设问题。 这样,问答会显示对问题的视觉响应。 你的应用可能能够根据用户的应用交互自动生成问题。 因此,通过问答可以实现动态驱动分析。

提示

可以从 Power BI 报表嵌入问答视觉对象。 此方法提供设置视觉对象格式的功能。 此外,作为报表视觉对象,应用可以将筛选器应用于视觉对象。

Q&A 体验的嵌入依托于单个语义模型。