模板应用创作提示:Power BI

在 Power BI 中创建模板应用需要注意工作区物流和测试之外的多个组件。 本文提供了创作查询、数据模型、报表和仪表板的提示,可帮助你构建提供出色用户体验的有效模板应用。

  • 查询。 使用查询,可以 连接转换 数据,并定义 参数
  • 数据模型。 在数据模型中,可以创建 关系度量值和 Q&A 改进。
  • 报表页报表页 包括可视化和筛选器,以提供数据洞察。
  • 仪表板磁贴仪表板磁贴 概述了包含的见解。
  • 示例数据。 样本使应用程序在安装后立即被发现。

你可能已经熟悉每个功能,因为它们是现有的 Power BI 功能。 构建模板应用时,需要考虑每个部分的其他事项。 本文介绍这些注意事项,以及与创作模板应用相关的其他有用信息。

Queries

对于模板应用,Power BI Desktop 中开发的查询用于连接到数据源并导入数据。 这些查询必须返回一致的架构,并支持计划的数据刷新。

连接到 API

若要开始,需要从 Power BI Desktop 连接到 API,开始生成查询。

可以使用 Power BI Desktop 中提供的数据连接器连接到 API。 可以使用 Web 数据连接器(获取数据>Web)连接到 Rest API 或 OData 连接器(获取数据>OData 源),以连接到 OData 源。

注释

目前,模板应用不支持自定义连接器。 建议使用 Odatafeed Auth 2.0 作为一些连接用例的缓解措施,或提交连接器进行认证。 有关如何开发连接器并对其进行认证的详细信息,请参阅 数据连接器

考虑来源

查询定义数据模型中包含的数据。 根据系统的大小,这些查询还应包括筛选器,以确保客户处理符合相关业务方案的可管理大小。

Power BI 模板应用可以并行运行多个查询,同时为多个用户运行。 规划限制和并发策略,并询问我们如何使模板应用容错。

架构实施

确保查询对系统中的更改具有弹性。 在刷新期间,架构中的更改可能会中断模型。 如果源可能返回某些查询的 null 或缺少架构结果,请考虑返回空表或有意义的自定义错误消息。

参数

Power BI Desktop 中的参数允许用户提供用于自定义用户检索的数据的输入值。 请事先考虑参数,以避免在投入时间创建详细的查询或报表后需要返工。

注释

模板应用支持除AnyBinary之外的所有参数。

其他查询提示

  • 确保正确键入所有列。
  • 为列赋予有意义的名称。 有关详细信息,请参阅 Q&A
  • 对于共享逻辑,请考虑使用函数或查询。
  • Power BI 服务当前不支持隐私级别。 如果收到有关隐私级别的提示,可能需要重写查询以使用相对路径。

数据模型

定义完善的数据模型可确保客户能够轻松直观地与模板应用交互。 在 Power BI Desktop 中创建数据模型。

注释

应在查询中进行许多基本建模操作,如键入和命名列。

问答

建模还会影响 Q&A 为客户提供结果的方式。 请务必将同义词添加到常用列,并在 查询中正确命名列。

其他数据模型提示

确保您已完成以下事项:

  • 应用于所有值列的格式。 在查询中应用类型。
  • 对所有度量值应用格式。
  • 设置默认摘要。 具体而言,设置 “无计算 ”(例如,对于唯一值)。
  • 设置数据类别(如果适用)。
  • 根据需要设置关系。

报表

报表页提供对模板应用中包含的数据的额外见解。 使用报表的页面来回答模板应用尝试解决的关键业务问题。 使用 Power BI Desktop 创建报表。

其他报告提示

  • 为每个页面使用多个视觉对象进行交叉筛选。
  • 确保视觉元素对齐,不重叠。
  • 确保页面布局设置为 4:3 或 16:9 模式。
  • 确保呈现的所有聚合都具有数值意义,例如平均值或唯一值。
  • 检查切片是否产生合理的结果。
  • 在至少一个顶部报表上包含您的徽标。
  • 确保元素尽可能在客户端的配色方案中。

注释

单个模板应用不能包含 20 多个报表。

Dashboards

仪表板是与客户模板应用交互的主要点。 它应包含内容的概述,尤其是业务方案的重要指标。

若要为模板应用创建仪表板,只需通过获取数据文件>上传 PBIX,或直接从 Power BI Desktop 发布。

其他仪表板提示

  • 固定时保持相同的主题,以便仪表板上的磁贴保持一致。
  • 将徽标固定到主题,以便使用者知道包的所在位置。
  • 建议的布局适用于大多数屏幕分辨率的宽度为 5 到 6 个小磁贴。
  • 所有仪表板磁贴都应具有适当的标题和副标题。
  • 请考虑在仪表板中针对不同方案进行分组,无论是垂直还是水平。

示例数据

模板应用作为应用创建阶段的一部分,将缓存数据包装在工作区中,该应用具有以下优势:

  • 允许安装程序在连接数据之前了解应用的功能和用途。
  • 创建一种体验,该体验驱动安装程序进一步探索应用功能,这会导致连接应用语义模型。

建议在创建应用之前提供质量示例数据,以确保应用的报告和仪表板填充了数据。 尝试将示例数据的大小保持到尽可能的小。

在 AppSource 上发布

模板应用可以在 AppSource 上发布。 在将应用提交到 AppSource 之前,请遵循以下准则:

  • 确保创建一个包含吸引人示例数据的模板应用,以帮助用户了解该应用可以执行的功能。 空报表和仪表板不会获得批准。
  • 模板应用程序支持仅包含示例数据的应用程序。
  • 请给予验证团队可供他们使用的指令,其中包括连接到数据所需的凭据和参数。
  • 应用程序必须在 Power BI 和云合作伙伴门户(CPP)产品/服务中包含 应用徽标
  • 配置 登陆页
  • 请务必遵循有关 Power BI 应用产品/服务的文档。
  • 如果仪表板是应用的一部分,请确保该仪表板不为空。
  • 在提交应用之前,使用应用链接安装应用。 确保可以连接语义模型,并且应用体验按计划进行。
  • 将 PBIX 文件上传到模板工作区之前,请确保卸载任何不必要的连接。
  • 遵循 报表和视觉对象的 Power BI 最佳设计做法 ,以对用户产生最大影响,并获得批准分发。

在 AppSource 上发布模板应用后,请考虑从您的网站创建下载链接,以便用户选择以下任一选项:

  • AppSource 下载页,公开访问。 从 AppSource 页面获取链接。
  • Power BI,可由 Power BI 用户查看。

若要将用户重定向到 Power BI 中的应用下载链接,请参阅以下代码示例: GitHub 存储库

GitHub 存储库的屏幕截图,其中显示了模板应用示例下载页,其中包含使用说明。

在安装过程中自动执行参数配置

如果你是通过 Web 服务分发模板应用的 ISV,可以在客户在其 Power BI 帐户中安装应用时自动创建配置模板应用参数的自动化。 这种方法让客户的使用更简单。 它还增加了成功安装的可能性,因为它们不必提供他们可能不知道的详细信息。 有关详细信息,请参阅 模板应用安装的自动配置